mercredi 24 septembre 2008
HTML_Template_Sigma
Dans la rubrique PHP / PEAR
Ce cours d'instruction est au sujet de HTML_Template_Sigma de la poire et comment l'employer.
Table des matières :
- Introduction à HTML_Template_Sigma
- Installation de HTML_Template_Sigma
- Utilisation de HTML_Template_Sigma
1. Introduction à HTML_Template_Sigma
HTML_Template_Sigma est un paquet de PEAR, un moteur templating très bien fourni.
Les moteurs de Templating ont le but de séparer le HTML du PHP dans vos fichiers PHP.
Ceci maintient le code propre et lisible.
Ceci vous permet également d'éditer facilement le HTML sans devoir passer en revue par tous le contenu de vos fichiers PHP à la recherche du code de HTML.
HTML_Template_Sigma a beaucoup de fonctionnalités, comme des variables de remplacement, des boucles et encore beaucoup d'autres.
2. Installation de HTML_Template_Sigma
HTML_Template_Sigma peut être installé de beaucoup de différentes manières. La manière la plus facile est le gestionnaire de paquet de PEAR.
(L'accès root est requis ) Cela nécéssite que la dernière version du manager de paquet de PEAR soit installé.
Installation automatique :
Allez dans le shell et executez:
$ pear install <package>
Remplacez par le nom du paquet que vous souhaitez installer.
Le gestionnaire de paquet de PEAR télécharge et installe alors le paquet indiqué.
Installation semi-automatique :
Une autre manière d'installer un paquet hors connection est de placer paquet dans le répertoire de PEAR.
Executez alors la commande suivante :
$ pear install <file>.tgz
Ceci installe le paquet (téléchargé en .tgz) sans devoir avoir une connexion internet.
Installation manuelle :
Pour installer le paquet manuellement, mettez le paquet dans /includes/
Employez le code suivant pour dire à PHP où rechercher le paquet :
<?php ini_set ('include_path', '/var/www/ www.example.com/includes/'. PATH_SEPARATOR. ini_get ('include_path')); ?>
Maintenant nous avons placé notre include_path, nous pouvons simplement faire un require() de notre paquet comme ceci :
<?php require_once 'HTML/Template/Sigma.php' ; ?>
Après l'installation de HTML_Template_Sigma, lu ci-dessus voyons la façon de l'utiliser.
3. Utilisation de HTML_Template_Sigma
Dans cette étape du tuto on verra l'utilisation de base de HTML_Template_Sigma.
Nous examinerons :
- L'attribution des variables de remplacement
- L'utilisation de boucles
- afficher ou retourner le rendu du template ?
''Les fichiers template Les fichiers gabarit sont habituellement placés dans ./templates/ ou ./skin/, mais cela n'importe pas vraiment.
Ci-dessous vous trouverez un exemple de template:
[html]
<html>
<table border>
<!-- BEGIN row -->
<tr>
<!-- BEGIN cell -->
<td>
{DONNEES}
</td>
<!-- END cell -->
</tr>
<!-- END row -->
</table>
</html>
cela représente le commencement d'une boucle.
Chaque fois que cette boucle est analysée, elle analysera ceci.
Vous devez finir chaque boucle avec (remplacez par le nom de votre boucle)
{DONNEES} est une variable de remplacement.
En assignant une variable dans votre fichier PHP, vous pouvez l'employer aimez ceci.
Regardons maintenant notre dossier de PHP : (L'exemple de HTML_Template_Sigma qui est venu avec le paquet)
[php]
<?php
require_once "HTML/Template/Sigma.php";
$data = array (
"0" => array("Stig", "Bakken"),
"1" => array("Martin", "Jansen"),
"2" => array("Alexander", "Merz")
);
$tpl = new HTML_Template_Sigma("./templates");
$tpl->loadTemplatefile("main.tpl.htm", true, true);
foreach($data as $name)
{
foreach($name as $cell)
{
// Assign data to the inner block
$tpl->setCurrentBlock("cell");
$tpl->setVariable("DATA", $cell);
$tpl->parseCurrentBlock("cell");
}
// Assign data and the inner block to the
// outer block
$tpl->setCurrentBlock("row");
$tpl->parseCurrentBlock("row");
}
// print the output
$tpl->show();
?>
J'expliquerai maintenant le code au-dessus du peu par le peu, ainsi vous aurez une idée pourquoi et comment elle est employée. require_once « HTML/Template/Sigma.php » ;
Sans ceci, le sujet d'ensemble ne fonctionnera pas.
Nous devons avoir besoin du paquet de POIRE.
[php]
$data = array (
"0" => array("Stig", "Bakken"),
"1" => array("Martin", "Jansen"),
"2" => array("Alexander", "Merz")
);
Assignez un choix de données.
Nous faisons une boucle par ceci plus tard.
$tpl = nouveau HTML_Template_Sigma (« . /templates ») ; Ceci lance la classe de HTML_Template_Sigma et place le chemin aux calibres. $tpl->loadTemplatefile (« main.tpl.htm », vrai, vrai) ; Chargez un fichier gabarit appelé main.tpl.htm. foreach ($data comme $name) { foreach ($name comme $cell) { // assignent des données au bloc intérieur $tpl->setCurrentBlock (« cellule ») ; $tpl->setVariable (« DONNÉES », $cell) ; $tpl->parseCurrentBlock (« cellule ») ; } // assignent les données et le bloc intérieur au bloc externe de // $tpl->setCurrentBlock (« rangée ») ; $tpl->parseCurrentBlock (« rangée ») ; }
Nous faisons une boucle par les données, assignons les variables utilisant setVariable et analysons des blocs de boucle utilisant le setCurrentBlock () et le parseCurrentBlock (). copie de
[php] // le rendement $tpl->show () ;
Ceci produit le calibre à l'écran. Si vous voulez renvoyer le calibre à la place, employez :
[php] $template = $tpl->set();
J'espère que vous avez appris beaucoup de PEAR et HTML_Template_sigma en lisant ce cours d'instruction.
Soyez sûr d'employer HTML_Template_Sigma dans vos propres projets !
3
-
