tflori/syna
PHP library for rendering native php templates with sections, inheritance and helpers.
This library is inspired by aura/view and league/plates. Both have advantages against each other and both are lacking some major features.
Að sýna means to show in Icelandic.
Helpers
Both libraries are missing a functionality to not register each helper. Syna has the ability to register namespaces
where your helpers are placed. Adding the namespace App\ViewHelper
would load App\ViewHelper\Date
for
$view->date()
.
Layouts
Syna also provides the ability to use layouts as described by the TwoStepView pattern. Other then extending views from inside a view (suggested by other libraries like league/plates, illuminate/blade etc.) you should define the layout in your controller. The separation of concerns between extending views and wrapping a html snipped into another one is logic that should not be decided from views (e. g. loading the content of a modal dialog or loading a full page with navigation, header and footer).
Named Locators
Extending Views
Installation
Like all my libraries: only with composer
$ composer require tflori/syna
Basic usage
<?php
use Syna\Factory;
use Syna\HelperLocator;
use Syna\ViewLocator;
$viewLocator = new ViewLocator(__DIR__ . '/resources/views');
$layoutLocator = new ViewLocator(__DIR__ . '/resources/layouts');
$helperLocator = new HelperLocator();
$templates = new Factory($viewLocator, $helperLocator, $layoutLocator);
echo $templates->render('pages/home', [], 'fullPage');
layouts/fullPage.phtml
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Example</title>
</head>
<body>
<?= $v->fetch('partials/navbar') ?>
<div id="content">
<?= $v->section('content') ?>
</div>
</body>
</html>
views/pages/home
<?php $v->extends('pageWithTeaser'); ?>
<?php $v->start('teaser') ?>
<img src="teaser.jpg" />
<div class="teaser-content">
<h2>Title for teaser</h2>
<p>Lorem ipsum dolor sit amet...</p>
</div>
<?php $v->end(); ?>
<div class="card">Lorem ipsum dolor sit amet...</div>
<div class="card">Lorem ipsum dolor sit amet...</div>
<p>what ever...</p>
views/pageWithTeaser
<div class="teaser">
<?= $v->section('teaser') ?>
</div>
<?= $v->section('content') ?>
Please also have a look at the example for a more concrete example and at the tests for the documented examples.