reference/outcontrol/constants.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2a8768782512db2b95e5da2f032dd0347806d203 Maintainer: mowangjuanzi Status: ready -->
<!-- CREDITS: Luffy -->
<appendix xml:id="outcontrol.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.constants;
 &extension.constants.core;
 <variablelist xml:id="outcontrol.constants.flags-passed-to-handler">
  <title>传递给输出处理程序的状态 flag</title>
  <para>
   下列 flag 作为位掩码的一部分传递给由 <function>ob_start</function> 设置的输出处理程序的第二个（<parameter>phase</parameter>）参数：
  </para>
  <varlistentry xml:id="constant.php-output-handler-start">
   <term>
    <constant>PHP_OUTPUT_HANDLER_START</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     表示输出缓冲已经开始。
    </para>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-output-handler-write">
   <term>
    <constant>PHP_OUTPUT_HANDLER_WRITE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     表示输出缓冲区正在刷新，并且有数据要输出。
    </para>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-output-handler-flush">
   <term>
    <constant>PHP_OUTPUT_HANDLER_FLUSH</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     表示缓冲区已清空。
    </para>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-output-handler-clean">
   <term>
    <constant>PHP_OUTPUT_HANDLER_CLEAN</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     表示输出缓冲已清空。
    </para>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-output-handler-final">
   <term>
    <constant>PHP_OUTPUT_HANDLER_FINAL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     表示这是最后一次输出缓冲操作。
    </para>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-output-handler-cont">
   <term>
    <constant>PHP_OUTPUT_HANDLER_CONT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     表示缓冲区已清空，但输出缓冲将继续。
    </para>
    <para>
     这是 <constant>PHP_OUTPUT_HANDLER_WRITE</constant> 的别名。
    </para>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-output-handler-end">
   <term>
    <constant>PHP_OUTPUT_HANDLER_END</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     表示输出缓冲已结束。
    </para>
    <para>
     这是 <constant>PHP_OUTPUT_HANDLER_FINAL</constant> 的别名。
    </para>
   </listitem>
  </varlistentry>
 </variablelist>
 <variablelist xml:id="outcontrol.constants.buffer-control-flags">
  <title>输出缓冲区控制 flag</title>
  <para>
   下列 flag 作为位掩码的一部分传递给由 <function>ob_start</function> 设置的输出处理程序的第三个（<parameter>flags</parameter>）参数：
  </para>
  <varlistentry xml:id="constant.php-output-handler-cleanable">
   <term>
    <constant>PHP_OUTPUT_HANDLER_CLEANABLE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     控制 <function>ob_start</function> 创建的输出缓冲区是否可以由 <function>ob_clean</function> 清除。这个 flag
     不能控制 <function>ob_end_clean</function> 或 <function>ob_get_clean</function> 的行为。
    </para>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-output-handler-flushable">
   <term>
    <constant>PHP_OUTPUT_HANDLER_FLUSHABLE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     控制 <function>ob_start</function> 创建的输出缓冲区是否可以由 <function>ob_flush</function> 刷新。这个 flag
     不能控制 <function>ob_end_flush</function> 或 <function>ob_get_flush</function> 的行为。
    </para>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-output-handler-removable">
   <term>
    <constant>PHP_OUTPUT_HANDLER_REMOVABLE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     控制 <function>ob_start</function> 创建的输出缓冲区是否可以在脚本结束前或者调用
     <function>ob_end_clean</function>、<function>ob_end_flush</function>、<function>ob_get_clean</function> 或 <function>ob_get_flush</function> 移除。
    </para>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-output-handler-stdflags">
   <term>
    <constant>PHP_OUTPUT_HANDLER_STDFLAGS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     输出缓冲区 flag 的默认设置；当前等同于
     <constant>PHP_OUTPUT_HANDLER_CLEANABLE</constant> |
     <constant>PHP_OUTPUT_HANDLER_FLUSHABLE</constant> |
     <constant>PHP_OUTPUT_HANDLER_REMOVABLE</constant>.
    </para>
   </listitem>
  </varlistentry>
 </variablelist>
 <variablelist xml:id="outcontrol.constants.flags-returned-by-handler">
  <title>输出处理程序状态 flag</title>
  <para>
   下列 flag 是由 <function>ob_get_status</function> 返回的 <literal>flags</literal> 位掩码的一部分：
  </para>
  <varlistentry xml:id="constant.php-output-handler-started">
   <term>
    <constant>PHP_OUTPUT_HANDLER_STARTED</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     表示输出处理程序已调用。
    </para>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-output-handler-disabled">
   <term>
    <constant>PHP_OUTPUT_HANDLER_DISABLED</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     表示输出处理程序已禁用。当输出处理程序返回 &false; 
     或者处理缓冲区失败时设置此 flag。
     在 PHP 8.4.0 之前，此 flag 可以在启动输出缓冲区时设置。
    </para>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-output-handler-processed">
   <term>
    <constant>PHP_OUTPUT_HANDLER_PROCESSED</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     表示输出处理程序已经成功处理了缓冲区。
     自 PHP 8.4.0 起可用。
    </para>
   </listitem>
  </varlistentry>
 </variablelist>
</appendix>

<!-- 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
-->
 