Ressources
Les plugins ressources sont un moyen générique de fournir des sources
de templates ou des composants de scripts PHP a Smarty. Quelques exemples
de ressources : bases de données, LDAP, mémoire partagée, sockets, et ainsi
de suite.
Il y au total 4 fonctions qui ont besoin d'être enregistrées pour
chaque type de ressource. Chaque fonction retoit le nom de la ressource demandée
comme premier paramétre et l'objet Smarty comme dernier paramétre.
Les autres paramétres dépendent de la fonction.
bool smarty_resource_name_sourcestring $rsrc_namestring &$sourceobject &$smartybool smarty_resource_name_timestampstring $rsrc_nameint &$timestampobject &$smartybool smarty_resource_name_securestring $rsrc_nameobject &$smartybool smarty_resource_name_trustedstring $rsrc_nameobject &$smarty
La premiére fonction est supposée récupérer la ressource. Son second
paramétre est une variable passée par référence oú le résultat doit être
stocké. La fonction est supposée retourner true si
elle réussi a récupérer la ressource et false sinon.
La seconde fonction est supposée récupérer la date de derniére modification
de la ressource demandée (comme un timestamp UNIX). Le second paramétre
est une variable passée par référence dans laquelle la date doit
être stockée. La fonction est supposée renvoyer true si elle
a réussi a récupérer la date et false sinon.
La troisiéme fonction est supposée retourner true
ou false selon si la ressource demandée est svre
ou non. La fonction est utilisée seulement pour les ressources templates
mais doit tout de même être définie.
La quatriéme fonction est supposée retourner true
ou false selon si on peut faire confiance ou
non a la ressource demandée. Cette fonction est utilisée seulement
pour les composants de scripts PHP demandés par les balises
include_php ou insert
ayant un attribut src. Quoiqu'il en soit,
elle doit être définie pour les ressources templates.
Regardez aussi
register_resource(),
unregister_resource().
resource plugin
<?php
/*
* Smarty plugin
* -------------------------------------------------------------
* Fichier : resource.db.php
* Type : ressource
* Nom : db
* Rôle : Récupére des templates depuis une base de données
* -------------------------------------------------------------
*/
function smarty_resource_db_source($tpl_name, &$tpl_source, &$smarty)
{
// fait des requêtes BD pour récupérer votre template
// et remplir $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)
{
// fait des requêtes BD pour remplir $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)
{
// suppose que tous les templates sont svrs
return true;
}
function smarty_resource_db_trusted($tpl_name, &$smarty)
{
// inutilisée pour les templates
}
?>