smarty/docs/fr/programmers/caching/caching-setting-up.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.8 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 en
  mettant 
  <link linkend="variable.caching"><parameter>$caching</parameter></link>
  <literal> = 1 (ou 2)</literal>.
 </para>
 <example>
  <title>Activation du cache</title>
  <programlisting role="php">
<![CDATA[
<?php
require('Smarty.class.php');
$smarty = new Smarty;

$smarty->caching = 1;

$smarty->display('index.tpl');
?>
]]>
  </programlisting>
 </example>
 <para>
  Avec le cache activ<69>, la fonction <literal>display('index.tpl')</literal> va afficher
  le template mais sauvegardera par la m<>me occasion une copie du r<>sultat
  dans un fichier (de cache) du r<>pertoire
  <link linkend="variable.cache.dir"><parameter>$cache_dir</parameter></link>.
  Au prochain appel de <literal>display('index.tpl')</literal>, le fichier de cache sera pr<70>f<EFBFBD>r<EFBFBD>
  <20> la r<>utilisation du template.
 </para>
 <note>
  <title>Note technique</title>
  <para>
   Les fichiers situ<74>s dans
   <link linkend="variable.cache.dir"><parameter>$cache_dir</parameter></link>
   sont nomm<6D>s de la m<>me fa<66>on que les templates.
   Bien qu'ils aient une extension <filename>.php</filename>, ils ne sont pas vraiment
   directement ex<65>cutable. N'<27>ditez surtout pas ces fichiers !
  </para>
 </note>
 <para>
  Tout fichier de cache a une dur<75>e de vie limit<69>e d<>termin<69>e par <link
  linkend="variable.cache.lifetime"><parameter>$cache_lifetime</parameter></link>. La valeur par
  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
  <link linkend="variable.caching"><parameter>$caching</parameter></link><literal>=2</literal>.
  Se reporter <20> la documentation de <link
  linkend="variable.cache.lifetime"><parameter>$cache_lifetime</parameter></link> pour plus de
  d<>tails.
 </para>
 <example>
  <title>R<EFBFBD>glage individuel de $cache_lifetime</title>
  <programlisting role="php">
<![CDATA[
<?php
require('Smarty.class.php');
$smarty = new Smarty;

$smarty->caching = 2; // r<>gler la dur<75>e de vie individuellement

// r<>gle la dur<75>e de vie du cache a 15 minutes pour index.tpl
$smarty->cache_lifetime = 300;
$smarty->display('index.tpl');

// r<>gle la dur<75>e de vie du cache <20> 1 heure pour home.tpl
$smarty->cache_lifetime = 3600;
$smarty->display('home.tpl');

// NOTE : le r<>glage suivant ne fonctionne pas quand $caching = 2. La dur<75>e de vie
// du fichier de cache de home.tpl a d<>ja <20>t<EFBFBD> r<>gl<67>e a 1 heure et ne respectera
// plus la valeur de $cache_lifetime. Le cache de home.tpl expirera toujours
// dans 1 heure.
$smarty->cache_lifetime = 30; // 30 secondes
$smarty->display('home.tpl');
?>
]]>
  </programlisting>
 </example>
 <para>
  Si
  <link linkend="variable.compile.check"><parameter>$compile_check</parameter></link>
  est actif, chaque fichier de template et de configuration qui a un rapport
  avec le fichier de cache sera v<>rifi<66> pour d<>tecter une <20>ventuelle
  modification. Si l'un de ces fichiers a <20>t<EFBFBD> modifi<66> depuis que le fichier de cache a <20>t<EFBFBD>
  g<>n<EFBFBD>r<EFBFBD>, le cache est imm<6D>diatement reg<65>n<EFBFBD>r<EFBFBD>. Ce processus est couteux, donc,
  pour des raisons de performances, mettez ce param<61>tre <20> &false; pour une application
  en production.
 </para>
 <example>
  <title>Activation de $compile_check</title>
  <programlisting role="php">
<![CDATA[
<?php
require('Smarty.class.php');
$smarty = new Smarty;

$smarty->caching = 1;
$smarty->compile_check = true;

$smarty->display('index.tpl');
?>
]]>
  </programlisting>
 </example>
 <para>
  Si <link linkend="variable.force.compile"><parameter>$force_compile</parameter></link> est actif,
  les fichiers de cache sont toujours reg<65>n<EFBFBD>r<EFBFBD>s. Ceci revient finalement <20>
  d<>sactiver le cache. <link linkend="variable.force.compile"><parameter>$force_compile</parameter></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"><parameter>$caching</parameter></link><literal> = 0</literal>.
 </para>
 <para>
  La fonction <link linkend="api.is.cached"><varname>is_cached()</varname></link> permet
  de tester si un template a ou non un fichier de cache valide.
  Si vous disposez d'un template en cache qui requiert une requ<71>te
  <20> une base de donn<6E>es, vous pouvez utiliser cette m<>thode plut<75>t
  que $compile_check.
 </para>
 <example>
  <title>Exemple avec is_cached()</title>
  <programlisting role="php">
<![CDATA[
<?php
require('Smarty.class.php');
$smarty = new Smarty;

$smarty->caching = 1;

if(!$smarty->is_cached('index.tpl')) {
   // pas de cache disponible, on assigne
   $contents = get_database_contents();
   $smarty->assign($contents);
}

$smarty->display('index.tpl');
?>
]]>
  </programlisting>
 </example>
 <para>
  Vous pouvez rendre dynamiques seulement certaines parties d'une
  page avec la fonction de template <link
  linkend="language.function.insert"><varname>{insert}</varname></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
  <link linkend="language.function.insert"><varname>{insert}</varname></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"><varname>{insert}</varname></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"><varname>clear_all_cache()</varname></link>, ou de fa<66>on
  individuelle <link linkend="caching.groups">(ou par groupe)</link>
  avec la fonction <link linkend="api.clear.cache"><varname>clear_cache()</varname></link>.
 </para>
 <example>
  <title>Nettoyage du cache</title>
  <programlisting role="php">
<![CDATA[
<?php
require('Smarty.class.php');
$smarty = new Smarty;

$smarty->caching = 1;

// efface le fichier de cache du template 'index.tpl'
$smarty->clear_cache('index.tpl');

// efface tous les fichiers du cache
$smarty->clear_all_cache();

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