corex/template

This package is abandoned and no longer maintained. No replacement package was suggested.

Simple template system

2.1.0 2019-07-11 08:11 UTC

Requires

• php: ^7.2
• corex/helpers: ^2.0
• mustache/mustache: ^2.12

Requires (Dev)

• phpunit/phpunit: ^7.5

MIT

• CoRex

README

The goal for this package is simplicity. It is based on Mustache but has a very simple approach. If you need more than this "simplicity", Mustache is recommended.

Every call to load() and render() will use base paths.

Mustache is default set to escape variables. This has been disabled on this package. It is however possible to escape by calling escape() on template if you need to escape values i.e. html-tags.

Note: when printing layout/view (__toString) and exception is thrown, it will be caught and send through error_log().

// Set base path (can be called more than once). Paths will be searched in reverse order.
Template::basePath('/path/to/templates');
Template::basePath('/path/to/other/templates');

// Load template.
$template = Template::load('test');

// Set escape on variables (default un-escaped).
$template->escape();

// Set path for templates.
$template->path('/path/to/some/other/templates');

// Set variable on template.
$template->variable('myVar', 'myValue');
$template->var('myVar2', 'myValue2');

// Set variables.
$template->variables([
    'myVar1' => 'myValue1',
    'myVar2' => 'myValue2'
]);
$template->vars([
    'myVar3' => 'myValue3',
    'myVar4' => 'myValue4'
]);

// Render template.
$content = $template->render();

// Example of loading template, set var and render.
$content = Template::load('base')
    ->variable('myVar', 'myValue')
    ->var('myVar2', 'myValue2')
    ->render();

// Render template directly.
$content = Template::render('base', [
    'myVar1' => 'myValue1',
    'myVar2' => 'myValue2'
]);

// Parse template and render values.
$content = Template::parse('({{myVar}})', ['myVar' => 'myValue']);

// Get Mustache engine.
$mustacheEngine = Template::mustacheEngine();

For further reading on Mustache, look at https://github.com/bobthecow/mustache.php/wiki