Введение

Добро пожаловать в документацию по Twig, гибкому, быстрому и безопасному движку шаблонов для PHP.

Twig дружелюбен как для дизайнеров, так и для разработчиков, следуя принципам PHP и добавляя функциональность, полезную для сред шаблонов.

Ключевые особенности:

• Быстрый: Twig компилирует шаблоны в оптимизированный PHP-код. Накладные расходы по сравнению с обычным PHP-кодом сведены к минимуму.
• Безопасный: Twig имеет режим песочницы для оценки небезопасного кода шаблона. Это позволяет использовать Twig в качестве языка шаблонов для приложений, где пользователи могут изменять дизайн шаблона.
• Гибкий: Twig работает с гибким лексическим анализатором и парсером. Это позволяет разработчику определять собственные пользовательские теги и фильтры, а также создавать собственные DSL.

Twig используется во многих проектах с открытым исходным кодом, таких как Symfony, Drupal8, eZPublish, phpBB, Matomo, OroCRM; а также многие фреймворки поддерживают его, такие как Slim, Yii, Laravel и Codeigniter — лишь некоторые из них.

Предварительные требования

Twig 3.x требует как минимум PHP 7.2.5 для работы.

Установка

Рекомендуемый способ установки Twig — через Composer:

composer require "twig/twig:^3.0"

Базовое использование API

Этот раздел предоставляет краткое введение в PHP API для Twig:

require_once '/path/to/vendor/autoload.php';

$loader = new \Twig\Loader\ArrayLoader([
    'index' => 'Hello {{ name }}!',
]);
$twig = new \Twig\Environment($loader);

echo $twig->render('index', ['name' => 'Fabien']);

Twig использует загрузчик (\Twig\Loader\ArrayLoader) для поиска шаблонов и окружение (\Twig\Environment) для хранения его конфигурации.

Метод render() загружает шаблон, переданный в качестве первого аргумента, и отображает его с переменными, переданными в качестве второго аргумента.

Поскольку шаблоны обычно хранятся в файловой системе, Twig также поставляется с загрузчиком файловой системы:

$loader = new \Twig\Loader\FilesystemLoader('/path/to/templates');
$twig = new \Twig\Environment($loader, [
    'cache' => '/path/to/compilation_cache',
]);

echo $twig->render('index.html', ['name' => 'Fabien']);