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"?>
<!-- $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
-->
-->

View File

@@ -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
-->
-->

View File

@@ -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
-->
-->

View File

@@ -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
-->