PHP flush 函数使用注意事项

关于`ob_flush`和`flush`这两个函数在手册中的描述，确实容易让人迷惑。它们看似功能相似，实则操作的对象不同。今天，让我们深入理解并解释这两者的差异。

`ob_系列函数`主要是用来操作PHP本身的输出缓冲区。其中，`ob_flush`就是用来刷新PHP自身的缓冲区。当我们在PHP中执行输出操作时，数据首先会被存放在输出缓冲区中，待缓冲区满或执行相关操作（如`ob_flush`）后，数据才会被发送到客户端。

而`flush`函数则有所不同。严格来说，它的作用在很大程度上取决于PHP是如何被部署的。当PHP作为Apache的模块（handler或filter）时，`flush`函数变得尤为有用。它通过调用`sapi_module`的`flush`成员函数指针，间接地调用Apache的API `ap_rflush`来刷新Apache的输出缓冲区。这意味着，当你使用`flush`函数时，你是在告诉Apache服务器清空其输出缓冲区，将内容立即发送到客户端。

在Apache的某些模块中，如`mod_gzip`，可能会进行自己的输出缓存。在这种情况下，即使你调用了`flush`函数，结果也可能不会立即被发送到客户端浏览器。这是因为mod_gzip模块可能会先缓存内容，进行压缩或其他处理后再发送。

掌握秘密：正确使用 ob_flush 和 flush 的顺序

在 PHP 中，我们经常会使用 ob_flush 和 flush 来控制输出缓冲。这两个函数对于确保数据的实时传输至关重要，特别是在使用服务器发送事件 (SSE) 时。那么，它们的正确顺序是什么呢？首先使用 ob_flush，然后调用 flush。虽然在某些情况下不调用 flush 也可以，但为了代码的可移植性，建议两者配合使用。

以下是一个基于 SSE 的 PHP 脚本示例，展示了如何正确使用这两个函数：

```php

header('Content-Type: text/event-stream'); // 设置内容类型为服务器发送事件

header('Cache-Control: no-cache'); // 不缓存响应

// 在 nginx + fpm + php 环境下，需要添加一个特定的响应头以支持实时传输

header('X-Ael-Buffering: no'); // 关闭代理缓冲和 fastcgi 缓冲，这在使用 php-fpm 时尤为关键

// 开始输出缓冲，如果当前缓冲级别为0，则启动新的输出缓冲

if (ob_get_level() == 0) ob_start();

$long = 60; // 设置一个时间变量，用于循环发送服务器时间

while ($long > 0) { // 循环发送时间信息

$time = date('r'); // 获取当前服务器时间

echo "data: The server time is: {$time}"; // 输出服务器时间信息

ob_flush(); // 刷新输出缓冲区

flush(); // 强制立即输出缓冲区数据并清空缓冲区

sleep(1); // 暂停一秒后再次发送时间信息

$long--; // 减少循环次数计数器

}

?>

```

在上述代码中，我们首先设置了适当的 HTTP 响应头，确保浏览器和服务器能够正确地处理服务器发送事件。接着，通过循环每隔一秒发送一次服务器时间信息，并使用 ob_flush 和 flush 函数确保数据能够实时传输。通过添加特定的响应头 X-Ael-Buffering 来支持在 nginx + fpm + php 环境下的实时传输。这样，我们就能够确保数据的实时性和准确性。