vakata/views

A simple PHP templating engine

views

![Software License][ico-license] ![Tests Coverage][ico-cc-coverage], _(*1)

A simple PHP templating engine., _(*2)

Install

Via Composer, _(*3)

``` bash $ composer require vakata/views, <sub>(*4)</sub>

## Usage

``` php
use vakata\views\Views;

$views = new vakata\views\Views();

// register template dirs
$views->dir('/path/to/templatedir');
$views->dir('/path/to/otherdir', 'other');

// a variable available in all templates
$views->share("siteTitle", "test");

// variables available in all templates
$views->share(["a" => 1, "b" => 2]);

// render a template from the first dir:
$views->render('profile', ['user' => 'Test']);

// render a template from a named dir:
$views->render('other::user', ['user' => 'Test']);

// the above is the same as
$v = $views->get('other::user');
$v->render(['user'=>'Test']);

A sample template may look like this:, <sub>(*5)</sub>

layout('master.layout', ['masterParam' => 'master-value']); ?>

Content

sectionStart("sidebar"); ?>
Here is some unfiltered content: = $b ?> 
Here is some filtered content: = $this->e($user) ?> 
sectionStop(); ?>

Here is some filtered and transformed content:
= $this->e($user, 'trim|strtouuper') ?> 

Include a child template:
= $this->insert('nameddir::include', ['optional' => 'params']); ?>

As for the master template (which can in turn have its own master template):, <sub>(*6)</sub>

I am master!

= $this->section("sidebar") ?>

= $masterParam ?> = $a ?>

The unnamed part of the above template:
= $this->section() ?>

Read more in the API docs, <sub>(*7)</sub>

Testing

bash $ composer test, <sub>(*8)</sub>

Contributing

Please see CONTRIBUTING for details., <sub>(*9)</sub>

Security

If you discover any security related issues, please email github@vakata.com instead of using the issue tracker., <sub>(*10)</sub>

Credits

• vakata
• All Contributors

License

The MIT License (MIT). Please see License File for more information., <sub>(*11)</sub>