<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<section xml:id="zlib.configuration" xmlns="http://docbook.org/ns/docbook">
 &reftitle.runtime;
 &extension.runtime;
 <para>
  The zlib extension offers the option to transparently compress
  your pages on-the-fly, if the requesting browser supports
  this. Therefore there are three options in the <link
  linkend="configuration.file">configuration file</link> &php.ini;.
   <table>
   <title>Zlib Configuration Options</title>
   <tgroup cols="4">
    <thead>
     <row>
      <entry>Name</entry>
      <entry>Default</entry>
      <entry>Changeable</entry>
      <entry>Changelog</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry><link linkend="ini.zlib.output-compression">zlib.output_compression</link></entry>
      <entry>"0"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Available since PHP 4.0.5.</entry>
     </row>
     <row>
      <entry><link linkend="ini.zlib.output-compression-level">zlib.output_compression_level</link></entry>
      <entry>"-1"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Available since PHP 4.3.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.zlib.output-handler">zlib.output_handler</link></entry>
      <entry>""</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Available since PHP 4.3.0.</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>boolean</type>/<type>integer</type>
   </term>
   <listitem>
    <para>
     Whether to transparently compress pages. If this option is set
     to "On" in &php.ini; or the Apache configuration, pages are
     compressed if the browser sends an "Accept-Encoding: gzip" or
     "deflate" header. "Content-Encoding: gzip" (respectively
     "deflate") and "Vary: Accept-Encoding" headers are added to
     the output.
     In runtime, it can be set only before sending any output.
    </para>
    <para>
     This option also accepts integer values instead of boolean
     "On"/"Off", using this you can set the output buffer size
     (default is 4KB).
    </para>
    <note>
     <para>
      <link linkend="ini.output-handler">output_handler</link> must be 
      empty if this is set 'On' ! Instead you must use <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>integer</type>
   </term>
   <listitem>
    <para>
     Compression level used for transparent output compression. Specify a
     value between 0 (no compression) to 9 (most compression). The default
     value, -1, lets the server decide which level to use.
    </para>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="ini.zlib.output-handler">
   <term>
    <parameter>zlib.output_handler</parameter>
    <type>string</type>
   </term>
   <listitem>
    <para>
     You cannot specify additional output handlers if zlib.output_compression
     is activated here. This setting does the same as <link linkend="ini.output-handler">
     output_handler</link> but in a different order.
    </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
-->