mmxTwig - еще одна интеграция шаблонизатора

Вы будете смеяться, но я написал еще одно composer-only дополнение для MODX. Это было несложно, благодаря той же логике работы, что и у mmxFenom.



Как оказалось, Fenom уже давненько не развивается.

3я версия по факту нерабочая и последний коммит был сделан больше года назад. Конечно, 2я версия вполне ок и свои задачи выполняет, но вообще проект выглядит не очень живым.

А Twig поддерживается сообществом Symfony, так что там с этим делом полный порядок. Поэтому мне и подкинули идею, в личной группе, добавить еще один шаблонизатор — что я сегодня и сделал.

Быстрый старт

Устанавливаем вот так

composer require mmx/twig --update-no-dev --with-all-dependencies
composer exec mmx-twig install

Затем создаём сниппет Test

$tpl = $modx->getOption('tpl', $scriptProperties);
$var = $modx->getOption('var', $scriptProperties);

if ($service = $modx->services->get('mmxTwig')) {
    $service->addFilter(
        new \Twig\TwigFilter('hello', static function($var) {
            return $var . ' World!';
        }
    ));
    
    return $service->render($tpl, ['var' => $var]);
}

return '';

Потом чанк Test

{{ var | hello }}

Потом вызываем сниппет на странице

[[!Test?tpl=`test`&var=`Hello`]]

И всё работает!

Отличия от Fenom

Конечно же, здесь другой синтаксис.

Иначе вызываются переменные, по-другому работают циклы и т.д. — смотрите документацию.

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

Еще, насколько я вижу по коду, для рендера не используется функция eval(). Безопасность!

Ну а так — всё то же самое:

• 3 источника шаблонов: чанки, шаблоны MODX и файлы
• Правильное кэширование элементов MODX, благодаря записи времени изменения в БД
• Фильтры, циклы, расширения и т.д. и т.п.
• Доступ к глобальным переменным (можно включить и доступ к MODX)

Пример распечатки данных сервера

{{ server | print }}

Скорость

Адаптировал тестовый код из старой заметки и погонял на modhost.pro.

<?php
define('MODX_API_MODE', true);
require 'index.php';

$service = $modx->services->get('mmxTwig'); // Тут можно поменять на mmxFenom
$tpl = 'tplTwig'; // а тут указать чанк для Fenom
// $tpl = 'file:twig.tpl'; // или реальный файл из core/elements

$output = '';
for ($i = 0; $i <= 10000; $i ++) {
	$array = array('val1' => rand(), 'val2' => rand(), 'val3' => rand());
	$output .= $service->render($tpl, $array);
}

echo microtime(true) - $modx->startTime . 's' . PHP_EOL . $output;

Код чанков простейший:

<p>{{val1}} - {{val2}} - {{val3}}</p>
<!-- или для Fenom -->
<p>{$val1} - {$val2} - {$val3}</p>

Обычный чанк из БД: Fenom 0.021, Twig 0.054
Статичный чанк: Fenom: 0.024, Twig 0.059
Реальный файл: Fenom: 0.350, Twig 0.078

Получается, что работа с реальными файлами самая медленная, причём у обоих шаблонизаторов. У Fenom скорость падает аж на порядок, и это при том, что используется его родной провайдер для файлов. Не знаю, почему так — пока не нашёл узкое место.

Оба компонента тестировал на версии 1.0.2.

Заключение

Ни новый mmxFenom, ни новый mmxTwig не вмешиваются в работу системного парсера и друг друга, так что могут быть установлены одновременно для использования в разных дополнениях.

Стоит упомянуть, что 8 лет назад была еще одна интеграция — Twiggy, но дальше бета-версии она не ушла.

Лично я с Twig раньше никогда не работал, но выглядит он весьма интересно, так что попробую погонять его на каком-то реальном проекте.

Поставить плюсики и создать issues можно в репозитории — github.com/bezumkin/mmx-twig

Задать вопросы можно в комментриях, или в моём чатике — как вам удобно.