TimedPhpEngine

__construct(TemplateNameParserInterface $parser, ContainerInterface $container, LoaderInterface $loader, Stopwatch $stopwatch, GlobalVariables $globals = null)

Параметры

TemplateNameParserInterface	$parser	Экземпляр TemplateNameParserInterface
ContainerInterface	$container
LoaderInterface	$loader	Экземпляр загрузчика
Stopwatch	$stopwatch
GlobalVariables	$globals

string render(string|TemplateReferenceInterface $name, array $parameters = array())

Отображает шаблон.

Параметры

string|TemplateReferenceInterface	$name	Имя шаблона или экземпляр TemplateReferenceInterface
array	$parameters	Массив параметров для передачи шаблону

Возвращаемое значение

string

Отображенный шаблон в виде строки

Исключения

RuntimeException

если шаблон не может быть отображен

bool exists(string|TemplateReferenceInterface $name)

Возвращает true, если шаблон существует.

Параметры

string|TemplateReferenceInterface

$name

Имя шаблона или экземпляр TemplateReferenceInterface

Возвращаемое значение

bool	true, если шаблон существует, иначе false

Исключения

RuntimeException

если движок не может обработать имя шаблона

bool supports(string|TemplateReferenceInterface $name)

Возвращает true, если этот класс может отобразить указанный шаблон.

Параметры

string|TemplateReferenceInterface

$name

Имя шаблона или экземпляр TemplateReferenceInterface

Возвращаемое значение

bool	true, если этот класс поддерживает данный шаблон, иначе false

protected string|false evaluate(Storage $template, array $parameters = array())

Вычисляет шаблон.

Параметры

Storage	$template	Шаблон для отображения
array	$parameters	Массив параметров для передачи шаблону

Возвращаемое значение

string|false

Вычисленный шаблон или false, если движок не может отобразить шаблон

Исключения

InvalidArgumentException

HelperInterface offsetGet(string $name)

Получение значения помощника.

Параметры

string

$name

Имя помощника

Возвращаемое значение

HelperInterface

Значение помощника

Исключения

InvalidArgumentException

если помощник не определен

bool offsetExists(string $name)

Возвращает true, если помощник определен.

Параметры

string

$name

Имя помощника

Возвращаемое значение

bool	true, если помощник определен, иначе false

offsetSet(HelperInterface $name, string $value)

Установка помощника.

Параметры

HelperInterface	$name	Экземпляр помощника
string	$value	Псевдоним

offsetUnset(string $name)

Удаление помощника.

Параметры

string

$name

Имя помощника

Исключения

LogicException

addHelpers(array $helpers)

Добавление помощников.

Параметры

array

$helpers

Массив помощников

setHelpers(array $helpers)

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

Параметры

array

$helpers

Массив помощников

set(HelperInterface $helper, string $alias = null)

Установка помощника.

Параметры

HelperInterface	$helper	Экземпляр помощника
string	$alias	Псевдоним

bool has(string $name)

Возвращает true, если помощник определен.

Параметры

string

$name

Имя помощника

Возвращаемое значение

bool	true, если помощник определен, иначе false

HelperInterface get(string $name)

Получение значения помощника.

Параметры

string

$name

Имя помощника

Возвращаемое значение

HelperInterface

Экземпляр помощника

Исключения

InvalidArgumentException

если помощник не определен

extend(string $template)

Декорирует текущий шаблон другим шаблоном.

Параметры

string

$template

Логическое имя декоратора

string escape(mixed $value, string $context = 'html')

Экранирование строки с использованием текущей кодировки символов.

Параметры

mixed	$value	Переменная для экранирования
string	$context	Название контекста

Возвращаемое значение

string

Экранированное значение

setCharset(string $charset)

Устанавливает кодировку символов.

Параметры

string

$charset

Кодировка

string getCharset()

Возвращает текущую кодировку символов.

Возвращаемое значение

string

Текущая кодировка

setEscaper(string $context, callable $escaper)

Добавляет экранизатор для заданного контекста.

Параметры

string	$context	Контекст экранизатора (html, js, ...)
callable	$escaper	PHP-вызов

callable getEscaper(string $context)

Получает обёртку для заданного контекста.

Параметры

string

$context

Имя контекста

Возвращаемое значение

callable

$escaper PHP-вызов

Исключения

InvalidArgumentException

addGlobal(string $name, mixed $value)

Параметры

string	$name
mixed	$value

array getGlobals()

Возвращает назначенные глобальные переменные.

Возвращаемое значение

array

protected initializeEscapers()

Инициализирует встроенные обёртки.

Каждая функция определяет способ применения преобразования к строке, переданной ей. Цель состоит в том, чтобы строка была «обработана», чтобы она подходила для формата, в котором она отображается.

Например, строка: «Требуется ввести имя пользователя и пароль.\n» Если это должно отображаться как HTML, целесообразно преобразовать амперсанд в «&», а апостроф в «&aps;». Однако, если она будет использована как строка в JavaScript для отображения в окне alert, правильнее оставить строку как есть, но выполнить c-эскейп для апострофа и новой строки.

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

LoaderInterface getLoader()

Получает загрузчик, связанный с этим движком.

Возвращаемое значение

LoaderInterface

Экземпляр LoaderInterface

protected Storage load(string|TemplateReferenceInterface $name)

Загружает заданный шаблон.

Параметры

string|TemplateReferenceInterface

$name

Имя шаблона или экземпляр TemplateReferenceInterface

Возвращаемое значение

Storage

Экземпляр Storage

Исключения

InvalidArgumentException

если шаблон не найден

Response renderResponse(string $view, array $parameters = array(), Response $response = null)

Отображает представление и возвращает ответ.

Параметры

string	$view	Имя представления
array	$parameters	Массив параметров для передачи представлению
Response	$response	Экземпляр Response

Возвращаемое значение

Response

Экземпляр Response

Исключения

RuntimeException

если шаблон не может быть отображен