Files
php-doc-ru/reference/outcontrol/functions/ob-gzhandler.xml
Max Chaban 0bf373b349 Corrected small mistake.
git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@320082 c90b9560-bf6c-de11-be94-00142212c4b1
2011-11-28 09:34:22 +00:00

158 lines
4.6 KiB
XML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 38c44265bad45f8a63d8061191b67f30e9f81646 Maintainer: mch Status: ready -->
<!-- $Revision$ -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.ob-gzhandler">
<refnamediv>
<refname>ob_gzhandler</refname>
<refpurpose>callback-функция, используемая для gzip-сжатия буфера вывода при вызове ob_start</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<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>
<para>
Функиця <function>ob_gzhandler</function> предназначена для использования в
качестве callback-функции для <function>ob_start</function>, чтобы
облегчить отправку gz-кодированных данных web-браузерам, поддерживающим
сжатие web-страниц. Прежде чем <function>ob_gzhandler</function>
отправит сжатые данные, она определяет, какой тип кодирования
содержимого сможет принять браузер ("gzip", "deflate" или вообще никакой)
и вернет его содержимое соответствующим образом. Поддерживаются все
браузеры, отправляющие корректные заголовки о том, что они принимают
сжатые web-страницы. Если браузер не поддерживает сжатие страниц функция
вернет &false;.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>buffer</parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>4.0.5</entry>
<entry>
Добавлен параметр <parameter>mode</parameter>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Пример использования функции <function>ob_gzhandler</function></title>
<programlisting role="php">
<![CDATA[
<?php
ob_start("ob_gzhandler");
?>
<html>
<body>
<p>Это должно быть сжатой страницей.</p>
</body>
</html>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<function>ob_gzhandler</function> требует наличие расширения <link
linkend="ref.zlib">zlib</link>.
</para>
</note>
<note>
<para>
Вы не можете использовать одновременно <function>ob_gzhandler</function>
и <link linkend="ini.zlib.output-compression">zlib.output_compression</link>.
Также обратите внимание, что использование <link linkend="ini.zlib.output-compression">
zlib.output_compression</link> предпочтительнее,
чем <function>ob_gzhandler</function>.
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>ob_start</function></member>
<member><function>ob_end_flush</function></member>
</simplelist>
</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:"~/.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
-->