A raw PHP based template with sections, block, and layout, but no escaping functions.
To escape values displayed in a template, use other packages, such as Tuum/Form.
MIT Licence
PSR-1, PSR-2, and PSR-4.
composer require "tuum/view: ^1.0"Constructing the renderer:
$view = new Tuum\View\Renderer(
new Tuum\View\Locator('/path/to/view/')
); // or alternatively,
$view = Tuum\View\Renderer::forge('/path/to/view');To render a PHP template file,
$view->render('my/file-name', [
'some' => 'data'
]);The template file at /path/to/view/my/file-name.php may be:
<html>
Some=<?= $some; ?>
</html>The Tuum/View does not escape the value. Please use helpers to escape before displaying the values.
You can set a default layout in the renderer:
$viewer = $viewer->setLayout('layout/layout1');
$viewer->render('file-name', [
'some' => 'data'
]);or set layout inside individual template file (hence overwrites the default layout):
<?php
$this->setLayout('layout/layout1');
?>
set layout inside this view.In a layout file, emit content (from the initial template file) using $this->getContent() method.
This is layout#1.
<?= $this->section-getContent(); ?>
End of layout#1.In a template file, define a section using $this->section->start()
and $this->section->saveAs('block'),
<?php $this-> section->start(); ?>
this is a block.
<?php $this->section->saveAs('block'); ?>
this is a content.In a layout file, use the defined section as:
Block:
<?= $this->section->get('block'); ?>
Content:
<?= $this->getContent(); ?>
Done:You can check if a section is defined:
<?php if ($this->section->exists('content')): ?>
<?= $this->getContent(); ?>
<?php else: ?>
Welcome Section Test
<?php endif; ?>Using replaceBySection in layout file may make it clearer...
<?php $this->section->start(); ?>
Welcome Section Test
<?php $this->section->replaceBy('content'); ?>replacedBy method will take the output from a section (from start() till replacedBy() method) and checks if the named section exists or not. If the section exists, it outputs the existing section, or outputs the section in the layout.
In the template file, it is possible to set a section not to be displayed at all by using markNotToRender method.
In template file:
<?php $this->section->markNotToRender('bread'); ?>In layout file:
<?php $this->section->start(); ?>
<ol>
<li>bread-top</li>
<?= $this->getSection('bread'); ?>
</ol>
<?php $this->section->renderAs('bread'); ?>Because the bread section is marked as NotToRender, the entire bread section will not be rendered.
This also works for replaceBySection as well. So, for the example for replaceBySection('content') will not be displayed at all if marked as NoDisplay.
To include another template, use block method in a template file as:
<?= $this->block('block-sub', ['some' =>'value']); ?>The block-sub is another template file. The template's data is shared with the block template.
Some times, one might want to use a block as a section (well, I do). So, here's an easy way to do.
<?php $this->blockAsSection('block-file', 'section-name', ['another' => 'one']); ?>