archived-doc-ru/reference/outcontrol/ini.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c2c5f47c53f58b5a50b5cc3c30116cb2aecf2d3c Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<section xml:id="outcontrol.configuration" xmlns="http://docbook.org/ns/docbook">
 &reftitle.runtime;
 &extension.runtime;
 <para>
  <table>
   <title>Конфигурационные опции управления выводом</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.output-buffering">output_buffering</link></entry>
      <entry><literal>«0»</literal></entry>
      <entry><constant>INI_PERDIR</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.output-handler">output_handler</link></entry>
      <entry>&null;</entry>
      <entry><constant>INI_PERDIR</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.implicit-flush">implicit_flush</link></entry>
      <entry><literal>«0»</literal></entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.url-rewriter.tags">url_rewriter.tags</link></entry>
      <entry><literal>«form=»</literal></entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry>
       Начиная с PHP 7.1.0 эта INI-настройка влияет только на функцию
       <function>output_add_rewrite_var</function>.
       До PHP 7.1.0 эта INI-настройка включала поддержку прозрачного идентификатора сеанса
       (смотрите описание директивы <link linkend="ini.session.trans-sid-tags">session.trans_sid_tags</link>).
       функцию .
      </entry>
     </row>
     <row>
      <entry><link linkend="ini.url-rewriter.hosts">url_rewriter.hosts</link></entry>
      <entry><literal>$_SERVER['HTTP_HOST']</literal> задано значением по умолчанию.</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry>Доступно с PHP 7.1.0</entry>
     </row>
    </tbody>
   </tgroup>
  </table>
  &ini.php.constants;
 </para>

 &ini.descriptions.title;

 <para>
  <variablelist>
   <varlistentry xml:id="ini.output-buffering">
    <term>
     <parameter>output_buffering</parameter>
     <type>bool</type>/<type>integer</type>
    </term>
    <listitem>
     <para>
      Чтобы включить буферизацию вывода для всех файлов, директиве устанавливают
      значение <literal>«On»</literal>.
      Чтобы ограничить размер буфера, вместо <literal>«On»</literal>
      можно указать число, которое будет соответствовать
      количеству байтов, ограничивающих размер буфера.
      Например — <literal>output_buffering=4096</literal>.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.output-handler">
    <term>
     <parameter>output_handler</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Разрешено перенаправлять вывод скриптов в функцию.
      Например, если установить функцию <function>mb_output_handler</function>
      в качестве значения директивы <literal>output_handler</literal>,
      кодировка символов будет прозрачно преобразовываться в заданную кодировку.
      Установка любого обработчика вывода автоматически включает буферизацию вывода.
     </para>
     <note>
      <para>
       Нельзя использовать вместе функции <function>mb_output_handler</function>
       и <function>ob_iconv_handler</function>,
       а функцию <function>ob_gzhandler</function>
       и директиву <link linkend="ini.zlib.output-compression">zlib.output_compression</link>
       нельзя использовать ни с одним из следующих:
       с функцией <function>mb_output_handler</function>,
       с функцией <function>ob_gzhandler</function>,
       с директивой <link linkend="ini.zlib.output-compression">zlib.output_compression</link>,
       с обработчиком «URL-Rewriter»
       (смотрите описание директивы <link linkend="ini.session.use-trans-sid">session.use_trans_sid</link>
       и функции <function>output_add_rewrite_var</function>).
      </para>
     </note>
     <note>
      <para>
       С директивой разрешено использовать только встроенные функции.
       Для пользовательских функций вызывают функцию <function>ob_start</function>.
      </para>
     </note>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.implicit-flush">
    <term>
     <parameter>implicit_flush</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      Значение по умолчанию — &false;. Изменение значения на &true; указывает PHP не сохранять
      данные в буфер, а после каждого отправленного блока автоматически
      отправлять данные в выходной слой. Это эквивалентно вызову PHP-функции
      <function>flush</function> после каждого вызова функции вывода
      (например, <function>print</function> или <function>echo</function>)
      и каждого <literal>HTML</literal>-блока.
     </para>
     <para>
      При использовании PHP в веб-среде, включение этой опции
      приведёт к серьёзной потере производительности, поэтому
      рекомендуется использовать её только для отладки. Это значение
      по умолчанию имеет &true; при работе в <literal>CLI SAPI</literal>.
     </para>
     <para>
      Сморите также <function>ob_implicit_flush</function>.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.url-rewriter.tags">
    <term>
     <parameter>url_rewriter.tags</parameter>
     <type>string</type>
    </term>
    <listitem>
     <simpara>
      Директива <literal>url_rewriter.tags</literal> определяет HTML-теги и атрибуты,
      в которых URL-адреса перезаписываются значениями функции <function>output_add_rewrite_var</function>.
      Значение по умолчанию — <literal>«form=»</literal>.
     </simpara>
     <simpara>
      Добавление значения <literal>«form=»</literal> или любого атрибута формы (<literal>form</literal>)
      добавит скрытый элемент <literal>input</literal> к форме (<literal>form</literal>),
      с артибутом с указанными именем и значением для каждой пары имя-значение, переданной в функцию
      <function>output_add_rewrite_var</function>.
     </simpara>
     <caution>
      <simpara>
       Если в директиву <literal>url_rewriter.tags</literal> добавить один и тот же тег больше одного раза,
       при перезаписи URL будет обработано только первое вхождение.
      </simpara>
     </caution>
     <note>
      <simpara>
       До PHP 7.1.0 надо было использовать
       <link linkend="ini.url-rewriter.tags">url_rewriter.tags</link>
       для указания <link linkend="ini.session.trans-sid-tags">session.trans_sid_tags</link>.
      </simpara>
     </note>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.url-rewriter.hosts">
    <term>
     <parameter>url_rewriter.hosts</parameter>
     <type>string</type>
    </term>
    <listitem>
     <simpara>
      Директива <literal>url_rewriter.hosts</literal> указывает, какие хосты перезаписываются,
      чтобы включить в них значения функции <function>output_add_rewrite_var</function>.
      По умолчанию директиве установлено значение <literal>$_SERVER['HTTP_HOST']</literal>.
      Разрешено указывать несколько хостов,
      перечислив их через запятую без пробелов.
      Например, <literal>«php.net,wiki.php.net,bugs.php.net»</literal>.
     </simpara>
    </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
-->