mirror of
https://github.com/smarty-php/smarty.git
synced 2025-08-05 02:44:27 +02:00
sync with EN
This commit is contained in:
@@ -1,25 +1,28 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: 1.6 Maintainer: didou Status: ready -->
|
||||
<!-- EN-Revision: 1.7 Maintainer: didou Status: ready -->
|
||||
|
||||
<sect1 id="caching.cacheable">
|
||||
<title>Contr<EFBFBD>ler la mise en cache des sorties des Plugins</title>
|
||||
<para>
|
||||
Depuis Smarty-2.6.0, la mise en cache des plugins peut <20>tre d<>clar<61>e lors
|
||||
de leur inscription. Les troisi<73>mes param<61>tres de register_block,
|
||||
register_compiler_function et register_function sont appel<65>s
|
||||
de leur inscription. Les troisi<73>mes param<61>tres de
|
||||
<link linkend="api.register.block">register_block()</link>,
|
||||
<link linkend="api.register.compiler.function">register_compiler_function()</link>
|
||||
et <link linkend="api.register.block">register_function()</link> sont appel<65>s
|
||||
<parameter>$cacheable</parameter> et valent true par d<>faut, ce qui est
|
||||
aussi le comportement par d<>faut des versions de Smarty pr<70>c<EFBFBD>dent la 2.6.0
|
||||
</para>
|
||||
|
||||
|
||||
<para>
|
||||
Lors de l'inscription d'un plugin avec $cacheable=false, le plugin est
|
||||
appel<65> <20> chaque fois que la page est affich<63>e, m<>me si la page vient du
|
||||
cache. La fonction plugin se comporte presque comme la fonction
|
||||
<link linkend="plugins.inserts">insert</link>.
|
||||
</para>
|
||||
|
||||
|
||||
<para>
|
||||
Contrairement <20> <link linkend="language.function.insert">{insert}</link>
|
||||
Contrairement <20> <link linkend="plugins.inserts">insert</link>
|
||||
les attributs pour le plugin ne sont pas mis en cache par d<>faut. Cel<65> peut
|
||||
<20>tre le cas en utilisant le quatri<72>me param<61>tre
|
||||
<parameter>$cache_attrs</parameter>. <parameter>$cache_attrs</parameter>
|
||||
@@ -27,7 +30,7 @@
|
||||
la fonction plugin re<72>oive les valeurs telles qu'elles <20>taient d<>finies lorsque
|
||||
la page a <20>t<EFBFBD> mise en cache, <20> chaque r<>cup<75>ration <20> partir du cache.
|
||||
</para>
|
||||
|
||||
|
||||
<example>
|
||||
<title>Eviter la mise en cache du r<>sultat d'un plugin</title>
|
||||
<programlisting role="php">
|
||||
@@ -73,7 +76,7 @@ Time Remaining: {remaining endtime=$obj->endtime}
|
||||
la page, mais pas lors des affichages ult<6C>rieurs de la page.
|
||||
</para>
|
||||
</example>
|
||||
|
||||
|
||||
<example>
|
||||
<title>Eviter la mise en cache d'une portion du template</title>
|
||||
<programlisting role="php">
|
||||
@@ -109,16 +112,16 @@ Now is: {"0"|date_format:"%D %H:%M:%S"}
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
|
||||
|
||||
<para>
|
||||
Lors du rechargement de la page, vous remarquerez que les deux dates sont
|
||||
diff<66>rentes. L'une est "dynamique" et l'autre est "statique". Vous pouvez
|
||||
faire ce que vous voulez entre {dynamic}...{/dynamic} et <20>tre s<>rs que
|
||||
cel<65> ne sera pas mis en cache comme le reste de la page.
|
||||
</para>
|
||||
|
||||
|
||||
</sect1>
|
||||
|
||||
|
||||
<!-- Keep this comment at the end of the file
|
||||
Local variables:
|
||||
mode: sgml
|
||||
@@ -138,4 +141,4 @@ Now is: {"0"|date_format:"%D %H:%M:%S"}
|
||||
vim600: syn=xml fen fdm=syntax fdl=2 si
|
||||
vim: et tw=78 syn=sgml
|
||||
vi: ts=1 sw=1
|
||||
-->
|
||||
-->
|
@@ -1,6 +1,7 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready -->
|
||||
<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready -->
|
||||
|
||||
<sect1 id="caching.groups">
|
||||
<title>Groupes de fichiers de cache</title>
|
||||
<para>
|
||||
@@ -45,18 +46,19 @@ $smarty->caching = true;
|
||||
|
||||
// efface tous les fichiers de cache avec "sports|basketball" comme premiers
|
||||
// groupes d'identifiants de cache
|
||||
$smarty->clear_cache(null,"sports|basketball");
|
||||
$smarty->clear_cache(null,'sports|basketball');
|
||||
|
||||
// efface tous les fichiers de cache "sports" comme premier groupe d'identifiants.
|
||||
// Inclue donc "sports|basketball" ou "sports|nimportequoi|nimportequoi|..."
|
||||
$smarty->clear_cache(null,"sports");
|
||||
$smarty->clear_cache(null,'sports');
|
||||
|
||||
$smarty->display('index.tpl',"sports|basketball");
|
||||
$smarty->display('index.tpl','sports|basketball');
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
</sect1>
|
||||
|
||||
<!-- Keep this comment at the end of the file
|
||||
Local variables:
|
||||
mode: sgml
|
||||
@@ -76,4 +78,4 @@ End:
|
||||
vim600: syn=xml fen fdm=syntax fdl=2 si
|
||||
vim: et tw=78 syn=sgml
|
||||
vi: ts=1 sw=1
|
||||
-->
|
||||
-->
|
@@ -1,16 +1,17 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: 1.2 Maintainer: didou Status: ready -->
|
||||
<!-- EN-Revision: 1.3 Maintainer: didou Status: ready -->
|
||||
|
||||
<sect1 id="caching.multiple.caches">
|
||||
<title>Caches multiples pour une seule page</title>
|
||||
<para>
|
||||
Vous pouvez avoir plusieurs fichiers de caches pour un m<>me appel
|
||||
aux fonctions display() ou fetch(). Imaginons qu'un appel a
|
||||
display('index.tpl') puisse avoir plusieurs r<>sultats, en fonction de
|
||||
certaines conditions, et que
|
||||
vous vouliez des fichiers de cache s<>par<61>s pour chacun d'eux. Vous
|
||||
pouvez faire cel<65> en passant un identifiant de cache (cache_id) en
|
||||
deuxi<78>me param<61>tre a l'appel de fonction.
|
||||
aux fonctions <link linkend="api.display">display()</link> ou
|
||||
<link linkend="api.fetch">fetch()</link>. Imaginons qu'un appel a
|
||||
display('index.tpl') puisse avoir plusieurs r<>sultats, en fonction de
|
||||
certaines conditions, et que vous vouliez des fichiers de cache s<>par<61>s
|
||||
pour chacun d'eux. Vous pouvez faire cel<65> en passant un identifiant de
|
||||
cache (cache_id) en deuxi<EFBFBD>me param<61>tre a l'appel de fonction.
|
||||
</para>
|
||||
<example>
|
||||
<title>Passage d'un cache_id a display()</title>
|
||||
@@ -28,7 +29,8 @@ $smarty->display('index.tpl',$my_cache_id);
|
||||
</programlisting>
|
||||
</example>
|
||||
<para>
|
||||
Nous passons ci-dessus la variable $my_cache_id a display() comme
|
||||
Nous passons ci-dessus la variable $my_cache_id a
|
||||
<link linkend="api.display">display()</link> comme
|
||||
identifiant de cache. Pour chaque valeur distincte de $my_cache_id,
|
||||
un fichier de cache distinct va <20>tre cr<63><72>. Dans cet exemple,
|
||||
"article_id" a <20>t<EFBFBD> pass<73> dans l'URL et est utilis<69> en tant qu'identifiant
|
||||
@@ -80,7 +82,7 @@ $smarty->display('index.tpl',$my_cache_id);
|
||||
<para>
|
||||
Vous pouvez effacer tous les fichiers de cache pour un identifiant
|
||||
de cache particulier en passant null en tant que premier param<61>tre
|
||||
<20> clear_cache().
|
||||
<20> <link linkend="api.clear.cache">clear_cache()</link>.
|
||||
</para>
|
||||
<example>
|
||||
<title>Effacement de tous les fichiers de cache pour un identifiant de cache particulier</title>
|
||||
@@ -103,6 +105,7 @@ $smarty->display('index.tpl',"sports");
|
||||
donnant le m<>me identifiant.
|
||||
</para>
|
||||
</sect1>
|
||||
|
||||
<!-- Keep this comment at the end of the file
|
||||
Local variables:
|
||||
mode: sgml
|
||||
@@ -122,4 +125,4 @@ End:
|
||||
vim600: syn=xml fen fdm=syntax fdl=2 si
|
||||
vim: et tw=78 syn=sgml
|
||||
vi: ts=1 sw=1
|
||||
-->
|
||||
-->
|
@@ -1,10 +1,11 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!-- $Revision$ -->
|
||||
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
|
||||
<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready -->
|
||||
|
||||
<sect1 id="caching.setting.up">
|
||||
<title>Param<EFBFBD>trer le cache</title>
|
||||
<para>
|
||||
La premi<6D>re chose <20> faire est d'activer le cache. Cel<65> est fait en
|
||||
La premi<6D>re chose <20> faire est d'activer le cache en
|
||||
mettant <link linkend="variable.caching">$caching</link> = true
|
||||
(ou 1).
|
||||
</para>
|
||||
@@ -34,7 +35,8 @@ $smarty->display('index.tpl');
|
||||
<note>
|
||||
<title>Note technique</title>
|
||||
<para>
|
||||
Les fichiers situ<74>s dans $cache_dir sont nomm<6D>s de la m<>me fa<66>on que les templates.
|
||||
Les fichiers situ<74>s dans <link linkend="variable.cache.dir">$cache_dir</link>
|
||||
sont nomm<6D>s de la m<>me fa<66>on que les templates.
|
||||
Bien qu'ils aient une extension ".php", ils ne sont pas vraiment ex<65>cutable.
|
||||
N'<27>ditez surtout pas ces fichiers !
|
||||
</para>
|
||||
@@ -45,13 +47,13 @@ $smarty->display('index.tpl');
|
||||
d<>faut est 3600 secondes, i.e. 1 heure. Une fois que cette dur<75>e est
|
||||
d<>pass<73>e, le cache est reg<65>n<EFBFBD>r<EFBFBD>. Il est possible de donner
|
||||
une dur<75>e d'expiration propre <20> chaque fichier de cache en r<>glant
|
||||
$caching = 2.
|
||||
<link linkend="variable.caching">$caching</link> = 2.
|
||||
Se reporter <20> la documentation de <link
|
||||
linkend="variable.cache.lifetime">$cache_lifetime</link> pour plus de
|
||||
d<>tails.
|
||||
</para>
|
||||
<example>
|
||||
<title>R<EFBFBD>glage individuel de cache_lifetime</title>
|
||||
<title>R<EFBFBD>glage individuel de $cache_lifetime</title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
@@ -106,7 +108,8 @@ $smarty->display('index.tpl');
|
||||
<para>
|
||||
Si <link linkend="variable.force.compile">$force_compile</link> est actif,
|
||||
les fichiers de cache sont toujours reg<65>n<EFBFBD>r<EFBFBD>s. Ceci revient finalement <20>
|
||||
d<>sactiver le cache. $force_compile est utilis<69> <20> des fins de d<>bogage,
|
||||
d<>sactiver le cache. <link linkend="variable.force.compile">$force_compile</link>
|
||||
est utilis<69> <20> des fins de <link linkend="chapter.debugging.console">d<EFBFBD>bogage</link>,
|
||||
un moyen plus efficace de d<>sactiver le cache est de r<>gler
|
||||
<link linkend="variable.caching">$caching</link> = false (ou 0).
|
||||
</para>
|
||||
@@ -141,19 +144,20 @@ $smarty->display('index.tpl');
|
||||
<para>
|
||||
Vous pouvez rendre dynamiques seulement certaines parties d'une
|
||||
page avec la fonction de template <link
|
||||
linkend="language.function.insert">insert</link>.
|
||||
linkend="language.function.insert">{insert}</link>.
|
||||
Imaginons que toute une page doit <20>tre mise en cache <20> part
|
||||
une banni<6E>re en bas <20> droite. En utilisant une fonction insert pour la
|
||||
une banni<6E>re en bas <20> droite. En utilisant une fonction
|
||||
<link linkend="language.function.insert">{insert}</link> pour la
|
||||
banni<6E>re, vous pouvez garder cet <20>l<EFBFBD>ment dynamique dans le contenu qui
|
||||
est en cache. Reportez-vous <20> la documentation
|
||||
<link linkend="language.function.insert">insert</link> pour plus de d<>tails
|
||||
<link linkend="language.function.insert">{insert}</link> pour plus de d<>tails
|
||||
ainsi que des exemples.
|
||||
</para>
|
||||
<para>
|
||||
Vous pouvez effacer tous les fichiers du cache avec la fonction <link
|
||||
linkend="api.clear.all.cache">clear_all_cache()</link>, ou de fa<66>on
|
||||
individuelle (ou par groupe) avec la fonction <link
|
||||
linkend="api.clear.cache">clear_cache()</link>.
|
||||
individuelle <link linkend="caching.groups">(ou par groupe)</link>
|
||||
avec la fonction <link linkend="api.clear.cache">clear_cache()</link>.
|
||||
</para>
|
||||
<example>
|
||||
<title>Nettoyage du cache</title>
|
||||
@@ -177,23 +181,24 @@ $smarty->display('index.tpl');
|
||||
</programlisting>
|
||||
</example>
|
||||
</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
|
||||
-->
|
||||
|
||||
<!-- 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
|
||||
-->
|
Reference in New Issue
Block a user