What is Smarty?
Why use it?
Use Cases and Work Flow
Syntax Comparison
Template Inheritance
Best Practices
Crash Course
You may use the Smarty logo according to the trademark notice.
For sponsorship, advertising, news or other inquiries, contact us at:
Плагины ресурсов описывают источники данных, из которых берется исходный код шаблона или компоненты PHP-скрипта для Smarty. Вот примеры ресурсов: базы данных, LDAP, разделяемая память (shared memory), сокеты, и прочее.
Необходимо 4 функции для того, чтобы зарегестрировать каждый тип ресурса. Каждая такая функция получает запрашиваемый ресурс в качестве первого параметра и объект Smarty как последний параметр. Остальные параметры зависят от функции.
bool smarty_resource_name_source( |
$rsrc_name, | |
&$source, | ||
&$smarty) ; |
string $rsrc_name
;string &$source
;object &$smarty
;bool smarty_resource_name_timestamp( |
$rsrc_name, | |
&$timestamp, | ||
&$smarty) ; |
string $rsrc_name
;int &$timestamp
;object &$smarty
;bool smarty_resource_name_secure( |
$rsrc_name, | |
&$smarty) ; |
string $rsrc_name
;object &$smarty
;bool smarty_resource_name_trusted( |
$rsrc_name, | |
&$smarty) ; |
string $rsrc_name
;object &$smarty
;
Первая функция получает ресурс. Ее первый
параметр, это переменная, переданная по ссылке. В нее будет сохранен результат.
Функция вернет true
если
сможет удачно получить ресурс и
false
в ином случае.
Вторая функция получает время последней модификации
запрошенного ресурса (в виде UNIX timestamp). Второй параметр
представляет собой переменную, переданную по ссылке, в которой и будет сохранено время.
Функция вернет true
если
timestamp будет определен в правильной форме, и false
в ином случае.
Третья функция возвращает true
или
false
в зависимости от того, является ли
запрашиваемый ресурс безопасным. Эта функция используется только для ресурсов шаблона, но
в любом случае должна быть определена.
Четвертая функция возвращает true
или
false
в зависимости от того, заслуживает ли запрашиваемый ресурс доверия
(is trusted) или нет. Эта функция используется только для компонентов PHP-скрипта,
запрошенных тэгом include_php или
insert с src
атрибутом. Тем не менее, она должна объявляться даже для ресурсов шаблона.
Смотрите также: register_resource(), unregister_resource().
Example 16.10. Плагин ресурса
<?php /* * Smarty plugin * ------------------------------------------------------------- * Файл: resource.db.php * Тип: resource * Имя: db * Назначение: Получает шаблон из базы данных * ------------------------------------------------------------- */ function smarty_resource_db_source($tpl_name, &$tpl_source, &$smarty) { // выполняем обращение к базе данных для получения шаблона // и занесения полученного результата в в $tpl_source $sql = new SQL; $sql->query("select tpl_source from my_table where tpl_name='$tpl_name'"); if ($sql->num_rows) { $tpl_source = $sql->record['tpl_source']; return true; } else { return false; } } function smarty_resource_db_timestamp($tpl_name, &$tpl_timestamp, &$smarty) { // выполняем обращение к базе данных для присвоения значения $tpl_timestamp. $sql = new SQL; $sql->query("select tpl_timestamp from my_table where tpl_name='$tpl_name'"); if ($sql->num_rows) { $tpl_timestamp = $sql->record['tpl_timestamp']; return true; } else { return false; } } function smarty_resource_db_secure($tpl_name, &$smarty) { // предполагаем, что шаблоны безопасны return true; } function smarty_resource_db_trusted($tpl_name, &$smarty) { // не используется для шаблонов } ?>