Latte
Latte est un moteur de templates complet qui est très facile à utiliser et se rapproche plus d'une syntaxe PHP que Twig ou Smarty. Il est également très facile à étendre et à ajouter vos propres filtres et fonctions.
Installation
Installez avec composer.
composer require latte/latte
Configuration de base
Il existe quelques options de configuration de base pour démarrer. Vous pouvez en savoir plus à leur sujet dans la Documentation de Latte.
use Latte\Engine as LatteEngine;
require 'vendor/autoload.php';
$app = Flight::app();
$app->register('latte', LatteEngine::class, [], function(LatteEngine $latte) use ($app) {
// C'est ici que Latte mettra en cache vos templates pour accélérer les choses
// Une chose intéressante à propos de Latte est qu'il rafraîchira automatiquement votre
// cache lorsque vous apportez des modifications à vos templates !
$latte->setTempDirectory(__DIR__ . '/../cache/');
// Indiquez à Latte où se trouvera le répertoire racine pour vos vues.
// $app->get('flight.views.path') est défini dans le fichier config.php
// Vous pourriez également simplement faire quelque chose comme `__DIR__ . '/../views/'`
$latte->setLoader(new \Latte\Loaders\FileLoader($app->get('flight.views.path')));
});
Exemple de mise en page simple
Voici un exemple simple d'un fichier de mise en page. C'est le fichier qui sera utilisé pour envelopper toutes vos autres vues.
<!-- app/views/layout.latte -->
<!doctype html>
<html lang="en">
<head>
<title>{$title ? $title . ' - '}Mon application</title>
<link rel="stylesheet" href="style.css">
</head>
<body>
<header>
<nav>
<!-- vos éléments de navigation ici -->
</nav>
</header>
<div id="content">
<!-- C'est là que se trouve la magie -->
{block content}{/block}
</div>
<div id="footer">
© Droits d'auteur
</div>
</body>
</html>
Et maintenant nous avons votre fichier qui va être rendu à l'intérieur de ce bloc de contenu :
<!-- app/views/home.latte -->
<!-- Ceci indique à Latte que ce fichier est "à l'intérieur" du fichier layout.latte -->
{extends layout.latte}
<!-- C'est le contenu qui sera rendu à l'intérieur du layout à l'intérieur du block de contenu -->
{block content}
<h1>Page d'accueil</h1>
<p>Bienvenue dans mon application !</p>
{/block}
Ensuite, lorsque vous allez rendre ceci à l'intérieur de votre fonction ou contrôleur, vous feriez quelque chose comme ceci :
// itinéraire simple
Flight::route('/', function () {
Flight::latte()->render('home.latte', [
'title' => 'Page d'accueil'
]);
});
// ou si vous utilisez un contrôleur
Flight::route('/', [HomeController::class, 'index']);
// HomeController.php
class HomeController
{
public function index()
{
Flight::latte()->render('home.latte', [
'title' => 'Page d'accueil'
]);
}
}
Consultez la Documentation de Latte pour plus d'informations sur comment utiliser Latte à son plein potentiel!