1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
|
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.12 $ -->
<!-- splitted from ./en/functions/outcontrol.xml, last change in rev 1.1 -->
<refentry id="function.ob-gzhandler">
<refnamediv>
<refname>ob_gzhandler</refname>
<refpurpose>
ob_start callback function to gzip output buffer
</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>string</type><methodname>ob_gzhandler</methodname>
<methodparam><type>string</type><parameter>buffer</parameter></methodparam>
<methodparam><type>int</type><parameter>mode</parameter></methodparam>
</methodsynopsis>
<note>
<para>
<function>ob_gzhandler</function> requires the <link linkend="ref.zlib">zlib</link>
extension.
</para>
</note>
<para>
<function>ob_gzhandler</function> is intended to be used as a
callback function for <function>ob_start</function> to help
facilitate sending gz-encoded data to web browsers that support
compressed web pages. Before <function>ob_gzhandler</function>
actually sends compressed data, it determines what type of
content encoding the browser will accept ("gzip", "deflate" or
none at all) and will return its output accordingly. All
browsers are supported since it's up to the browser to send the
correct header saying that it accepts compressed web pages.
If a browser doesn't support compressed pages this function returns
&false;.
</para>
<note>
<para>
<parameter>mode</parameter> was added in PHP 4.0.5.
</para>
</note>
<para>
<example>
<title><function>ob_gzhandler</function> example</title>
<programlisting role="php">
<![CDATA[
<?php
ob_start("ob_gzhandler");
?>
<html>
<body>
<p>This should be a compressed page.</p>
</html>
<body>
]]>
</programlisting>
</example>
</para>
<note>
<para>
You cannot use both <function>ob_gzhandler</function> and
<link linkend="ini.zlib.output-compression">
zlib.output_compression</link>. Also note that
using <link linkend="ini.zlib.output-compression">
zlib.output_compression</link> is preferred over
<function>ob_gzhandler</function>.
</para>
</note>
<para>
See also
<function>ob_start</function> and
<function>ob_end_flush</function>.
</para>
</refsect1>
</refentry>
<!-- 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
-->
|
