输出控制

## 简介
输出控制函数能够控制何时从脚本发送输出。对以下几种情况中很有用，尤其是当需要在脚本开始输出数据后将消息头发送到浏览器时。输出控制函数不会影响使用 header() 或 setcookie() 发送的消息头，只会影响 PHP 代码中的函数（比如 echo）和数据。

## 安装/配置

### 需求
构建此扩展不需要其他扩展。

### 安装
使用这些函数不需要安装，它们是 PHP 核心的一部分。

### 运行时配置
这些函数的行为受 `php.ini` 中的设置影响。

**输出控制配置选项**

| 名字                 | 默认                     | 可修改范围      | 更新日志    |
|--------------------|------------------------------|------------|-----------------|
| output_buffering   | "0"                          | INI_PERDIR | &nbsp; |
| output_handler     | null                         | INI_PERDIR | &nbsp; |
| implicit_flush     | "0"                          | INI_ALL    | &nbsp; |
| url_rewriter.tags  | "form="                      | INI_ALL    | 从 PHP 7.1.0 起，此 INI 设置仅影响 output_add_rewrite_var()。在 PHP 7.1.0 之前，此 INI 设置启用透明会话 id 支持（请参阅 session.trans_sid_tags）。 |
| url_rewriter.hosts | $_SERVER['HTTP_HOST'] 用作默认值。 | INI_ALL    | 自 PHP 7.1.0 起可用 |

有关 INI_* 样式的更多详情与定义，见 [配置可被设定范围](https://www.php.net/manual/zh/configuration.changes.modes.php "配置可被设定范围")。
这是配置指令的简短说明。

output_buffering bool/int
通过设置该选项为 "On"，来启用所有文件的输出缓冲。如果要限制缓冲区的大小，可以使用允许的最大字节数相对应的数字/数量来代替该指令的值 "On"。例如 output_buffering=4096。该选项在 PHP-CLI 下始终关闭。

output_handler string
脚本的输出可以重定向到函数。例如设置 output_handler 为 mb_output_handler() 时，字符编码将会明确转换为指定编码。设置任何输出处理程序都会自动打开输出缓冲。

<div class="callout callout-info mb-3">注意:
mb_output_handler() 和 ob_iconv_handler() 不能一起使用，并且 ob_gzhandler() 和 zlib.output_compression 不能与以下函数一起使用 mb_output_handler()、ob_gzhandler()、zlib.output_compression、“URL 重写器”处理程序（请参阅 session.use_trans_sid 和 output_add_rewrite_var())。</div>

<div class="callout callout-info mb-3">注意:
只有内置函数可以使用此指令。对于用户定义的函数，使用 ob_start()。</div>

implicit_flush bool
默认为 false。如将该选项改为 true，PHP 将使输出层在每段信息块输出后自动刷新。这等同于在每次调用任何产出输出的函数（比如 print、echo）以及每个 HTML 块之后，调用 PHP 函数 flush()。

在 Web 环境中使用 PHP 时，打开这个选项会严重影响性能，通常只推荐在调试时使用。在 CLI SAPI 操作时，此值默认为 true。

参见 ob_implicit_flush()。

url_rewriter.tags string
url_rewriter.tags 指定 HTML 标记和属性，其中 URL 由 output_add_rewrite_var() 值重写。默认为 "form="。 添加 "form=" 或任何 form 属性将向 form 添加隐藏的 input 元素，并为传递给 output_add_rewrite_var() 的每个名值对（name-value pair）添加名和值属性。

<div class="callout callout-danger mb-3">**警告** 在 url_rewriter.tags 中多次添加相同的标签将仅在 URL 重写过程中使用第一次出现的标签。</div>

<div class="callout callout-info mb-3">注意: PHP 7.1.0 之前，使用 url_rewriter.tags 指定 session.trans_sid_tags。</div>

url_rewriter.hosts string
url_rewriter.hosts 可以指定重写那些主机包含 output_add_rewrite_var() 值。默认是 $_SERVER['HTTP_HOST']。通过不包含空格的逗号分隔列表指定多个主机。例如 "php.net,wiki.php.net,bugs.php.net"。

### 资源类型
此扩展没有定义资源类型。

## 预定义常量
下列常量作为 PHP 核心的一部分总是可用的。

传递给输出处理程序的状态 flag
下列 flag 作为位掩码的一部分传递给由 ob_start() 设置的输出处理程序的第二个（phase）参数：

PHP_OUTPUT_HANDLER_START (int)
表示输出缓冲已经开始。

PHP_OUTPUT_HANDLER_WRITE (int)
表示输出缓冲区正在刷新，并且有数据要输出。

PHP_OUTPUT_HANDLER_FLUSH (int)
表示缓冲区已清空。

PHP_OUTPUT_HANDLER_CLEAN (int)
表示输出缓冲已清空。

PHP_OUTPUT_HANDLER_FINAL (int)
表示这是最后一次输出缓冲操作。

PHP_OUTPUT_HANDLER_CONT (int)
表示缓冲区已清空，但输出缓冲将继续。

这是 PHP_OUTPUT_HANDLER_WRITE 的别名。

PHP_OUTPUT_HANDLER_END (int)
表示输出缓冲已结束。

这是 PHP_OUTPUT_HANDLER_FINAL 的别名。

输出缓冲区控制 flag
下列 flag 作为位掩码的一部分传递给由 ob_start() 设置的输出处理程序的第三个（flags）参数：

PHP_OUTPUT_HANDLER_CLEANABLE (int)
控制 ob_start() 创建的输出缓冲区是否可以由 ob_clean() 清除。这个 flag 不能控制 ob_end_clean() 或 ob_get_clean() 的行为。

PHP_OUTPUT_HANDLER_FLUSHABLE (int)
控制 ob_start() 创建的输出缓冲区是否可以由 ob_flush() 刷新。这个 flag 不能控制 ob_end_flush() 或 ob_get_flush() 的行为。

PHP_OUTPUT_HANDLER_REMOVABLE (int)
控制 ob_start() 创建的输出缓冲区是否可以在脚本结束前或者调用 ob_end_clean()、ob_end_flush()、ob_get_clean() 或 ob_get_flush() 移除。

PHP_OUTPUT_HANDLER_STDFLAGS (int)
输出缓冲区 flag 的默认设置；当前等同于 PHP_OUTPUT_HANDLER_CLEANABLE | PHP_OUTPUT_HANDLER_FLUSHABLE | PHP_OUTPUT_HANDLER_REMOVABLE.

输出处理程序状态 flag
下列 flag 是由 ob_get_status() 返回的 flags 位掩码的一部分：

PHP_OUTPUT_HANDLER_STARTED (int)
表示输出处理程序已调用。

PHP_OUTPUT_HANDLER_DISABLED (int)
表示输出处理程序已禁用。当输出处理程序返回 false 或者处理缓冲区失败时设置此 flag，也有一个情况就是在调用输出处理程序之前设置了此 flag。

PHP_OUTPUT_HANDLER_PROCESSED (int)
表示输出处理程序已经成功处理了缓冲区。