php输出控制output controll(header, ob_xxx)

Posted allen__

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了php输出控制output controll(header, ob_xxx)相关的知识,希望对你有一定的参考价值。

关于php的output controll参考文档:

http://gywbd.github.io/posts/2015/1/php-output-buffer-in-deep.html

http://www.cnblogs.com/liuzhang/p/4161213.html

众所周知,调用header()函数之前不能有任何输出到浏览器,否则会报错。

 

如何复现这种情况:

1、php.ini设置output_buffering OFF

2、测试代码:

echo 2;
header("HTTP/1.1 503 Service Unavailable");

3、这样程序就会报错:

Warning: Cannot modify header information - headers already sent by

 

如何修复这种错误:

方法1:

php.ini中output_buffering 4096设置一个4K的大小,这样程序的echo就会一直缓存到php(或者缓存到web server ?)直到缓存大小为4K或者调用ob_系列函数才会输出。

这也是下面代码直到sleep 2s后才能显示所有结果的原因:

echo 2;
sleep(2);
echo 3;

 

方法2:

方法1中output_buffering 4096表示默认php程序开启输出(针对echo printf等函数)缓存(效果等同于ob_start()函数),此时调用ob_get_level()得到的结果是1。

所以可以调用关闭缓存函数来关闭输出缓存

ob_end_clean()或者ob_get_clean()

ob_end_clean();
echo 2;
header("HTTP/1.1 503 Service Unavailable");

这样就会报错了。

 

但是如下代码也并不会立即输出结果:

ob_get_clean();
echo 2;
sleep(2);
echo 3;

原因应该是ob_函数只关闭了php的输出缓存,而echo的东西依旧存在web server里面被缓存着,也只有等待程序完毕web server才把输出完全发送给浏览器。

 

 

 

如果想要程序echo一个东西浏览器就显示一个,可以如下操作:

echo str_pad(\'\',4096)."\\n";  //这一行很重要,强制使缓冲溢出,4096等于output_buffering 的值
echo 1;

ob_flush();
flush();

sleep(2);
echo 2;

 

//@todo 未完成,需要重新理一理,还未完全搞懂。flush和ob系列函数有些是控制php缓存的,有些是控制web server缓存的。

 更新:

这个文档比较易懂 http://www.hackingwithphp.com/13/0/0/output-buffering

下面的栗子都是把php.ini中output buffing OFF掉来测试的。

 

栗子1:

ob_start();            //开启一个buffer
    print "Hello First!\\n";  //往buffer里面写入东西
    ob_end_flush();        //关闭掉buffer, 并且把buffer里面的东西输出出来  此时输出"Hello First\\n"

    ob_start();        //开启一个buffer
    print "Hello Second!\\n";  //往buffer里面写入东西
    ob_end_clean();        //关闭掉buffer,并且清空掉这个buffer里面的东西

    ob_start();          //开启一个buffer
    print "Hello Third!\\n";    //往这个buffer里面写入东西,

//程序结束时,会自动输出所有buffer里面的东西,此时输出"Hello Third\\n"

说明:

该栗子会输出hello first 和 hello third

 

栗子2:

 ob_start();        //开启
 print "Hello First!\\n";  //写入东西
 ob_flush();        //输出该buffer的东西,和ob_end_flush唯一不同的是少了end,也就是说该buffer还没有关闭      此时输出“helle first”
 print "Hello Second!\\n"; //继续往这个buffer写入
 ob_clean();        //清除这个buffer所有内容
 print "Hello Third!\\n";  //继续往这个buffer写入

//程序结束时,自动输出buffer所有内容,此时输出"hello third"

说明:

这个栗子输出hello first和hello third

和栗子1唯一不同的是这个栗子只使用了一个buffer,省去了buffer close/open 的操作,效率要高一点。

 

栗子3:

ob_start();                    //开启
print "Hello first!\\n";        //写入

ob_start();                    //开启第二个buffer
print "Hello second!\\n";    //写入到第二个buffer

ob_clean();                    //清空第二个buffer,因为buffer的创建是栈的形式,所以满足后进先出,一个ob_函数只能影响到最近的一个buffer

//程序结束后输出所有buffer内容,此时输出"hello first"

输出hello first

 

栗子4:

ob_start();                        //开启
print "In first buffer\\n";        //写入

ob_start();                        //开启第二个buffer
print "In second buffer\\n";        //写入到第二个buffer
ob_end_flush();                    //关闭第二个buffer并且输出第二个buffer的内容,此时因为第一个buffer没有关闭,所以第二个buffer的输出会当做内容写入到第一个buffer里面去,这三行等同于 print "In second buffer\\n";

print "In first buffer\\n";        //继续写入到第一个buffer
ob_end_flush();                 //关闭第一个buffer并且输出所有内容,此时输出所有三行数据

输出所有

注意这个栗子4和栗子3对比。

 

栗子5:

ob_start(\'ob_gzhandler\');    //使用zip压缩内容后发送给浏览器,浏览器会自动解析,
print "My content\\n";      //压缩后的内容能节约60%左右的带宽
ob_end_flush();

有一个坑儿就是要确定浏览器是否支持压缩,可以查看浏览器的request header中的

Accept-Encoding:gzip, deflate, sdch 头部。如果有gzip应该就是支持的,未验证。
 
 
栗子6 flush():
ob_start();        //开启
echo \'test\';    //写入
ob_end_flush(); //关闭php的buffer并且输出buffer里面的东西

flush();        //立即将php的输出(这个输出指的是已经从buffer里面flush出来的数据,比如这个栗子把上面的ob_end_flush函数注释或者放在flush后面,这个栗子的结果就是要等脚本结束才能看到结果)呈现到浏览器,而不用等待脚本结束
          //这个flush()函数应该是把web server的东西直接输出到浏览器,而上面的ob_flush,ob_end_flush应该是php进程把输出丢给web server
sleep(2);

echo 444;

栗子6等同于下面这个栗子(前提是下面这个栗子的php.ini中的output buffering是OFF状态)

//ob_start();    //这一行是不能加滴,加了的话,echo \'test\'就会被放在buffer里面,而紧接着flush()函数是拉不到数据的,因为flush()函数只接受buffer里面flush出来的数据(ob_end_flush,ob_flush)或者非buffer里面的数据。
echo \'test\'; //写入 flush(); sleep(2); echo 444;

说明:

栗子6的结果是分段式输出结果。

 

强调一点,CLI模式下的output buffering默认是OFF,implicit_flush参数默认是1,

也就是说CLI模式下,echo 东西时,不会被缓存在buffer里面,而且implicit_flush=1,相当于手动执行了flush()函数,所以,在CLI模式下,echo数据会立马看到效果。

而web模式下的php.ini,outpu buffering默认是4096, implicit_flush默认是OFF, 相当于默认开启了一个ob_start,而且没有执行flush(),如果要web server把数据立马推到web brower,必须手动调用flush().

 

以下情况会导致使用header等需要发送头部信息的函数报如下错误:

Warning: Cannot modify header information - headers already sent by

情况1:

header等函数放在有输出的代码的后面,这个输出指的是非buffer的输出 或者 buffer里面有输出并且调用了ob_flush/ob_end_flush函数的。

 

栗子:

//php.ini中output buffering OFF
echo "test"; header("HTTP/1.1 503 Service Unavailable");

或者

//php.ini中output buffering OFF
ob_start();
echo "test";
ob_end_flush();
header("HTTP/1.1 503 Service Unavailable");

或者

//php.ini中的output buffering 4096 可以用ob_start(NULL, 4096);代替
 echo str_pad(\' \', 4097);//如果echo的大小小于4096则不会报错。 
header(
"HTTP/1.1 503 Service Unavailable");

这三种情况都会报错header,

其中第三个栗子,header和echo都在同一个buffer

如果第三个栗子echo的内容<4096字节,那echo和header属于同一个buffer,php底层会自动先把header的内容写入header buffer,再把echo的内容写入body buffer,然后先发送header再发送body分别给SAPI,所以并不会报错

如果第三个栗子echo的内容>=4096字节,那么php会自动调用类似ob_flush/ob_end_flush的函数(也就是等同于第二个例子),把echo的内容装入body buffer传递给sapi(只会装入4096个字节),自动组装一个默认的header buffer传递给sapi,

  然后代码继续运行,如果后面的代码没有header等函数,则会把剩下的echo内容第二次装入body buffer传递给sapi并且正常运行下去,如果遇到header函数,此时因为已经传递过一个默认的header buffer给SAPI了,所以这个时候再修改header要报错。

 

所以导致header函数报错的最终原因是看php有没有传递header buffer给sapi,也就是看有没有手动ob_flush()/ob_end_flush()或者自动flush(echo超过output buffering设置或者ob_start(NULL, buffer size)设置时会自动触发flush)

以上是关于php输出控制output controll(header, ob_xxx)的主要内容,如果未能解决你的问题,请参考以下文章

利用console控制台调试php代码

php://inputphp://output 区别及用法

php://inputphp://output 区别及用法

IDEA控制器output输出乱码解决

深入理解php的输出缓冲区(output buffer)

PHP 缓存区ob