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

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<sect1 id="caching.setting.up">
 <title>Param<EFBFBD>trer le cache</title>
 <para>
  La premi<6D>re chose a faire est d'activer le cache. Cela est fait en
  mettant <link linkend="variable.caching">$caching</link> = true
  (ou 1).
 </para>
 <example>
  <title>activation du cache</title>
<programlisting>
require('Smarty.class.php');
$smarty = new Smarty;

$smarty->caching = true;

$smarty->display('index.tpl');</programlisting>
 </example>
 <para>
  Avec le cache activ<69>, la fonction display('index.tpl') 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">$cache_dir</link>. Au prochain appel de
   display('index.tpl'), le fichier de cache sera pr<70>f<EFBFBD>r<EFBFBD> a la r<>utilisation
   du template.
  </para>
  <note>
   <title>Note technique</title>
   <para>
    Les fichiers situ<74>s dans $cache_dir sont nomm<6D>s de la m<>me faton 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>
  </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">$cache_lifetime</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 a chaque fichier de cache en r<>glant
   $caching = 2.
   Se reporter a 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>
<programlisting>
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 a 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">$compile_check</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 covteux, donc,
   pour des raisons de performances, mettez ce param<61>tre a false pour une application
   en production.
  </para>
  <example>
   <title>activation de $compile_check</title>
<programlisting>
require('Smarty.class.php');
$smarty = new Smarty;

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

$smarty->display('index.tpl');</programlisting>
  </example>
  <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 a
   d<>sactiver le cache. $force_compile est utilis<69> a des fins de d<>bogage,
   un moyen plus efficace de d<>sactiver le cache est de r<>gler
   <link	linkend="variable.caching">$caching</link> = false (ou 0).
   </para>
   <para>
    La fonction <link linkend="api.is.cached">is_cached()</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
    a une base de donn<6E>es, vous pouvez utiliser cette m<>thode plut(t
    que $compile_check.
   </para>
   <example>
    <title>utilisation de is_cached()</title>
<programlisting>
require('Smarty.class.php');
$smarty = new Smarty;

$smarty->caching = true;

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 templates <link
    linkend="language.function.insert">insert</link>.
    Imaginons que toute une page doit <20>tre mise en cache a part
    une banni<6E>re en bas a droite. En utilisant une fonction insert pour la
    banni<6E>re, vous pouvez garder cet <20>l<EFBFBD>ment dynamique dans le contenu qui
    est en cache. Reportez-vous a la documentation
    <link linkend="language.function.insert">insert</link> pour plus de d<>tails
     et 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 faton
     individuelle (ou par groupe) avec la fonction <link
     linkend="api.clear.cache">clear_cache()</link>.
    </para>
    <example>
     <title>nettoyage du cache</title>
<programlisting>
require('Smarty.class.php');
$smarty = new Smarty;

$smarty->caching = true;

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

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

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