reference/outcontrol/ini.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d4d5216e7a965ca194f6b1c9dee84cecab2674e5 Maintainer: HonestQiao Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<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 设置启用透明会话 id 支持（请参阅 <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>int</type>
   </term>
   <listitem>
    <para>
     通过设置该选项为 <literal>"On"</literal>，来启用所有文件的输出缓冲。如果要限制缓冲区的大小，可以使用允许的最大字节数相对应的数字/数量来代替该指令的值
     <literal>"On"</literal>。例如 <literal>output_buffering=4096</literal>。该选项在 PHP-CLI 下始终关闭。
    </para>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="ini.output-handler">
   <term>
    <parameter>output_handler</parameter>
    <type>string</type>
   </term>
   <listitem>
    <para>
     脚本的输出可以重定向到函数。例如设置 <literal>output_handler</literal> 为 <function>mb_output_handler</function>
     时，字符编码将会明确转换为指定编码。设置任何输出处理程序都会自动打开输出缓冲。
    </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
      重写器”处理程序（请参阅 <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
     将使输出层在每段信息块输出后自动刷新。这等同于在每次调用任何产出输出的函数（比如
     <function>print</function>、<function>echo</function>）以及每个
     HTML 块之后，调用 PHP 函数 <function>flush</function>。
    </para>
    <para>
     在 Web 环境中使用 PHP 时，打开这个选项会严重影响性能，通常只推荐在调试时使用。在
     <literal>CLI SAPI</literal> 操作时，此值默认为 &true;。
    </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>form</literal> 添加隐藏的 <literal>input</literal>
     元素，并为传递给 <function>output_add_rewrite_var</function> 的每个名值对（name-value pair）添加名和值属性。
    </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
-->