Курс 'Язык программирования PHP'

Метод define

Синтаксис:

define( array ( ключ => значение,
                ключ1 => значение1, ... ))

Метод define() связывает имя файла шаблона с более коротким именем, которое можно будет использовать в программе. То есть 'ключ' - это имя, которое мы будем использовать в программе для ссылки на файл шаблона, имя которого записано в строке 'значение'. Реальные имена файлов шаблонов не рекомендуется использовать нигде, кроме метода define. При вызове метода define() происходит загрузка всех определенных в нем шаблонов.

$tpl->define( array (main => 'main.tpl',
    list_f => 'list.tpl',
    list_el=> 'list_element.tpl' ));

Здесь мы задаем псевдонимы именам файлов шаблонов. Эти псевдонимы, т.е. переменные main, list_f и list_el, будут использоваться в программе вместо соответствующих имен файлов main.tpl, list.tpl и list_element.tpl.

Метод assign

Синтаксис:

assign( (пары ключ/значение) или
      ( array(пары ключ/значение) )

Метод assign() присваивает переменным значения, 'ключ' - это имя переменной, а 'значение' - значение, которое ей нужно присвоить. Чтобы переменная в шаблоне была заменена значением, это значение нужно задать ей с помощью метода assign(). Согласно синтаксису этот метод можно использовать в двух различных формах. В FastTemplate есть только один массив, поэтому, если вы повторно задаете значение одному и тому же ключу, оно будет перезаписано.

$tpl->assign(array(
    TITLE => 'Установка и настройка ПО',
    TITLE => 'Введение в PHP' ));

Здесь мы дважды устанавливаем значение переменной, доступной в файлах шаблона по имени TITLE. Эта переменная будет иметь последнее присвоенное ей значение, т.е. она равна строке 'Введение в PHP'.

Метод parse

Синтаксис:

parse (возвращаемая переменная,
       источники шаблонов)

Метод parse() - самый основной в FastTemplate. Он устанавливает значение возвращаемой переменной равным обработанным шаблонам из указанных источников. Метод может использоваться в трех формах: простой, составной и присоединяющей.

$tpl->parse(MAIN, 'main');
    // простая форма
$tpl->parse(MAIN, array ('list_f', 'main'));
    // составная форма
$tpl->parse(MAIN, '.list_el');
    // присоединяющая форма

В простой форме шаблон с псевдонимом 'main' загружается (если еще не был загружен), все его переменные подставляются, и результат сохраняется как значение переменной MAIN. Если переменная {MAIN} появится в более поздних шаблонах, то вместо нее будет подставлено значение, полученное в результате обработки шаблона 'main'. Это позволяет создавать вложенные шаблоны.

Составная форма метода parse() создана для того, чтобы упростить вложение шаблонов друг в друга. Следующие записи эквивалентны:

$tpl->parse(MAIN, 'list_f');
$tpl->parse(MAIN, '.main');

это то же самое что и

$tpl->parse(MAIN, array('list_f', 'main'));

Когда используется составная форма, важно, чтобы каждый шаблон, идущий в списке после первого, содержал ту переменную, в которую передаются результаты обработки шаблона. В примере выше main должен содержать переменную {MAIN}, поскольку именно в нее передаются результаты обработки шаблона list_f. Если main не содержит переменной {MAIN}, то результаты обработки шаблона list_f будут потеряны.

Присоединяющий стиль позволяет добавлять результаты обработки шаблона к переменной результата. Точка перед псевдонимом файла шаблона говорит FastTemplate о том, что нужно присоединить результат обработки этого шаблона к возвращенным результатам, а не перезаписывать его. Такой стиль наиболее часто используется при построении таблиц с переменным числом рядов, получаемых, например, в результате запроса к базе данных.

Метод FastPrint

Синтаксис:

FastPrint(обработанная переменная)

Метод FastPrint() печатает содержимое переданной в него обработанной переменной. Если он вызван без параметров, то печатается последняя использованная методом parse() переменная.