phower/view

Standalone templating system for PHP scripts.

Phower View

Standalone templating system for PHP scripts., _(*1)

Requirements

Phower View requires:, _(*2)

• PHP 5.6 or above; version 7.0 is recommended

Instalation

Add Phower View to any PHP project using Composer:, _(*3)

composer require phower/view

Usage

This package provides the essential tools for an application to output any kind of output response supported by an optional list of variables which are rendered inside templates., _(*4)

Templates are plain PHP scripts which are rendered on a protected environment with all variables already available:, _(*5)

<h1>Hello <?= $name ?>!</h1>

Assuming the template above is a file called my_template.php then we can use it to output a new set of variables:, _(*6)

use Phower\View\TemplateView;

$view = new TemplateView();
$view->setTemplate('my_template.php');
$view->setVariables(['name'] => 'Pedro');

$view->render(); // outputs: 

Hello Pedro!

Templates inside templates

Many times we find useful to implement more than one layer of templating with high level ones outputing other templates., _(*7)

This can be achived by capturing the child template into a variable of the parent template:, _(*8)

use Phower\View\TemplateView;

$child = new TemplateView();
$child->setTemplate('child_template.php');

$parent = new TemplateView();
$parent->setTemplate('parent_template.php');
$parent->capture('child', $child);

$parent->render();

JSON views

Other times we may wish to output a set of variables not using a template but just as a JSON plain representation:, _(*9)

use Phower\View\JsonView;

$view = new JsonView();
$view->setVariables(['name'] => 'Pedro');

$view->render(); // outputs: {"name":"Pedro"}

Note that JsonTemplate is fully compatible with PHP json_encode so that we can also set options and depth and use all the accepted values there on each instance of JsonTemplate., _(*10)

Running Tests

Tests are available in a separated namespace and can run with PHPUnit in the command line:, _(*11)

vendor/bin/phpunit

Coding Standards

Phower code is written under PSR-2 coding style standard. To enforce that CodeSniffer tools are also provided and can run as:, _(*12)

vendor/bin/phpcs

Reporting Issues

In case you find issues with this code please open a ticket in Github Issues at https://github.com/phower/view/issues., _(*13)

Contributors

Open Source is made of contribuition. If you want to contribute to Phower please follow these steps:, _(*14)

1. Fork latest version into your own repository.
2. Write your changes or additions and commit them.
3. Follow PSR-2 coding style standard.
4. Make sure you have unit tests with full coverage to your changes.
5. Go to Github Pull Requests at https://github.com/phower/view/pulls and create a new request.

Thank you!, _(*15)

Changes and Versioning

All relevant changes on this code are logged in a separated log file., _(*16)

Version numbers follow recommendations from Semantic Versioning., _(*17)

License

Phower code is maintained under The MIT License., _(*18)