<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Runtime Configuration</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="zlib.installation.html">Installation</a></div>
<div class="next" style="text-align: right; float: right;"><a href="zlib.resources.html">Resource Types</a></div>
<div class="up"><a href="zlib.setup.html">Installing/Configuring</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="zlib.configuration" class="section">
<h2 class="title">Runtime Configuration</h2>
<p class="simpara">
The behaviour of these functions is affected by settings in <var class="filename">php.ini</var>.
</p>
<p class="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 <a href="configuration.file.html" class="link">configuration file</a> <var class="filename">php.ini</var>.
<table class="doctable table">
<caption><strong>Zlib Configuration Options</strong></caption>
<thead>
<tr>
<th>Name</th>
<th>Default</th>
<th>Changeable</th>
<th>Changelog</th>
</tr>
</thead>
<tbody class="tbody">
<tr>
<td><a href="zlib.configuration.html#ini.zlib.output-compression" class="link">zlib.output_compression</a></td>
<td>"0"</td>
<td>PHP_INI_ALL</td>
<td>Available since PHP 4.0.5.</td>
</tr>
<tr>
<td><a href="zlib.configuration.html#ini.zlib.output-compression-level" class="link">zlib.output_compression_level</a></td>
<td>"-1"</td>
<td>PHP_INI_ALL</td>
<td>Available since PHP 4.3.0.</td>
</tr>
<tr>
<td><a href="zlib.configuration.html#ini.zlib.output-handler" class="link">zlib.output_handler</a></td>
<td>""</td>
<td>PHP_INI_ALL</td>
<td>Available since PHP 4.3.0.</td>
</tr>
</tbody>
</table>
For further details and definitions of the
PHP_INI_* modes, see the <a href="configuration.changes.modes.html" class="xref">Where a configuration setting may be set</a>.
</p>
<p class="para">Here's a short explanation of
the configuration directives.</p>
<p class="para">
<dl>
<dt id="ini.zlib.output-compression">
<span class="term">
<em><code class="parameter">zlib.output_compression</code></em>
<span class="type"><a href="language.types.boolean.html" class="type boolean">boolean</a></span>/<span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
</span>
<dd>
<p class="para">
Whether to transparently compress pages. If this option is set
to "On" in <var class="filename">php.ini</var> 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.
</p>
<p class="para">
This option also accepts integer values instead of boolean
"On"/"Off", using this you can set the output buffer size
(default is 4KB).
</p>
<blockquote class="note"><p><strong class="note">Note</strong>:
<p class="para">
<a href="outcontrol.configuration.html#ini.output-handler" class="link">output_handler</a> must be
empty if this is set 'On' ! Instead you must use <em>zlib.output_handler</em>.
</p>
</p></blockquote>
</dd>
</dt>
<dt id="ini.zlib.output-compression-level">
<span class="term">
<em><code class="parameter">zlib.output_compression_level</code></em>
<span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
</span>
<dd>
<p class="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.
</p>
</dd>
</dt>
<dt id="ini.zlib.output-handler">
<span class="term">
<em><code class="parameter">zlib.output_handler</code></em>
<span class="type"><a href="language.types.string.html" class="type string">string</a></span>
</span>
<dd>
<p class="para">
You cannot specify additional output handlers if zlib.output_compression
is activated here. This setting does the same as <a href="outcontrol.configuration.html#ini.output-handler" class="link">
output_handler</a> but in a different order.
</p>
</dd>
</dt>
</dl>
</p>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="zlib.installation.html">Installation</a></div>
<div class="next" style="text-align: right; float: right;"><a href="zlib.resources.html">Resource Types</a></div>
<div class="up"><a href="zlib.setup.html">Installing/Configuring</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
