Виды и шаблоны

Виды и шаблоны

Разделение забот

Пользовательский интерфейс, такой как HTML-страница, должен быть независим от базового PHP-кода, связанного с маршрутизацией и бизнес-логикой. Это фундаментально для парадигмы MVC. Базовая ревизия, такая как преобразование <h3>в<p>, не должна требовать изменения кода вашего приложения. Точно так же преобразование простого маршрута типа GET /aboutto GET /about-usне должно оказывать никакого влияния на ваш пользовательский интерфейс и бизнес-логику (представление и модель в MVC или представление и метод в RMR).
Смешивание программных конструкций и компонентов пользовательского интерфейса в одном файле, как спагетти-кодирование, делает будущее обслуживание приложений кошмаром.

PHP как шаблонный движок

F3 поддерживает PHP в качестве шаблонного движка. Взгляните на этот HTML фрагмент сохраненный какtemplate.htm:
1
<p>Hello, <?php echo $name; ?>!</p>
Copied!
Независимо от того, включены ли короткие теги на вашем сервере или нет, это тоже должно работать:
1
<p>Hello, <?= $name ?></p>
Copied!
Следующий PHP код использует этот Viewкласс для визуализации шаблона PHP хранящегося в template.htmфайле:
1
$f3=require('lib/base.php');
2
$f3->route('GET /',
3
function($f3) {
4
$f3->set('name','world');
5
$view=new View;
6
echo $view->render('template.htm');
7
// Предыдущие две строки можно сократить до:
8
// echo View::instance()->render('template.htm');
9
}
10
);
11
$f3->run();
Copied!
Единственная проблема с использованием PHP в качестве шаблонного движка, из-за встроенного PHP-кода в эти файлы, заключается в сознательном усилии, необходимом для того, чтобы придерживаться рекомендаций по разделению проблем и противостоять искушению смешивать бизнес-логику с вашим пользовательским интерфейсом.

Быстрый взгляд на язык шаблонов F3

В качестве альтернативы шаблонам PHP вы можете использовать собственный шаблонный движок F3 с этим Templateклассом. Приведенный выше фрагмент HTML может быть переписан следующим образом:
1
<p>Hello, {{ @name }}!</p>
Copied!
и код, необходимый для просмотра этого шаблона:
1
$f3=require('lib/base.php');
2
$f3->route('GET /',
3
function($f3) {
4
$f3->set('name','world');
5
echo \Template::instance()->render('template.htm');
6
}
7
);
8
$f3->run();
Copied!
Обратите внимание: Рекомендуемый синтаксис\Template::instance(). Тем не менее вы также можете создать новый экземпляр с new \Template();.
Например, маркеры маршрутизации, используемые для перехвата переменных в URL-адресах (все еще помните GET /brew/@countпример в предыдущем разделе?), Маркеры шаблона F3 начинаются с @символа, за которым следует ряд букв и цифр, заключенных в фигурные скобки. Первый символ должен быть альфа. Шаблонные токены имеют однозначное соответствие с переменными фреймворка. Фреймворк автоматически заменяет токен значением, хранящимся в переменной с тем же именем.
В нашем примере F3 заменяет @nameмаркер в нашем шаблоне значением, присвоенным переменной name. Во время выполнения вывод вышеприведенного кода будет выглядеть следующим образом::
1
<p>Hello, world</p>
Copied!
Беспокоитесь о производительности шаблонов F3? Во время выполнения фреймворк анализирует и компилирует/преобразует шаблон F3 в PHP-код при первом его отображении $template->render(). Затем фреймворк использует этот скомпилированный код во всех последующих вызовах. Следовательно, производительность должна быть такой же, как и у шаблонов PHP, если не лучше из-за оптимизации кода, выполняемой компилятором шаблонов, когда задействованы более сложные шаблоны.
Независимо от того, используете ли вы движок шаблонов PHP или собственный движок F3, рендеринг шаблонов может быть значительно быстрее, если у вас есть APC, WinCache или XCache, доступные на вашем сервере.
Как упоминалось ранее, переменные фреймворка могут содержать любой тип данных PHP. Однако использование нескалярных типов данных в шаблонах F3 может привести к странным результатам, если вы не будете осторожны. Выражения в фигурных скобках всегда будут вычисляться и преобразовываться в строку. Вы должны ограничить переменные пользовательского интерфейса простыми скалярами:string,integer, booleanили floatтипами данных.
Но как насчет массивов? Fat-Free распознает массивы, и вы можете использовать их в своих шаблонах. Вы можете иметь что-то вроде:
1
<p>{{ @buddy[0] }}, {{ @buddy[1] }}, and {{ @buddy[2] }}</p>
Copied!
И заполните @buddyмассив в вашем PHP коде перед подачей шаблона:
1
$f3->set('buddy',array('Tom','Dick','Harry'));
Copied!
Однако, если вы просто вставите {{ @buddy }}его в свой шаблон, PHP сгенерирует Array to string conversionуведомление во время выполнения.
F3 позволяет вставлять выражения в шаблоны. Эти выражения могут принимать различные формы, такие как арифметические вычисления, булевы выражения, константы PHP и т. д. Вот несколько примеров:
1
{{ 2*(@page-1) }}
2
{{ (int)765.29+1.2e3 }}
3
<option value="F" {{ @active?'selected="selected"':'' }}>Female</option>
4
{{ var_dump(@xyz) }}
5
<p>That is {{ preg_match('/Yes/i',@response)?'correct':'wrong' }}!</p>
6
{{ @obj->property }}
Copied!
Дополнительное замечание о выражениях массива: обратите внимание, что @[email protected]это конкатенация строк ($foo.$bar), тогда @foo.barкак переводится $foo['bar']в. Если $foo[$bar]это то, что вы намеревались, используйте @foo[@bar]обычную нотацию.
Переменные фреймворка также могут содержать анонимные функции:
1
$f3->set('func',
2
function($a,$b) {
3
return $a.', '.$b;
4
}
5
);
Copied!
Механизм шаблонов F3 интерпретирует маркер как ожидалось, если вы зададите следующее выражение:
1
{{ @func('hello','world') }}
Copied!
Обратите внимание: Если у вас есть ошибка неопределенной переменной или неопределенного индекса во время рендеринга ваших шаблонов F3, это означает, что переменная или индекс массива ранее не были объявлены в вашей функции, вызывающей действие template render (). Два решения:
  • Предпочтительно: определите все переменные в вашем коде, даже если они равны нулю;
    • $f3 - >set ('myVar', NULL)
    • $f3 - >set ('myArray.myIndex', 'первый пункт')
  • Быстро, но грязно: используйте дополнительный символ AT @ перед токеном;
    • {{@@myArray.myIndex}}
    • чтобы подавить отображение сообщения об ошибке

Шаблоны Внутри Шаблонов

Простая замена переменных-это то, что есть у всех шаблонных движков. F3 имеет больше в рукавах:
1
<include href="header.htm" />
Copied!
Директива будет встраивать содержимое заголовка шаблон htm находится в точном месте, где указана директива. Вы также можете иметь динамический контент в виде:
1
<include href="{{ @content }}" />
2
// ИЛИ
3
<include href="{{ 'templates/layout/'[email protected] }}" />
4
5
// НЕПРАВИЛЬНО
6
<include href="templates/layout/{{ @content }}" />
Copied!
Практическая польза для такой директивы шаблона заключается в том, что у вас есть несколько страниц с общим HTML-макетом, но с разным контентом. Указание фреймворку вставить подшаблон в ваш основной шаблон так же просто, как написать следующий PHP-код:
1
// переключите контент на подшаблон вашего блога
2
$f3->set('content','blog.htm');
3
// в другом маршруте переключите содержимое на подшаблон wiki
4
$f3->set('content','wiki.htm');
Copied!
Подшаблон, в свою очередь, может содержать любое количество директивы. F3 позволяет использовать неограниченное количество вложенных шаблонов.
Вы можете указать имена файлов с чем-то другим, чем .htm или .расширения html-файлов, но их проще просматривать в вашем веб-браузере на этапе разработки и отладки. Механизм шаблонов не ограничивается рендерингом HTML-файлов. На самом деле вы можете использовать механизм шаблонов для визуализации других типов файлов.
<include>Директива имеет необязательный ifатрибут, позволяющий указать условие, которое должно быть выполнено для вставки подшаблона:
1
<include if="{{ count(@items) >= 2 }}" href="items.htm" />
Copied!
Текущий массив данных передается в подшаблон. Однако вы можете передавать новые переменные или перезаписывать существующие переменные с помощью withатрибута:
1
<!-- передайте $a=2 в sub.htm -->
2
<include href="sub.htm" with="a=2" />
3
4
<!-- передайте $b="что-то" и $c= "что-то в кавычках" sub.htm -->
5
<include href="sub.htm" with="b=something,c='something quoted'" />
6
7
<!-- передайте значение в верхнем регистре $d в sub.htm -->
8
<set d="abc" />
9
<include href="sub.htm" with="d={{strtoupper($d)}}" /> // $d='ABC'
10
{{@d}} // $d='abc'
Copied!
Обратите внимание: в настоящее время невозможно использовать PHPTRUE-константу как с-переменную, так как все атрибуты анализируются как строка.

Исключение сегментов

Во время написания/отладки программ на базе F3 и разработки шаблонов могут быть случаи, когда отключение отображения блока HTML может оказаться полезным. Вы можете использовать <exclude>директиву для этой цели:
1
<exclude>
2
<p>Кусок HTML, который мы не хотим отображать в данный момент</p>
3
</exclude>
Copied!
Это похоже на <!-- comment -->тег HTML-комментария, но <exclude>директива делает HTML-блок полностью невидимым после рендеринга шаблона.
Вот еще один способ исключения содержимого шаблона или добавления комментариев:
1
{* <p>Кусок HTML, который мы не хотим отображать в данный момент</p> *}
Copied!

Условные Сегменты

Еще одна полезная функция шаблона-<check>директива. Он позволяет встраивать HTML-фрагмент в зависимости от оценки определенного условия. Вот несколько примеров:
1
<check if="{{ @page=='Home' }}">
2
<false><span>Вставляется, если условие ложно</span></false>
3
</check>
4
<check if="{{ @gender=='M' }}">
5
<true>
6
<div>Появляется, когда условие истинно</div>
7
</true>
8
<false>
9
<div>Появляется, когда условие ложно</div>
10
</false>
11
</check>
Copied!
Вы можете иметь столько вложенных <check>директив, сколько вам нужно.
Выражение F3 внутри атрибута if, которое приравнивается к NULLпустой строке, логическому FALSEзначению, пустому массиву или нулю, автоматически вызывается <false>. Если ваш шаблон не имеет <false>блока, то <true>открывающие и закрывающие теги являются необязательными:
1
<check if="{{ @loggedin }}">
2
<p>Фрагмент HTML, который будет включен, если условие истинно</p>
3
</check>
Copied!

Повторяющиеся Сегменты

Fat-Free также может обрабатывать повторяющиеся HTML-блоки:
1
<repeat group="{{ @fruits }}" value="{{ @fruit }}">
2
<p>{{ trim(@fruit) }}</p>
3
</repeat>
Copied!
groupАтрибут @fruitsвнутри <repeat>директивы должен быть массивом и должен быть установлен в вашем PHP коде соответствующим образом:
1
$f3->set('fruits',array('apple','orange ',' banana'));
Copied!
Присвоение значения @fruitв коде приложения ничего не дает. Fat-Free игнорирует любое заданное значение, которое у него может быть, потому что он использует переменную для представления текущего элемента во время итерации по группе. Вывод приведенного выше фрагмента HTML шаблона и соответствующего PHP кода становится:
1
<p>apple</p>
2
<p>orange</p>
3
<p>banana</p>
Copied!
Фреймворк допускает неограниченную вложенность <repeat>блоков:
1
<repeat group="{{ @div }}" key="{{ @ikey }}" value="{{ @idiv }}">
2
<div>
3
<p><span><b>{{ @ikey }}</b></span></p>
4
<p>
5
<repeat group="{{ @idiv }}" value="{{ @ispan }}">
6
<span>{{ @ispan }}</span>
7
</repeat>
8
</p>
9
</div>
10
</repeat>
Copied!
Примените следующую команду F3:
1
$f3->set('div',
2
array(
3
'coffee'=>array('arabica','barako','liberica','kopiluwak'),
4
'tea'=>array('darjeeling','pekoe','samovar')
5
)
6
);
Copied!
В результате вы получаете следующий HTML-фрагмент:
1
<div>
2
<p><span><b>coffee</b></span></p>
3
<p>
4
<span>arabica</span>
5
<span>barako</span>
6
<span>liberica</span>
7
<span>kopiluwak</span>
8
<p>
9
</div>
10
<div>
11
<p><span><b>tea</b></span></p>
12
<p>
13
<span>darjeeling</span>
14
<span>pekoe</span>
15
<span>samovar</span>
16
</p>
17
</div>
Copied!
Удивительно, не правда ли? И единственное, что вам нужно было сделать в PHP, - это определить содержимое одной переменной F3div, чтобы заменить @divтокен. Fat-Free делает как программирование, так и дизайн веб-шаблонов действительно простыми.
Атрибут <repeat>директивы template valueвозвращает значение текущего элемента в итерации. Если вам нужно получить ключ массива текущего элемента, используйте keyвместо него атрибут. keyАтрибут необязателен.
<repeat> также имеет необязательный атрибут счетчика, который можно использовать следующим образом:
1
<repeat group="{{ @fruits }}" value="{{ @fruit }}" counter="{{ @ctr }}">
2
<p class="{{ @ctr%2?'odd':'even' }}">{{ trim(@fruit) }}</p>
3
</repeat>
Copied!
Внутренне механизм шаблонов F3 записывает количество итераций цикла и сохраняет это значение в переменной/токене @ctr, которая используется в нашем примере для определения нечетной/четной классификации.

Встраивание Javascript и CSS

Если вам нужно вставить маркеры F3 внутри <script><style>раздела или вашего шаблона, фреймворк все равно заменит их обычным способом:
1
<script type="text/javascript">
2
function notify() {
3
alert('Вы вошли в систему как: {{ @userID }}');
4
}
5
</script>
Copied!
Встраивание директив шаблонов в ваши <script><style>теги or не требует специальной обработки:
1
<script type="text/javascript">
2
var discounts=[];
3
<repeat group="{{ @rates }}" value="{{ @rate }}">
4
// все, что вы хотите повторить в Javascript, например
5
discounts.push("{{ @rate }}");
6
</repeat>
7
</script>
Copied!

Пути к файлам

Есть некоторые вещи, которые следует учитывать в отношении общедоступных путей, используемых в ссылках на страницы или стилях / сценариях или изображениях. Вероятно, вы хотите использовать относительные пути:
1
<link href="ui/css/base.css" type="text/css" rel="stylesheet" />
2
<script src="ui/js/base.css"></script>
3
<a href="category-abc/article-xyz">подробнее</a>
4
<img src="ui/img/img1.jpg" alt="Image 1" />
Copied!
Эти пути могут работать на вашей индексной странице GET /, но вызовут проблемы при переходе к GET /@category/@articleприложению или запуске приложения из подкаталога в общедоступном корневом каталоге вашего веб-пространства (http://domain.com/my-F3-App/т. е. Чтобы решить эту проблему, вы должны либо дополнить все свои пути общедоступным базовым путем, как это:
1
<link href="{{@BASE}}/ui/css/base.css" type="text/css" rel="stylesheet" />
2
<script src="{{@BASE}}/ui/js/base.css"></script>
3
<a href="{{@BASE}}/category-abc/article-xyz">подробнее</a>
4
<img src="{{@BASE}}/ui/img/img1.jpg" alt="Image 1" />
Copied!
Или используйте базовый тег HTML, чтобы указать базовый путь по умолчанию для всех документов для относительных ссылок:
1
<base href="{{@SCHEME.'://'[email protected]@BASE.'/'}}">
Copied!
Есть некоторые побочные эффекты использования <base>тега в вашем документе: в основном вам также нужно префиксить все якорные ссылки страниц (<a href="{{@PATH}}#top">go to top</a>).

Кодировка Документа

Fat-Free по умолчанию использует набор символов UTF-8. Вы можете переопределить это поведение, установив ENCODINGсистемную переменную следующим образом:
1
$f3->set('ENCODING','ISO-8859-1');
Copied!
Как только вы сообщите фреймворку желаемый набор символов, F3 будет использовать его для всех HTML-и XML-шаблонов, пока снова не изменит их.

Все виды шаблонов

Как уже упоминалось ранее в этом разделе, фреймворк не ограничивается HTML-шаблонами. Вы также можете обрабатывать XML-шаблоны. Механика в значительной степени схожа. В вашем распоряжении все те же {{ @variable }}{{ expression }}жетоны, <repeat>, <check>, <include>, и <exclude>директивы. Просто скажите F3, что вы передаете XML-файл вместо HTML:
1
echo Template::instance()->render('template.xml','application/xml');
Copied!
Второй аргумент представляет тип MIME отображаемого документа.
Компонент представления MVC охватывает все, что не подпадает под модель и контроллер, а это означает, что ваша презентация может и должна включать в себя все виды пользовательских интерфейсов, таких как RSS, электронная почта, RDF, FOAF, текстовые файлы и т. д. В приведенном ниже примере показано, как отделить презентацию электронной почты от бизнес-логики приложения:
1
MIME-Version: 1.0
2
Content-type: text/html; charset={{ @ENCODING }}
3
From: {{ @from }}
4
To: {{ @to }}
5
Subject: {{ @subject }}
6
7
<p>Добро пожаловать и спасибо, что присоединились {{ @site }}!</p>
Copied!
Сохраните вышеприведенный шаблон электронной почты как приветствие формат txt. Связанный с этим код F3 будет следующим:
1
$f3->set('from','<[email protected]>');
2
$f3->set('to','<[email protected]>');
3
$f3->set('subject','Welcome');
4
ini_set('sendmail_from',$f3->get('from'));
5
mail(
6
$f3->get('to'),
7
$f3->get('subject'),
8
Template::instance()->render('email.txt','text/html')
9
);
Copied!
Совет: замените функцию SMTP mail() на imap_mail (), если ваш скрипт взаимодействует с сервером IMAP.
Ну разве это не здорово? Конечно, если у вас есть набор получателей электронной почты, вы будете использовать базу данных для заполнения маркеров firstName, lastName и email.
Вот альтернативное решение, использующее SMTP-плагин F3:
1
$mail=new SMTP('smtp.gmail.com',465,'SSL','[email protected]','secret');
2
$mail->set('from','<[email protected]>');
3
$mail->set('to','"Slasher" <[email protected]>');
4
$mail->set('subject','Welcome');
5
$mail->send(Template::instance()->render('email.txt'));
Copied!

многоязычная поддержка

F3 поддерживает несколько языков прямо из коробки.
Сначала создайте файл словаря со следующей структурой (по одному файлу на каждый язык):
1
<?php
2
return array(
3
'love'=>'I love F3',
4
'today'=>'Today is {0,date}',
5
'pi'=>'{0,number}',
6
'money'=>'Amount remaining: {0,number,currency}'
7
);
Copied!
Сохраните его как dict/en.php. Давайте создадим еще один словарь, на этот раз для немецкого языка. Сохраните файл какdict/de.php:
1
<?php
2
return array(
3
'love'=>'Ich liebe F3',
4
'today'=>'Heute ist {0,date}',
5
'money'=>'Restbetrag: {0,number,currency}'
6
);
Copied!
Словари - это не более чем пары ключ-значение. F3 автоматически создает экземпляры переменных фреймворка на основе ключей в языковых файлах. Таким образом, легко встроить эти переменные в качестве маркеров в ваши шаблоны.
Обратите внимание: пары ключ-значение словаря становятся переменными F3 после ссылки. Убедитесь, что ключи не конфликтуют ни с одной переменной фреймворка, созданной с помощью `$f3->set ()`, `$f3->>mset ()` или `$f3->>>config()`. Кроме того, вы также можете использовать префикс var для установки общего ключа, который предшествует каждому языковому ключу.
Примеры использования нескольких языков с помощью движка шаблонов F3:
1
<h1>{{ @love }}</h1>
2
<p>
3
{{ @today,time() | format }}.<br />
4
{{ @money,365.25 | format }}<br />
5
{{ @pi, 3.1415 | format }}
6
</p>
Copied!
И более длинная версия, которая использует PHP в качестве шаблонного движка:
1
<?php $f3=Base::instance(); ?>
2
<h1><?php echo $f3->get('love'); ?></h1>
3
<p>
4
<?php echo $f3->get('today',time()); ?>.<br />
5
<?php echo $f3->get('money',365.25); ?><br />
6
<?php echo $f3->get('pi', 3.1415); ?>
7
</p>
Copied!
Далее мы даем команду F3 искать словари в dict/папке:
1
$f3->set('LOCALES','dict/');
Copied!
Но как фреймворк определяет, какой язык использовать? F3 обнаружит его автоматически, посмотрев сначала на заголовки HTTP-запросов, а именно на Accept-Languageзаголовок, отправленный браузером.
Чтобы переопределить это поведение, можно вызвать F3 для использования языка, указанного пользователем или приложением:
1
$f3->set('LANGUAGE','de');
Copied!
Основной язык вашего сайта
В приведенном выше примере ключ piсуществует только в словаре английского языка. Фреймворк всегда будет использовать резервный язык для заполнения ключей, которые отсутствуют в указанном или обнаруженном языке(языках). В нашем примере ключpi, присутствующий в словаре английского языка, был выбран потому, что английский язык является резервным языком по умолчанию, установленным F3 при запуске. Поэтому важно убедиться, что все многоязычные тексты, используемые на вашем сайте, определены в словаре резервного языка в противном случае во время выполнения будет вызвана ошибка или, по крайней мере, предупреждение или уведомление, когда будет сделана ссылка на неопределенную переменную.
Если основной язык вашего сайта не английский, и вы не перевели все строки на другие языки, вы должны поручить F3 использовать ваш справочник по родному языку в качестве запасного варианта. Вы можете легко сделать это благодаря переменной FALLBACKhive:
1
$f3->set('FALLBACK','it'); // Итальянский как запасной язык по умолчанию
Copied!
Варианты Языка
Вы также можете создавать файлы словарей для языковых вариантов, таких какen-US,es-AR, и т.д. В этом случае F3 сначала будет использовать языковой вариант, например es-AR. Если есть ключи, которые не существуют в словаре вариантов, фреймворк будет искать ключ в корневом языке , напримерes, и, если он все еще не найден, использовать определенный резервный языковой файл.
Вы заметили странную 'Today is {0,date}'закономерность в нашем предыдущем примере? Многоязычная возможность F3 зависит от правил форматирования строк/сообщений проекта ICU. Фреймворк использует свое собственное подмножество реализации форматирования строк ICU. Нет никакой необходимости в intlтом, чтобы расширение PHP было активировано на сервере.
Еще одна вещь: F3 также может загружаться .файлы в формате ini-style в виде словарей:
1
love = Я люблю F3
2
today = Сегодня {0,date}
3
pi = {0,number}
4
money = Оставшаяся сумма: {0,number,currency}
5
multiline = Также возможно наличие языковых клавиш \
6
распределено по нескольким линиям
7
8
[module.user.validation]
9
name.required = Пожалуйста, введите свое имя.
10
mail.invalid = Этот адрес электронной почты недействителен.
Copied!
Сохраните его как dict/en.iniтаковой, чтобы фреймворк мог загружать его автоматически. Языковая переменная принимает тот же тип строки, что и заголовок HTTP Accept-Language, который представляет собой разделенный запятыми список 2-буквенных кодов языков, за которыми необязательно следует дефис и 2-буквенный код страны. NB: несмотря на то, что локали POSIX используют подчеркивание в качестве разделителя (es_BR.UTF-8), вы должны определить языковую переменную с дефисом (es-BR). Файлы словарей следуют тому же правилу (es-BR.php / es-BR.ini).
Дополнительные технические сведения см. В разделе База->язык> метод.

Санитария Данных

По умолчанию и обработчик представлений, и механизм шаблонов экранируют все визуализированные переменные, то есть преобразуются в HTML-сущности, чтобы защитить вас от возможных атак XSS и инъекций кода. С другой стороны, если вы хотите передать допустимые HTML-фрагменты из кода приложения в шаблон:
1
$f3->set('ESCAPE',FALSE);
Copied!
Это может иметь нежелательные последствия. Возможно, вы не захотите, чтобы все переменные проходили через unescaped. Fat-Free позволяет вам распаковывать переменные по отдельности. Для шаблонов F3 используйте rawфильтр:
1
{{ @html_content | raw }}
Copied!
В случае PHP-шаблонов используйте непосредственно raw-метод:
1
<?php echo $this->raw($html_content); ?>
Copied!
В дополнение к автоматическому экранированию переменных F3 фреймворк также дает вам свободу действий при очистке пользовательского ввода из HTML-форм:
1
$f3->scrub($_GET,'p; br; span; div; a');
Copied!
Эта команда удалит все теги (кроме указанных во втором аргументе) и небезопасные символы из указанной переменной. Если переменная содержит массив, то каждый элемент в массиве рекурсивно очищается. Если звездочка ( * ) передается в качестве второго аргумента, $f3->scrub()это позволяет всем HTML-тегам проходить через нетронутые и просто удалять небезопасные управляющие символы.

Расширение фильтров и пользовательских тегов

С помощью шаблонного движка F3 вы также можете настроить собственные фильтры выражений like{{ @desc,100 | crop }}, а также комбинировать их like {{ @desc,100 | crop,raw }}. Поэтому вам просто нужно зарегистрировать новый фильтр с помощью метода filter. Для собственных обработчиков html-тегов / элементов, которые могут отображать все, что вы хотите, проверьте метод template->extend>. Для получения более подробных описаний пользовательских фильтров и работы всей системы шаблонов см. расширенную часть руководства пользователя по шаблону.