Шаблонизаторы PHP: от нативных шаблонов до Twig и Mustache
Шаблонизатор превращает подготовленные данные в HTML. Для небольшого проекта может хватить нативного PHP, в Symfony обычно выбирают Twig, а в Laravel — Blade. Если один шаблон должен работать на сервере и в браузере, пригодится Mustache.
Что делает шаблонизатор в PHP
Контроллер получает данные для страницы, модель представления приводит их к удобному для вывода виду, а шаблон формирует HTML. Например, для каталога товары приходят из репозитория, правила доступности применяются в приложении, а шаблон выводит названия, цены и кнопки. Если список пуст, шаблон показывает предусмотренное состояние страницы.
Условия, циклы и подключение фрагментов в шаблоне уместны, когда управляют разметкой. Проверку прав, расчёт скидки и запросы к базе выполняйте до рендеринга. Если одна и та же проверка нужна для кнопки и обработчика действия, правило принадлежит приложению. Скрытая кнопка сама по себе доступ к действию не ограничивает.
Как выбрать шаблонизатор
| Вариант | Когда подходит | Что учесть |
|---|---|---|
| Нативный PHP | Небольшой проект или несколько простых серверных страниц | Экранирование, раскладки и правила подключения файлов задаёт проект |
| Twig | Symfony или самостоятельное PHP-приложение с общими раскладками и переиспользуемыми блоками | Настройте автоэкранирование и кеш компиляции |
| Blade | Laravel, особенно если проект использует компоненты и слоты Blade | Обычный вывод экранируется, для сырого HTML предусмотрен отдельный синтаксис |
| Mustache | Одинаковый шаблон нужен в PHP и JavaScript | Условия, подписи и состояние элементов заранее выражаются в данных |
| Smarty | Проект уже использует шаблоны, модификаторы и плагины Smarty | Перед обновлением проверьте совместимость установленной ветки с целевой версией PHP и настройки экранирования |
Для PHP 8.3–8.5 проверяйте совместимость всего набора зависимостей через Composer, включая расширения шаблонизатора и адаптеры фреймворка. Если приложение заявляет поддержку всех трёх веток PHP, запускайте тесты на каждой. Менять движок в действующем проекте стоит под конкретную задачу, например для перехода на общие компоненты или совместного рендеринга в PHP и JavaScript.
Подготовьте данные для шаблона
Передавайте в шаблон только поля, которые нужны странице. Небольшой функции достаточно для простого преобразования. Типизированный DTO удобен, когда один и тот же контракт используют несколько шаблонов. В обоих случаях можно отдельно проверить форматирование и правила отображения.
<?php
declare(strict_types=1);
/** @return array{title: string, stockLabel: string, showBuy: bool} */
function productView(string $title, int $stock, bool $canOrder): array
{
$inStock = $stock > 0;
// Право на заказ определяет приложение и передаёт готовым флагом.
return [
'title' => $title,
'stockLabel' => $inStock ? 'В наличии' : 'Нет в наличии',
'showBuy' => $inStock && $canOrder,
];
}
$view = productView('Кофе & молоко', 3, true);Строгие типы помогают контролировать вызовы PHP-функций. Данные из HTTP-запроса или JSON нужно отдельно проверить на входе, а структуру массива можно проверять статическим анализатором по аннотации. Для цены, даты и подписи к статусу определите правила форматирования до рендеринга. При смене языка собирайте модель представления заново для нужной локали.
Нативный PHP и Twig на одних данных
Нативный PHP
В файле product.php используйте короткий вывод <?= и единый помощник для экранирования. Файл подключайте по пути, который определяет приложение. При выборе шаблона по параметру запроса сопоставляйте его с разрешённым именем через явную карту.
<?php
declare(strict_types=1);
// В контроллере после подготовки $view.
$escape = static fn (string $value): string => htmlspecialchars(
$value, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8'
);
require __DIR__ . '/product.php';<!-- product.php -->
<h1><?= $escape($view['title']) ?></h1>
<p><?= $escape($view['stockLabel']) ?></p>
<?php if ($view['showBuy']): ?>
<button type="button">Купить</button>
<?php endif; ?>Twig
В самостоятельном проекте установите пакет twig/twig через Composer. Если $view уже сформирован, тот же набор полей можно передать непосредственно в render().
<?php
declare(strict_types=1);
require __DIR__ . '/vendor/autoload.php';
// Каталог содержит файл product.html.twig.
$loader = new \Twig\Loader\FilesystemLoader(__DIR__ . '/templates');
$twig = new \Twig\Environment($loader, [
'autoescape' => 'html',
'strict_variables' => true,
]);
echo $twig->render('product.html.twig', $view);В product.html.twig заголовок выводится как {{ title }}, а кнопка помещается между {% if showBuy %} и {% endif %}. Режим strict_variables помогает обнаружить опечатки и пропущенные поля. При его включении в существующем приложении проверьте шаблоны с необязательными данными и явно задайте значения для таких полей.
Mustache для PHP и JavaScript
Mustache пригодится, если сервер отдаёт готовую карточку при первом запросе, а браузер перерисовывает её после смены фильтра. Обе стороны получают одинаковый набор полей и используют один файл шаблона. Для вывода названия достаточно {{title}}. Секция между {{#showBuy}} и {{/showBuy}} показывает кнопку при истинном значении флага. Секция над непустым списком повторяет разметку для каждого элемента, а инвертированная секция {{^items}} позволяет вывести сообщение о пустом списке.
Для общего шаблона держите явный контракт данных. Передавайте логические флаги как true и false, списки как массивы, готовые подписи как строки. Подключаемые фрагменты передавайте обеим реализациям под одинаковыми именами. Проверьте вывод на одних и тех же наборах данных в PHP и JavaScript, особенно при пустых списках, отсутствующих полях и строках со спецсимволами. Обработчики кликов и обновление состояния страницы остаются в клиентском коде.
Экранирование и кеширование
Экранируйте значения в момент вывода. Для текста HTML и обычных атрибутов в кавычках подходит HTML-экранирование. В Twig с HTML-автоэкранированием, в обычном выводе Blade и в стандартных переменных Mustache оно выполняется движком. Предварительно экранированная строка может пройти через ту же операцию повторно, и пользователь увидит запись HTML-сущности вместо символа.
- Для адресов в
hrefиsrcдополнительно проверяйте допустимую схему или формируйте адрес на стороне приложения. HTML-экранирование само по себе не запрещает опасные схемы. - Для передачи структурированных данных в JavaScript используйте JSON и штатный помощник фреймворка для встраивания данных в HTML. У JavaScript, CSS и HTML разные правила вывода.
- Фильтр
rawв Twig, сырой вывод Blade и тройные фигурные скобки Mustache подходят для доверенной разметки. Если пользователю разрешено вводить HTML, пропускайте его через HTML-санитайзер с перечнем разрешённых элементов и атрибутов.
В рабочем окружении используйте кеш компиляции, если движок его поддерживает. Twig и Blade могут переиспользовать скомпилированные шаблоны, а OPcache при соответствующей настройке хранит байткод PHP. Кеш готового HTML — отдельное решение. Если результат зависит от языка, прав или конкретного пользователя, учтите эти зависимости в ключе кеша или исключите персонализированный фрагмент из общего кеширования.
Чек-лист перед выпуском
- Убедитесь, что шаблон получает подготовленные поля и рендерится без запросов к базе или внешним сервисам.
- Проверьте модель представления модульными тестами. Для карточки товара достаточно покрыть наличие, отсутствие товара и запрет заказа.
- Отдельно отрендерите шаблон с типовыми и пограничными данными. Проверьте пустой список, необязательные поля и спецсимволы. Для строки со знаками разметки проверьте, что она остаётся текстом в полученном HTML.
- Если шаблон общий для PHP и JavaScript, прогоните одинаковые данные на обеих сторонах. Сравнивайте структуру HTML и видимый результат, если различия в пробелах или записи сущностей не имеют значения.
- На рабочей конфигурации проверьте загрузку шаблонов, права на каталог кеша и обновление скомпилированных файлов при развёртывании.
Частые вопросы
Обязательно ли использовать шаблонизатор в PHP?
Нет. Нативные PHP-шаблоны подходят для простых страниц, если проект явно задаёт правила экранирования, подключения файлов и подготовки данных. Отдельный движок удобен, когда нужны общие раскладки, компоненты и единые правила вывода.
Что лучше выбрать для нового проекта — Twig или Blade?
Для Laravel обычно выбирают Blade, для Symfony — Twig. В проекте без фреймворка Twig можно подключить через Composer и использовать для HTML-страниц с общими раскладками.
Можно ли одним шаблоном Mustache пользоваться в PHP и JavaScript?
Да. Используйте один файл шаблона, общие подключаемые фрагменты и одинаковую структуру входных данных. Совместимость вывода проверяйте на одинаковых примерах в обеих реализациях.