php output_buffering - yaokun123/php-wiki GitHub Wiki

php 默认是打开output_buffering可以在php.ini文件中找到。

output_buffering = 4096
implicit_flush = Off
;output_handler =

当执行echo,print的时候，输出并没有立即通过tcp传给客户端浏览器显示, 而是将数据写入php buffer。

php output_buffering机制，意味在tcp buffer之前，建立了一个新的队列，数据必须经过该队列。

当一个php buffer写满的时候，脚本进程会将php buffer中的输出数据交给sapi buffer

当sapi buffer写满之后再将数据交给系统内核交由tcp传给浏览器显示。

所以，数据会依次写到这几个地方echo/print -> php buffer -> sapi buffer -> tcp buffer -> browser buffer

当echo,print等输出用户数据的时候，输出数据都会写入到php output_buffering中，

直到output_buffering写满(sapi buffer也满了)，会将这些数据通过tcp传送给浏览器显示。

你也可以通过 ob_start()手动激活php output_buffering机制， 使得即便输出超过了1kb数据，也不真的把数据交给tcp传给浏览器 因为ob_start()将php buffer空间设置到了足够大 。只有直到脚本结束，或者调用ob_end_flush函数，才会把数据发送给客户端浏览器。

一、什么时候使用ob_flush?

ob_*系列函数, 是操作PHP本身的输出缓存区。所以, ob_flush是刷新PHP自身的 缓存区。

ob_flush() : 这个函数将送出缓存区的内容（如果里边有内容的话）。如果想进一步处理缓存区中的内容，必须在ob_flush()之前调用ob_get_contents() ，因为在调用ob_flush()之后缓存区内容将被丢弃

二、什么时候使用flush?

flush()函数，是操作PHP本身的输出 缓冲区。

flush() : 刷新PHP程序的缓冲，而不论PHP执行在何种情况下（CGI ，web服务器等等）。该函数将当前为止程序的所有输出发送到用户的浏览器。

flush(), 严格来讲, 这个只有在PHP做为apache的Module(handler或者filter)安装的时候, 才有实际作用. 它是刷新WebServer(可以认为特指apache)的缓冲区，使用nginx作为WebServer是不用生效的。

在没有开启缓存时，脚本输出的内容都在服务器端处于等待输出的状态(缓冲区) ，flush()可以将等待输出的内容立即发送到客户端。

开启缓存后，脚本输出的内容存入了输出缓存中（缓存区） ，这时没有处于等待输出状态的内容（缓冲区），你直接使用flush()不会向客户端发出任何内容。而 ob_flush()的作用就是将本来存在输出缓存中的内容取出来，设置为等待输出状态，但不会直接发送到客户端 ，这时你就需要先使用 ob_flush()再使用flush()，客户端才能立即获得脚本的输出。

三、兼容方案

那么，下面介绍一种通用的写法，代码如下：

<?php

header('X-Accel-Buffering: no');//告诉nginx不要缓存，直接输出给浏览器

ob_start();//有没有都一样


for($j = 1; $j <= 6; $j++) {
    echo $j . '****';
    echo ob_get_clean();
    flush();
    sleep(1);

还有一种做法就是修改nginx配，缓存关了。影响较大

    gzip off;
    proxy_buffering off;//关闭proxy nginx的缓存区
    fastcgi_keep_conn on;

之后就可以直接使用ob_flush();flush();
For($j = 1; $j <= 6; $j++) {
    echo $j . '*';
    ob_flush();
    flush();
    sleep(1);
}

解释下proxy_buffering:
proxy_buffering主要是实现被代理服务器的数据和客户端的请求异步。

为了方便理解，我们定义三个角色，A为客户端，B为代理服务器，C为被代理服务器。

当proxy_buffering开启，A发起请求到B，B再到C，C反馈的数据先到B的buffer上，然后B会根据proxy_busy_buffer_size来决定什么时候开始把数据传输给A。

在此过程中，如果所有的buffer被写满，数据将会写入到temp_file中。

相反，如果proxy_buffering关闭，C反馈的数据实时地通过B传输给A。

以下配置，都是针对每一个http请求的：


1. proxy_buffering  on;
该参数设置是否开启proxy的buffer功能，参数的值为on或者off。
如果这个设置为off，那么proxy_buffers和proxy_busy_buffers_size这两个指令将会失效。 
但是无论proxy_buffering是否开启，proxy_buffer_size都是生效的

2. proxy_buffer_size  4k;
该参数用来设置一个特殊的buffer大小的。
从被代理服务器（C）上获取到的第一部分响应数据内容到代理服务器（B）上，通常是header，就存到了这个buffer中。 
如果该参数设置太小，会出现502错误码，这是因为这部分buffer不够存储header信息。建议设置为4k。

3. proxy_buffers  8  4k;
这个参数设置存储被代理服务器上的数据所占用的buffer的个数和每个buffer的大小。
所有buffer的大小为这两个数字的乘积。

4. proxy_busy_buffer_size 16k;
在所有的buffer里，我们需要规定一部分buffer把自己存的数据传给A，这部分buffer就叫做busy_buffer。
proxy_busy_buffer_size参数用来设置处于busy状态的buffer有多大。

对于B上buffer里的数据何时传输给A，我个人的理解是这样的：
1）如果完整数据大小小于busy_buffer大小，当数据传输完成后，马上传给A；
2）如果完整数据大小不少于busy_buffer大小，则装满busy_buffer后，马上传给A；

5. proxy_temp_path
语法：proxy_temp_path  path [level1 level2 level3]
定义proxy的临时文件存在目录以及目录的层级。

例：proxy_temp_path /usr/local/nginx/proxy_temp 1 2;
其中/usr/local/nginx/proxy_temp为临时文件所在目录，1表示层级1的目录名为1个数字(0-9),2表示层级2目录名为2个数字(00-99)

6. proxy_max_temp_file_size
设置临时文件的总大小，例如 proxy_max_temp_file_size 100M;

7. proxy_temp_file_wirte_size
设置同时写入临时文件的数据量的总大小。通常设置为8k或者16k。