Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Des templates sans framework : League/Plates

DĂšs qu’un script doit produire du HTML plutĂŽt qu’un bloc JSON ou une ligne de log, les echo mĂ©langĂ©s Ă  la logique deviennent illisibles Ă  toute vitesse. Plates est un moteur de templates Ă©crit en PHP pur : aucune syntaxe nouvelle, seulement des fichiers PHP avec des layouts, des sections et un Ă©chappement automatique, utilisables depuis n’importe quel script.

composer require league/plates
<?php
require 'vendor/autoload.php';

use League\Plates\Engine;

$templates = new Engine(__DIR__ . '/templates');

echo $templates->render('profile', ['name' => 'Ada']);
<?php // templates/layout.php ?>
<!doctype html>
<html>
<head><title><?= $this->e($title ?? 'My Site') ?></title></head>
<body>
    <?= $this->section('content') ?>
</body>
</html>
<?php // templates/profile.php ?>
<?php $this->layout('layout', ['title' => 'Profile']) ?>

<?php $this->start('content') ?>
    <h1>Hello, <?= $this->e($name) ?></h1>
<?php $this->stop() ?>

$this->e() Ă©chappe la sortie. C’est la mĂȘme protection que vous offrent Twig ou Blade, Ă©crite en toutes lettres au lieu d’ĂȘtre cachĂ©e derriĂšre une autre syntaxe.

Quand le choisir

Un petit outil interne, un gĂ©nĂ©rateur de rapports, ou un script qui rend une poignĂ©e de pages HTML et ne justifie pas toute la couche de templates d’un framework.

Quand ce n’est pas le bon outil

DĂšs qu’un projet accumule des composants, des inclusions et plus d’une poignĂ©e de pages. Le moteur du framework (Blade chez Laravel, Twig chez Symfony) gagne alors sa place avec la rĂ©utilisation de composants et la compilation des assets, des fonctionnalitĂ©s que Plates laisse volontairement de cĂŽtĂ© pour rester petit.

Sous le capot : les templates Plates sont des fichiers PHP, donc pas d’étape de compilation ni de cache de templates Ă  comprendre. Cette simplicitĂ© est toute la raison d’ĂȘtre de la bibliothĂšque, et c’est prĂ©cisĂ©ment ce que le moteur de templates d’un framework abandonne en Ă©change de fonctionnalitĂ©s supplĂ©mentaires.