smarty/docs/fr/programmers/caching/caching-groups.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready -->

<sect1 id="caching.groups">
 <title>Groupes de fichiers de cache</title>
 <para>
  Vous pouvez faire des groupements plus <20>labor<6F>s en param<61>trant les
  groupes de <parameter>$cache_id</parameter>. Il suffit de s<>parer chaque sous-groupe
  avec une barre verticale <literal>|</literal> dans la valeur de <parameter>$cache_id</parameter>.
  Vous pouvez faire autant de sous-groupes que vous le d<>sirez.
 </para>

 <itemizedlist>
  <listitem><para>
    Vous pouvez voir les groupes de cache comme une hi<68>rarchie de dossiers.
    Par exemple, un groupe de cache <literal>'a|b|c'</literal> peut <20>tre consid<69>r<EFBFBD> comme
    la hi<68>rarchie de dossiers <literal>'/a/b/c/'</literal>.
   </para></listitem>

  <listitem><para>
    <literal>clear_cache(null,'a|b|c')</literal>
    supprimera les fichiers
    <literal>'/a/b/c/*'</literal>. <literal>clear_cache(null,'a|b')</literal>
    supprimera les fichiers <literal>'/a/b/*'</literal>.
   </para></listitem>

  <listitem><para>
    Si vous sp<73>cifiez un
    <link linkend="variable.compile.id"><parameter>$compile_id</parameter></link>
    de cette fa<66>on <literal>clear_cache(null,'a|b','foo')</literal> il sera trait<69> comme un groupe de
    cache appos<6F> <literal>'/a/b/c/foo/'</literal>.
   </para></listitem>

  <listitem><para>
    Si vous sp<73>cifiez un nom de template de cette fa<66>on
    <literal>clear_cache('foo.tpl','a|b|c')</literal> alors Smarty tentera d'effacer
    <literal>'/a/b/c/foo.tpl'</literal>.
   </para></listitem>

  <listitem><para>
    Vous ne POUVEZ PAS effacer un nom de template sp<73>cifi<66> sous un groupe de
    cache multiple comme <literal>'/a/b/*/foo.tpl'</literal>, le groupement de cache fonctionne
    UNIQUEMENT de gauche <20> droite. Vous pourriez vouloir grouper vos templates
    sous un groupe de cache simple hi<68>rarchis<69> pour <20>tre capable de les effacer
    comme un groupe.
   </para></listitem>
 </itemizedlist>

 <para>
  Le groupement de cache ne devrait pas <20>tre confondu avec votre hi<68>rarchie
  de dossiers de templates, le groupement de cache n'a aucune connaissance
  de la fa<66>on dont vos templates sont structur<75>s. Donc, par exemple, si
  vous avez une structure de template comme <filename>themes/blue/index.tpl</filename> et
  que vous voulez <20>tre capable d'effacer tous les fichiers de cache pour le th<74>me <quote>blue</quote>,
  vous devriez cr<63>er une structure de groupe de cache qui refl<66>te la structure
  de fichiers de vos templates, comme <literal>display('themes/blue/index.tpl','themes|blue')</literal>,
  et les effacer avec <literal>clear_cache(null,'themes|blue')</literal>.
 </para>
 <example>
  <title>Groupes d'identifiants de cache</title>
  <programlisting role="php">
<![CDATA[
<?php
require('Smarty.class.php');
$smarty = new Smarty;

$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');

// 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->display('index.tpl','sports|basketball');
?>
]]>
  </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
-->