php-doc-en/reference/zlib/ini.xml
Jakub Vrana f052ac1bd7 Revert useless change in 326638
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@323642 c90b9560-bf6c-de11-be94-00142212c4b1
2012-02-29 00:24:15 +00:00

133 lines
3.8 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $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
-->