taviroquai/mask

A PHP trait as a basic template engine

mask

Mask is a PHP trait that functions as a basic PHP template engine, _(*1)

Tutorial

create a simple view to hold ALL view logic, _(*2)

class MyView
{
    protected $title = 'Hello';
    protected function logic()
    {
        return 'World!';
    }
}

add mask, _(*3)

use Taviroquai\Mask\Mask;

class MyView
{
    use Mask;

    protected $title = 'Hello';
    protected function logic()
    {
        return 'World!';
    }
}

now create an HTML file: template.html, _(*4)

<p>
{{ title }}
{{ if logic }}{{ logic }}{{ endif }}
</p>

finally use it in PHP as, _(*5)

$view = new MyView;
echo $view->mask('template');

output:, _(*6)

<p>
Hello
World!
</p>

API

Call variables and methods

{{ variableName }} {{ methodName }}, _(*7)

Conditions

{{ if methodOrVariableName }} ... something ... {{ endif }}, _(*8)

Foreach loops

{{ for variable as local }}
{{ local }}
{{ endfor }}, _(*9)

Includes

include partial.html
{{ include partial }}, _(*10)

Options

// Set cache path
Mask::$templateCachePath = './path/to/cache';

// Set templates path
Mask::$templatePath = './path/to/templates';

// Choose what properties to publish by overriding getMaskData()
class MyView
{
    use Mask;

    protected $property1;
    protected $property2;

    public function getMaskData()
    {
        return array(
            'property2' => 'override'
        );
    }
}