smarty/docs/fr/designers/config-files.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.3 Maintainer: gerald Status: ready -->
<chapter id="config.files">
 <title>Fichiers de configuration</title>
 <para>
  Les fichiers de configuration sont un moyen interressant pour g<>rer
  des variables depuis un seul et m<>me fichier. L'exemple le plus courant
  <20>tant le sch<63>ma de couleurs du template. Normalement, pour changer le
  sch<63>ma de couleur d'une application, vous devriez aller
  dans chaque template et changer la couleur des <20>l<EFBFBD>ments (ou les classes css).
  Avec un fichier de configuration, il vous est possible de conserver
  la couleur dans un seul endroit, puis de la mettre <20> jour une seule fois.
 </para>
 <example>
  <title>Exemple de fichier de configuration</title>
  <programlisting>
<![CDATA[
# variables globales
titrePage = "Menu principal"
bodyBgColor = #000000
tableBgColor = #000000
rowBgColor = #00ff00

[client]
titrePage = "Infos client"

[Login]
titrePage = "Login"
focus = "utilisateur"
Intro = """Une valeur qui tient sur
           plusieur lignes. Vous devez la placer
           entre trois guillemets."""

# hidden section
[.Database]
host=mon.domaine.com
db=ADDRESSBOOK
user=php-user
pass=foobar
]]>
  </programlisting>
 </example>
 <para>
  Les valeurs des variables de fichiers de configuration peuvent <20>tre entre
  guillemets, sans que cela soit n<>cessaire. Si vous vouler utiliser des
  valeurs sur plusieurs lignes, vous devrez les entourer de triples
  guillemets ("""). Vous pouvez ins<6E>rer des commentaires dans les fichiers de
  configuration en utilisant une syntaxe quelquonque, non valide.
  Nous recommandons l'utilisation de <literal>#</literal> (di<64>se) en d<>but
  de ligne.
 </para>
 <para>
  Cet exemple de fichier de configuration contient deux sections. Les noms des
  sections sont entour<75>s de crochets []. Les noms de section peuvent <20>tre
  des cha<68>nes, ne contenant aucun des symboles <literal>[</literal> et
  <literal>]</literal>. Dans notre exemple, les 4 variables du d<>but sont
  des variables dites globales, qui ne sont pas contenue dans une section.
  Ces variables sont toujours charg<72>es depuis le fichier de configuration.
  Si une section est charg<72>e, alors toutes les variables de cette section
  ainsi que les variables globales sont charg<72>es. Si une variable existe
  <20> la fois en tant que globale et <20> la fois en tant que variable de
  section, la variable de section est prioritaire.
  Si vous appelez deux variables dans une m<>me section de la m<>me fa<66>on,
  la derni<6E>re d<>clar<61>e prime.
 </para>
 <para>
  Les fichiers de configuration sont charg<72>s dans le template gr<67>ce <20> la
  fonction <command>config_load</command>.
 </para>
 <para>
  Vous pouvez masquer des variables ou des sections enti<74>res en pr<70>fixant
  le nom de la variable ou le nom de la section avec une virgule.
  Ce proc<6F>d<EFBFBD> est utile si votre application r<>cup<75>re ses donn<6E>es depuis
  plusieurs fichiers de configuration et r<>cup<75>re des donn<6E>es sensibles dont
  vos templates n'ont pas besoin. Si des tiers <20>ditent des templates, vous
  <20>tes s<>r que ces derniers n'acc<63>deront pas <20> ces donn<6E>es de configuration
  en les chargeant depuis le template.
 </para>
</chapter>
<!-- 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
-->