doc-fr/reference/zlib/ini.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6dfe0767250cdbdf509223f6bc266557b0a3fec9 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->

<section xml:id="zlib.configuration" xmlns="http://docbook.org/ns/docbook">
 &reftitle.runtime;
 &extension.runtime;
 <para>
  L'extension zlib offre l'option de compresser de manière transparente les
  pages PHP à la volée, si le navigateur du visiteur le supporte. Voici donc
  les trois options à utiliser dans le <link
  linkend="configuration.file">fichier de configuration</link> &php.ini;.
  <table>
   <title>&ConfigureOptions; Zlib</title>
   <tgroup cols="4">
    <thead>
     <row>
      <entry>&Name;</entry>
      <entry>&Default;</entry>
      <entry>&Changeable;</entry>
      <entry>&Changelog;</entry>
     </row>
    </thead>
    <tbody xml:id="zlib.configuration.list">
     <row>
      <entry><link linkend="ini.zlib.output-compression">zlib.output_compression</link></entry>
      <entry>"0"</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.zlib.output-compression-level">zlib.output_compression_level</link></entry>
      <entry>"-1"</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.zlib.output-handler">zlib.output_handler</link></entry>
      <entry>""</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry></entry>
     </row>
    </tbody>
   </tgroup>
  </table>
  &ini.php.constants;
 </para>
 &ini.descriptions.title;
 <para>
  <variablelist>
   <varlistentry xml:id="ini.zlib.output-compression">
    <term>
     <parameter>zlib.output_compression</parameter>
     <type>bool</type>/<type>int</type>
    </term>
    <listitem>
     <para>
      Active ou pas la compression transparente des pages. Si cette
      option est mise à "On" dans &php.ini; ou dans la configuration
      Apache, les pages sont compressées si le navigateur envoie un
      en-tête "Accept-Encoding: gzip" ou "deflate".
      Les en-têtes "Content-Encoding: gzip" (respectivement "deflate") et
      "Vary: Accept-Encoding" sont ajoutés dans la page envoyée au navigateur.
      En fonctionnement, il peut être défini uniquement avant tout affichage.
     </para>
     <para>
      Cette option accepte aussi des valeurs entières au lieu des booléens,
      "On"/"Off", ce qui vous permet de configurer la taille du tampon de sortie
      (par défaut, il vaut 4ko).
     </para>
     <note>
      <para>
       <link linkend="ini.output-handler">output_handler</link> doit être
       laissée à vide si cette option est activée. Sinon, vous devez
       utiliser <literal>zlib.output_handler</literal>.
      </para>
     </note>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.zlib.output-compression-level">
    <term>
     <parameter>zlib.output_compression_level</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      Niveau de compression utilisé pour la compression de sortie.
      La valeur doit être comprise entre 0 (aucune compression) et 9
      (compression élevée). La valeur par défaut est -1, ce qui laissera le
      serveur décider du niveau de compression à utiliser.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.zlib.output-handler">
    <term>
     <parameter>zlib.output_handler</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Vous ne pouvez pas spécifier de gestionnaire de sortie supplémentaire si
      zlib.output_compression est activée. Cette configuration est la même que
      <link linkend="ini.output-handler">output_handler</link> mais dans un
      ordre différent.
     </para>
    </listitem>
   </varlistentry>

 </variablelist>
 </para>
</section>

<!-- 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:"~/.phpdoc/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
-->