jwread/lib-allure

A set of utilities, helpers and shims. It aims to be pretty modular and lightweight.

libAllure

A set of utilities, helpers and shims. It aims to be pretty modular and lightweight., _(*1)

packagist.org Package for compose | API Documentation, _(*2)

, _(*3)

Compatibiility

Adding with composer

You can add libAllure to your project quickly, if you're using composer., _(*4)

composer require jwread/lib-allure

Then to use it, like in test.php;, _(*5)

Adding with a standard PHP include

Copy the contents of /src/main/php/ to somewhere on your include path, like /usr/share/php/ on most Linux distributions. So that you have /usr/share/php/libAllure/ErrorHander.php, /usr/share/php/libAllure/Database.php, etc., _(*6)

API Examples & Quick Reference

Full API Documentation: http://jamesread.github.io/libAllure/, _(*7)

Database

Wrapper around PDO., _(*8)

use \libAllure\Database;

$database = new Database('mysql:dbname=testdb;host=127.0.0.1', 'username', 'password');

$sql = 'SELECT p.id, p.title FROM products p';
$results = $database->prepare($sql)->execute();

var_dump($results->fetchAll());

ErrorHandler

Custom error handler that complains at the slightest thing, makes debugging nice and easy., _(*9)

use \libAllure\ErrorHandler;

$handler = new ErrorHandler();
$handler->beGreedy();

throw new Exception('This is a test');

Form

Custom form handling code., _(*10)

use \libAllure\ElementInput;
use \libAllure\Template;

$tpl = new Template('myTemplates'); // requires form.tpl and formElements.tpl in your templates folder

class MyForm extends \libAllure\Form {
    public function __construct() {
        $this->addElement(new ElementInput('forename', 'Forename', 'My Default Name');
        $this->addDefaultButtons():
    }

    public function process() {
        // do something
    }
}

$f = new MyForm();

if ($f->validate()) {
    $f->process();
}

$tpl->displayForm($f);

Template

Just a nice wrapper around Smarty2/3, that adds in a few compatibility functions to easily switch between the versions., _(*11)

use \libAllure\Template;

$tpl = new Template('myTemplates');
$tpl->display('myTemplate.tpl');