sync with EN

This commit is contained in:
yannick
2005-11-28 21:38:36 +00:00
parent 226db43853
commit 12041ebeac
4 changed files with 71 additions and 58 deletions

View File

@@ -1,25 +1,28 @@
<?xml version="1.0" encoding="iso-8859-1"?> <?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ --> <!-- $Revision$ -->
<!-- EN-Revision: 1.6 Maintainer: didou Status: ready --> <!-- EN-Revision: 1.7 Maintainer: didou Status: ready -->
<sect1 id="caching.cacheable"> <sect1 id="caching.cacheable">
<title>Contr<EFBFBD>ler la mise en cache des sorties des Plugins</title> <title>Contr<EFBFBD>ler la mise en cache des sorties des Plugins</title>
<para> <para>
Depuis Smarty-2.6.0, la mise en cache des plugins peut <20>tre d<>clar<61>e lors 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, de leur inscription. Les troisi<73>mes param<61>tres de
register_compiler_function et register_function sont appel<65>s <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 <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 aussi le comportement par d<>faut des versions de Smarty pr<70>c<EFBFBD>dent la 2.6.0
</para> </para>
<para> <para>
Lors de l'inscription d'un plugin avec $cacheable=false, le plugin est 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 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 cache. La fonction plugin se comporte presque comme la fonction
<link linkend="plugins.inserts">insert</link>. <link linkend="plugins.inserts">insert</link>.
</para> </para>
<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 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 <20>tre le cas en utilisant le quatri<72>me param<61>tre
<parameter>$cache_attrs</parameter>. <parameter>$cache_attrs</parameter> <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 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. la page a <20>t<EFBFBD> mise en cache, <20> chaque r<>cup<75>ration <20> partir du cache.
</para> </para>
<example> <example>
<title>Eviter la mise en cache du r<>sultat d'un plugin</title> <title>Eviter la mise en cache du r<>sultat d'un plugin</title>
<programlisting role="php"> <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. la page, mais pas lors des affichages ult<6C>rieurs de la page.
</para> </para>
</example> </example>
<example> <example>
<title>Eviter la mise en cache d'une portion du template</title> <title>Eviter la mise en cache d'une portion du template</title>
<programlisting role="php"> <programlisting role="php">
@@ -109,16 +112,16 @@ Now is: {"0"|date_format:"%D %H:%M:%S"}
]]> ]]>
</programlisting> </programlisting>
</example> </example>
<para> <para>
Lors du rechargement de la page, vous remarquerez que les deux dates sont 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 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 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. cel<65> ne sera pas mis en cache comme le reste de la page.
</para> </para>
</sect1> </sect1>
<!-- Keep this comment at the end of the file <!-- Keep this comment at the end of the file
Local variables: Local variables:
mode: sgml mode: sgml
@@ -138,4 +141,4 @@ Now is: {"0"|date_format:"%D %H:%M:%S"}
vim600: syn=xml fen fdm=syntax fdl=2 si vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml vim: et tw=78 syn=sgml
vi: ts=1 sw=1 vi: ts=1 sw=1
--> -->

View File

@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="iso-8859-1"?> <?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ --> <!-- $Revision$ -->
<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> <!-- EN-Revision: 1.4 Maintainer: yannick Status: ready -->
<sect1 id="caching.groups"> <sect1 id="caching.groups">
<title>Groupes de fichiers de cache</title> <title>Groupes de fichiers de cache</title>
<para> <para>
@@ -45,18 +46,19 @@ $smarty->caching = true;
// efface tous les fichiers de cache avec "sports|basketball" comme premiers // efface tous les fichiers de cache avec "sports|basketball" comme premiers
// groupes d'identifiants de cache // 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. // efface tous les fichiers de cache "sports" comme premier groupe d'identifiants.
// Inclue donc "sports|basketball" ou "sports|nimportequoi|nimportequoi|..." // 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> </programlisting>
</example> </example>
</sect1> </sect1>
<!-- Keep this comment at the end of the file <!-- Keep this comment at the end of the file
Local variables: Local variables:
mode: sgml mode: sgml
@@ -76,4 +78,4 @@ End:
vim600: syn=xml fen fdm=syntax fdl=2 si vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml vim: et tw=78 syn=sgml
vi: ts=1 sw=1 vi: ts=1 sw=1
--> -->

View File

@@ -1,16 +1,17 @@
<?xml version="1.0" encoding="iso-8859-1"?> <?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ --> <!-- $Revision$ -->
<!-- EN-Revision: 1.2 Maintainer: didou Status: ready --> <!-- EN-Revision: 1.3 Maintainer: didou Status: ready -->
<sect1 id="caching.multiple.caches"> <sect1 id="caching.multiple.caches">
<title>Caches multiples pour une seule page</title> <title>Caches multiples pour une seule page</title>
<para> <para>
Vous pouvez avoir plusieurs fichiers de caches pour un m<>me appel Vous pouvez avoir plusieurs fichiers de caches pour un m<>me appel
aux fonctions display() ou fetch(). Imaginons qu'un appel a aux fonctions <link linkend="api.display">display()</link> ou
display('index.tpl') puisse avoir plusieurs r<>sultats, en fonction de <link linkend="api.fetch">fetch()</link>. Imaginons qu'un appel a
certaines conditions, et que display('index.tpl') puisse avoir plusieurs r<>sultats, en fonction de
vous vouliez des fichiers de cache s<>par<61>s pour chacun d'eux. Vous certaines conditions, et que vous vouliez des fichiers de cache s<>par<61>s
pouvez faire cel<65> en passant un identifiant de cache (cache_id) en pour chacun d'eux. Vous pouvez faire cel<65> en passant un identifiant de
deuxi<78>me param<61>tre a l'appel de fonction. cache (cache_id) en deuxi<EFBFBD>me param<61>tre a l'appel de fonction.
</para> </para>
<example> <example>
<title>Passage d'un cache_id a display()</title> <title>Passage d'un cache_id a display()</title>
@@ -28,7 +29,8 @@ $smarty->display('index.tpl',$my_cache_id);
</programlisting> </programlisting>
</example> </example>
<para> <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, 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, 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 "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> <para>
Vous pouvez effacer tous les fichiers de cache pour un identifiant Vous pouvez effacer tous les fichiers de cache pour un identifiant
de cache particulier en passant null en tant que premier param<61>tre 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> </para>
<example> <example>
<title>Effacement de tous les fichiers de cache pour un identifiant de cache particulier</title> <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. donnant le m<>me identifiant.
</para> </para>
</sect1> </sect1>
<!-- Keep this comment at the end of the file <!-- Keep this comment at the end of the file
Local variables: Local variables:
mode: sgml mode: sgml
@@ -122,4 +125,4 @@ End:
vim600: syn=xml fen fdm=syntax fdl=2 si vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml vim: et tw=78 syn=sgml
vi: ts=1 sw=1 vi: ts=1 sw=1
--> -->

View File

@@ -1,10 +1,11 @@
<?xml version="1.0" encoding="iso-8859-1"?> <?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ --> <!-- $Revision$ -->
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> <!-- EN-Revision: 1.5 Maintainer: yannick Status: ready -->
<sect1 id="caching.setting.up"> <sect1 id="caching.setting.up">
<title>Param<EFBFBD>trer le cache</title> <title>Param<EFBFBD>trer le cache</title>
<para> <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 mettant <link linkend="variable.caching">$caching</link> = true
(ou 1). (ou 1).
</para> </para>
@@ -34,7 +35,8 @@ $smarty->display('index.tpl');
<note> <note>
<title>Note technique</title> <title>Note technique</title>
<para> <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. Bien qu'ils aient une extension ".php", ils ne sont pas vraiment ex<65>cutable.
N'<27>ditez surtout pas ces fichiers ! N'<27>ditez surtout pas ces fichiers !
</para> </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<>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 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 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 Se reporter <20> la documentation de <link
linkend="variable.cache.lifetime">$cache_lifetime</link> pour plus de linkend="variable.cache.lifetime">$cache_lifetime</link> pour plus de
d<>tails. d<>tails.
</para> </para>
<example> <example>
<title>R<EFBFBD>glage individuel de cache_lifetime</title> <title>R<EFBFBD>glage individuel de $cache_lifetime</title>
<programlisting role="php"> <programlisting role="php">
<![CDATA[ <![CDATA[
<?php <?php
@@ -106,7 +108,8 @@ $smarty->display('index.tpl');
<para> <para>
Si <link linkend="variable.force.compile">$force_compile</link> est actif, 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> 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 un moyen plus efficace de d<>sactiver le cache est de r<>gler
<link linkend="variable.caching">$caching</link> = false (ou 0). <link linkend="variable.caching">$caching</link> = false (ou 0).
</para> </para>
@@ -141,19 +144,20 @@ $smarty->display('index.tpl');
<para> <para>
Vous pouvez rendre dynamiques seulement certaines parties d'une Vous pouvez rendre dynamiques seulement certaines parties d'une
page avec la fonction de template <link 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 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 banni<6E>re, vous pouvez garder cet <20>l<EFBFBD>ment dynamique dans le contenu qui
est en cache. Reportez-vous <20> la documentation 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. ainsi que des exemples.
</para> </para>
<para> <para>
Vous pouvez effacer tous les fichiers du cache avec la fonction <link 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 linkend="api.clear.all.cache">clear_all_cache()</link>, ou de fa<66>on
individuelle (ou par groupe) avec la fonction <link individuelle <link linkend="caching.groups">(ou par groupe)</link>
linkend="api.clear.cache">clear_cache()</link>. avec la fonction <link linkend="api.clear.cache">clear_cache()</link>.
</para> </para>
<example> <example>
<title>Nettoyage du cache</title> <title>Nettoyage du cache</title>
@@ -177,23 +181,24 @@ $smarty->display('index.tpl');
</programlisting> </programlisting>
</example> </example>
</sect1> </sect1>
<!-- Keep this comment at the end of the file
Local variables: <!-- Keep this comment at the end of the file
mode: sgml Local variables:
sgml-omittag:t mode: sgml
sgml-shorttag:t sgml-omittag:t
sgml-minimize-attributes:nil sgml-shorttag:t
sgml-always-quote-attributes:t sgml-minimize-attributes:nil
sgml-indent-step:1 sgml-always-quote-attributes:t
sgml-indent-data:t sgml-indent-step:1
indent-tabs-mode:nil sgml-indent-data:t
sgml-parent-document:nil indent-tabs-mode:nil
sgml-default-dtd-file:"../../../../manual.ced" sgml-parent-document:nil
sgml-exposed-tags:nil sgml-default-dtd-file:"../../../../manual.ced"
sgml-local-catalogs:nil sgml-exposed-tags:nil
sgml-local-ecat-files:nil sgml-local-catalogs:nil
End: sgml-local-ecat-files:nil
vim600: syn=xml fen fdm=syntax fdl=2 si End:
vim: et tw=78 syn=sgml vim600: syn=xml fen fdm=syntax fdl=2 si
vi: ts=1 sw=1 vim: et tw=78 syn=sgml
--> vi: ts=1 sw=1
-->