mirror of
https://github.com/smarty-php/smarty.git
synced 2025-10-30 20:01:37 +01:00
95 lines
2.9 KiB
XML
95 lines
2.9 KiB
XML
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
<!-- $Revision$ -->
|
|
<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready -->
|
|
|
|
<sect1 id="plugins.compiler.functions">
|
|
<title>Fonctions de compilation</title>
|
|
<para>
|
|
Les fonctions de compilation sont appelées durant la compilation du template.
|
|
Elles sont utiles pour injecter du code PHP ou du contenu "statique variant
|
|
avec le temps" (bandeau de pub par ex.). Si une fonction de compilation et
|
|
une <link linkend="language.custom.functions">fonction personnalisée</link>
|
|
ont le même nom, la fonction de compilation a priorité.
|
|
</para>
|
|
<funcsynopsis>
|
|
<funcprototype>
|
|
<funcdef>mixed <function>smarty_compiler_<replaceable>name</replaceable></function></funcdef>
|
|
<paramdef>string <parameter>$tag_arg</parameter></paramdef>
|
|
<paramdef>object <parameter>&$smarty</parameter></paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
<para>
|
|
Les fonctions de compilation ont deux paramètres : une chaîne contenant
|
|
la balise - en gros, tout, depuis le nom de la fonction jusqu'au délimiteur de fin - et
|
|
l'objet Smarty. Elles sont censées retourner le code PHP qui doit être
|
|
injecté dans le template compilé.
|
|
</para>
|
|
<example>
|
|
<title>Fonction de compilation simple</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
/*
|
|
* Smarty plugin
|
|
* -------------------------------------------------------------
|
|
* Fichier : compiler.tplheader.php
|
|
* Type : compilation
|
|
* Nom : tplheader
|
|
* Rôle : Renvoie l'en-tête contenant le nom du fichier
|
|
* source et le temps de compilation.
|
|
* -------------------------------------------------------------
|
|
*/
|
|
function smarty_compiler_tplheader($tag_arg, &$smarty)
|
|
{
|
|
return "\necho '" . $smarty->_current_file . " compiled at " . date('Y-m-d H:M'). "';";
|
|
}
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
<para>
|
|
Cette fonction peut-être appelée depuis le template comme suivant :
|
|
</para>
|
|
<programlisting>
|
|
<![CDATA[
|
|
{* cette fonction n'est executée que lors de la compilation *}
|
|
{tplheader}
|
|
]]>
|
|
</programlisting>
|
|
<para>
|
|
Le code PHP résultant dans les templates compilés ressemblerait à ça :
|
|
</para>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
echo 'index.tpl compiled at 2002-02-20 20:02';
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
<para>
|
|
Voir aussi :
|
|
<link linkend="api.register.compiler.function"><varname>register_compiler_function()</varname></link> et
|
|
<link linkend="api.unregister.compiler.function"><varname>unregister_compiler_function()</varname></link>.
|
|
</para>
|
|
</sect1>
|
|
<!-- Keep this comment at the end of the file
|
|
Local variables:
|
|
mode: sgml
|
|
sgml-omittag:t
|
|
sgml-shorttag:t
|
|
sgml-minimize-attributes:nil
|
|
sgml-always-quote-attributes:t
|
|
sgml-indent-step:1
|
|
sgml-indent-data:t
|
|
indent-tabs-mode:nil
|
|
sgml-parent-document:nil
|
|
sgml-default-dtd-file:"../../../../manual.ced"
|
|
sgml-exposed-tags:nil
|
|
sgml-local-catalogs:nil
|
|
sgml-local-ecat-files:nil
|
|
End:
|
|
vim600: syn=xml fen fdm=syntax fdl=2 si
|
|
vim: et tw=78 syn=sgml
|
|
vi: ts=1 sw=1
|
|
-->
|