Плагины ресурсов описывают источники данных, из которых берется исходный код шаблона или компоненты 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)
{
// не используется для шаблонов
}
?>