Use PHP to control the user's browser--Instructions for using the ob* function

用PHP控制用户的浏览器--ob*函数的使用

　　Output Control 函数可以让你自由控制脚本中数据的输出。它非常地有用，特别是对于：当你想在数据已经输出后，再输出文件头的情况。输出控制函数不对使用 header() 或 setcookie(), 发送的文件头信息产生影响,只对那些类似于 echo() 和 PHP 代码的数据块有作用。

　　我们先举一个简单的例子，让大家对Output Control有一个大致的印象：
Example 1.

<font color="#000000"><font face="新宋体"><font color="#0000bb"><?php <BR>ob_start</FONT><FONT color=#007700>(); </FONT></FONT><FONT face=新宋体><FONT color=#ff8000>//打开缓冲区 <BR></FONT><FONT color=#007700>echo </FONT><FONT color=#dd0000>"Hellon"</FONT><FONT color=#007700>; </FONT></FONT><FONT face=新宋体><FONT color=#ff8000>//输出 <BR></FONT><FONT color=#0000bb>header</FONT><FONT color=#007700>(</FONT><FONT color=#dd0000>"location:index.php"</FONT><FONT color=#007700>); </FONT></FONT><FONT face=新宋体><FONT color=#ff8000>//把浏览器重定向到index.php <BR></FONT><FONT color=#0000bb>ob_end_flush</FONT><FONT color=#007700>();</FONT></FONT><FONT face=新宋体><FONT color=#ff8000>//输出全部内容到浏览器 <BR></FONT><FONT color=#0000bb>?></font> </font></font>

所有对header()函数有了解的人都知道，这个函数会发送一段文件头给浏览器，但是如果在使用这个函数之前已经有了任何输出（包括空输出，比如空格，回车和换行）就会提示出错。如果我们去掉第一行的ob_start()，再执行此程序，我们会发现得到了一条错误提示：“Header had all ready send by”！但是加上ob_start，就不会提示出错，原因是当打开了缓冲区，echo后面的字符不会输出到浏览器，而是保留在服务器，直到你使用 flush或者ob_end_flush才会输出，所以并不会有任何文件头输出的错误！

一、相关函数简介
1、Flush：刷新缓冲区的内容，输出。
函数格式：flush()
说明：这个函数经常使用，效率很高。

2、ob_start ：打开输出缓冲区
函数格式：void ob_start(void)
说明：当缓冲区激活时，所有来自PHP程序的非文件头信息均不会发送，而是保存在内部缓冲区。为了输出缓冲区的内容，可以使用ob_end_flush()或flush()输出缓冲区的内容。

3 、ob_get_contents ：返回内部缓冲区的内容。
使用方法：string ob_get_contents(void)
说明：这个函数会返回当前缓冲区中的内容，如果输出缓冲区没有激活，则返回 FALSE 。

4、ob_get_length：返回内部缓冲区的长度。
使用方法：int ob_get_length(void)
说明：这个函数会返回当前缓冲区中的长度；和ob_get_contents一样，如果输出缓冲区没有激活。则返回 FALSE。

5、ob_end_flush ：发送内部缓冲区的内容到浏览器，并且关闭输出缓冲区。
使用方法：void ob_end_flush(void)
说明：这个函数发送输出缓冲区的内容（如果有的话）。

6、ob_end_clean：删除内部缓冲区的内容，并且关闭内部缓冲区
使用方法：void ob_end_clean(void)
说明：这个函数不会输出内部缓冲区的内容而是把它删除！

7、ob_implicit_flush：打开或关闭绝对刷新
使用方法：void ob_implicit_flush ([int flag])
说明：使用过Perl的人都知道$|=x的意义，这个字符串可以打开/关闭缓冲区，而ob_implicit_flush函数也和那个一样，默认为关闭缓冲区，打开绝对输出后，每个脚本输出都直接发送到浏览器，不再需要调用 flush()

二、深入了解

1. 关于Flush函数：
这个函数在PHP3中就出现了，是一个效率很高的函数，他有一个非常有用的功能就是刷新browser的cache.我们举一个运行效果非常明显的例子来说明flush.
Example 2.

<font color="#000000"><font face="新宋体"><font color="#0000bb"><?php <BR></FONT><FONT color=#007700>for(</FONT><FONT color=#0000bb>$i </FONT><FONT color=#007700>= </FONT><FONT color=#0000bb>1</FONT><FONT color=#007700>; </FONT><FONT color=#0000bb>$i </FONT><FONT color=#007700><= </FONT><FONT color=#0000bb>300</FONT><FONT color=#007700>; </FONT><FONT color=#0000bb>$i</FONT><FONT color=#007700>++) print(</FONT><FONT color=#dd0000>" "</FONT></FONT><FONT face=新宋体 color=#007700>); <BR></FONT><FONT face=新宋体><FONT color=#ff8000>// 这一句话非常关键，cache的结构使得它的内容只有达到一定的大小才能从浏览器里输出 <BR>// 换言之，如果cache的内容不达到一定的大小，它是不会在程序执行完毕前输出的。经 <BR>// 过测试，我发现这个大小的底限是256个字符长。这意味着cache以后接收的内容都会 <BR>// 源源不断的被发送出去。 <BR></FONT><FONT color=#007700>for(</FONT><FONT color=#0000bb>$j </FONT><FONT color=#007700>= </FONT><FONT color=#0000bb>1</FONT><FONT color=#007700>; </FONT><FONT color=#0000bb>$j </FONT><FONT color=#007700><= </FONT><FONT color=#0000bb>20</FONT><FONT color=#007700>; </FONT><FONT color=#0000bb>$j</FONT></FONT><FONT face=新宋体><FONT color=#007700>++) { <BR>        echo </FONT><FONT color=#0000bb>$j </FONT><FONT color=#007700>. </FONT></FONT><FONT face=新宋体 color=#dd0000>" <BR>        "</FONT><FONT face=新宋体><FONT color=#007700>; <BR>        </FONT><FONT color=#0000bb>flush</FONT><FONT color=#007700>(); </FONT></FONT><FONT face=新宋体><FONT color=#ff8000>//这一部会使cache新增的内容被挤出去，显示到浏览器上 <BR>        </FONT><FONT color=#0000bb>sleep</FONT><FONT color=#007700>(</FONT><FONT color=#0000bb>1</FONT><FONT color=#007700>); </FONT></FONT><FONT face=新宋体 color=#ff8000>//让程序"睡"一秒钟，会让你把效果看得更清楚 <BR></FONT><FONT face=新宋体><FONT color=#007700>} <br><br></FONT><FONT color=#0000bb>?></font> </font></font>

具体效果你可以到这里看看http://www.php2000.com/~uchinaboy/out.php
PHP2000的最新的PHP聊天室就是用的这个技术，可惜的是源代码未公开 L
注：如果在程序的首部加入ob_implicit_flush()打开绝对刷新,就可以在程序中不再使用flush(),这样做的好处是：提高效率！

2. 关于ob系列函数：
我想先引用我的好朋友y10k的一个例子：
Example 3.
比如你用得到服务器和客户端的设置信息，但是这个信息会因为客户端的不同而不同，如果想要保存phpinfo()函数的输出怎么办呢？在没有缓冲区控制之前，可以说一点办法也没有，但是有了缓冲区的控制，我们可以轻松的解决：

<font color="#000000"><font face="新宋体"><font color="#0000bb"><?php <BR>ob_start</FONT><FONT color=#007700>(); </FONT></FONT><FONT face=新宋体><FONT color=#ff8000>//打开缓冲区 <BR></FONT><FONT color=#0000bb>phpinfo</FONT><FONT color=#007700>(); </FONT></FONT><FONT face=新宋体><FONT color=#ff8000>//使用phpinfo函数 <BR></FONT><FONT color=#0000bb>$info </FONT><FONT color=#007700>= </FONT><FONT color=#0000bb>ob_get_contents</FONT><FONT color=#007700>(); </FONT></FONT><FONT face=新宋体><FONT color=#ff8000>//得到缓冲区的内容并且赋值给$info <BR></FONT><FONT color=#0000bb>$file </FONT><FONT color=#007700>= </FONT><FONT color=#0000bb>fopen</FONT><FONT color=#007700>(</FONT><FONT color=#dd0000>'info.txt'</FONT><FONT color=#007700>, </FONT><FONT color=#dd0000>'w'</FONT><FONT color=#007700>); </FONT></FONT><FONT face=新宋体><FONT color=#ff8000>//打开文件info.txt <BR></FONT><FONT color=#0000bb>fwrite</FONT><FONT color=#007700>(</FONT><FONT color=#0000bb>$file</FONT><FONT color=#007700>, </FONT><FONT color=#0000bb>$info</FONT><FONT color=#007700>); </FONT></FONT><FONT face=新宋体><FONT color=#ff8000>//写入信息到info.txt <BR></FONT><FONT color=#0000bb>fclose</FONT><FONT color=#007700>(</FONT><FONT color=#0000bb>$file</FONT><FONT color=#007700>); </FONT></FONT><FONT face=新宋体><FONT color=#ff8000>//关闭文件info.txt <br><br></FONT><FONT color=#0000bb>?></font> </font></font>

用以上的方法，就可以把不同用户的phpinfo信息保存下来，这在以前恐怕没有办法办到！其实上面就是将一些“过程”转化为“函数”的方法！
或许有人会问：“难道就这个样子吗？还有没有其他用途？”当然有了，比如笔者论坛的PHP 语法加亮显示就和这个有关（PHP默认的语法加亮显示函数会直接输出，不能保存结果，如果在每次调用都显示恐怕会很浪费CPU，笔者的论坛就把语法加亮函数显示的结果用控制缓冲区的方法保留了），大家如果感兴趣的话可以来看看http://www.zphp.com/bbs/！

可能现在大家对ob_start()的功能有了一定的了解，上面的一个例子看似简单，但实际上已经掌握了使用ob_start()的要点。
<1>.使用ob_start打开browser的cache，这样可以保证cache的内容在你调用flush(),ob_end_flush()（或程序执行完毕）之前不会被输出。
<2>.现在的你应该知道你所拥有的优势：可以在任何输出内容后面使用header,setcookie以及session，这是 ob_start一个很大的特点；也可以使用ob_start的参数，在cache被写入后，然后自动运行命令，比如ob_start ("ob_gzhandler")；而我们最常用的做法是用ob_get_contents()得到cache中的内容，然后再进行处理……
<3>.当处理完毕后，我们可以使用各种方法输出，flush(),ob_end_flush(),以及等到程序执行完毕后的自动输出。当然，如果你用的是ob_get_contents()，那么就要你自己控制输出方式了。

来，让我们看看能用ob系列函数做些什么……

（一）、静态模版技术

简介：所谓静态模版技术就是通过某种方式，使得用户在client端得到的是由PHP产生的html页面。如果这个html页面不会再被更新，那么当另外的用户再次浏览此页面时，程序将不会再调用PHP以及相关的数据库，对于某些信息量比较大的网站，例如sina,163,sohu。类似这种的技术带来的好处是非常巨大的。

我所知道的实现静态输出的有两种办法：
<1>.通过y10k修改的phplib的一个叫template.inc.php类实现。
<2>.使用ob系列函数实现。
对于第一种方法，因为不是这篇文章所要研究的问题，所以不再赘述。
我们现在来看一看第二种方法的具体实现：
Example 4.

<font color="#000000"><font face="新宋体"><font color="#0000bb"><?php <BR>ob_start</FONT><FONT color=#007700>();</FONT></FONT><FONT face=新宋体><FONT color=#ff8000>//打开缓冲区 <BR></FONT><FONT color=#0000bb>?></font> </font></font>

php页面的全部输出

<font color="#000000"><font face="新宋体"><font color="#0000bb"><?php <BR>$content </FONT><FONT color=#007700>= </FONT><FONT color=#0000bb>ob_get_contents</FONT><FONT color=#007700>(); </FONT></FONT><FONT face=新宋体><FONT color=#ff8000>//取得php页面输出的全部内容 <BR></FONT><FONT color=#0000bb>$fp </FONT><FONT color=#007700>= </FONT><FONT color=#0000bb>fopen</FONT><FONT color=#007700>(</FONT><FONT color=#dd0000>"output00001 . html"</FONT><FONT color=#007700>, </FONT><FONT color=#dd0000>"w"</FONT><FONT color=#007700>); </FONT></FONT><FONT face=新宋体><FONT color=#ff8000>//创建一个文件，并打开，准备写入 <BR></FONT><FONT color=#0000bb>fwrite</FONT><FONT color=#007700>(</FONT><FONT color=#0000bb>$fp</FONT><FONT color=#007700>, </FONT><FONT color=#0000bb>$content</FONT><FONT color=#007700>); </FONT></FONT><FONT face=新宋体><FONT color=#ff8000>//把php页面的内容全部写入output00001.html，然后…… <BR></FONT><FONT color=#0000bb>fclose</FONT><FONT color=#007700>(</FONT><FONT color=#0000bb>$fp</FONT></FONT><FONT face=新宋体><FONT color=#007700>); <BR></FONT><FONT color=#0000bb>?></font> </font></font>

这样，所谓的静态模版就很容易的被实现了……

（二）、捕捉输出

以上的Example 4.是一种最简单的情况，你还可以在写入前对$content进行操作……
你可以设法捕捉一些关键字，然后去对它进行再处理，比如Example 3.所述的PHP语法高亮显示。个人认为，这个功能是此函数最大的精华所在，它可以解决各种各样的问题，但需要你有足够的想象力……
Example 5.

<font color="#000000"><font face="新宋体"><font color="#0000bb"><?php <BR></FONT><FONT color=#007700>function </FONT><FONT color=#0000bb>run_code</FONT><FONT color=#007700>(</FONT><FONT color=#0000bb>$code</FONT></FONT><FONT face=新宋体><FONT color=#007700>) { <BR>        If (</FONT><FONT color=#0000bb>$code</FONT></FONT><FONT face=新宋体><FONT color=#007700>) { <BR>                </FONT><FONT color=#0000bb>ob_start</FONT></FONT><FONT face=新宋体><FONT color=#007700>(); <BR>                eval(</FONT><FONT color=#0000bb>$code</FONT></FONT><FONT face=新宋体><FONT color=#007700>); <BR>                </FONT><FONT color=#0000bb>$contents </FONT><FONT color=#007700>= </FONT><FONT color=#0000bb>ob_get_contents</FONT></FONT><FONT face=新宋体><FONT color=#007700>(); <BR>                </FONT><FONT color=#0000bb>ob_end_clean</FONT></FONT><FONT face=新宋体><FONT color=#007700>(); <BR>        } else { <BR>                echo </FONT><FONT color=#dd0000>"错误！没有输出"</FONT></FONT><FONT face=新宋体><FONT color=#007700>; <BR>                exit(); <BR>        } <BR>        return </FONT><FONT color=#0000bb>$contents</FONT></FONT><FONT face=新宋体><FONT color=#007700>; <BR>} <br><br></FONT><FONT color=#0000bb>?></font> </font></font>

以上这个例子的用途不是很大，不过很典型$code的本身就是一个含有变量的输出页面，而这个例子用eval把$code中的变量替换，然后对输出结果再进行输出捕捉，再一次的进行处理……

Example 6. 加快传输

<font color="#000000"><font face="新宋体" color="#0000bb"><?php <BR></FONT><FONT face=新宋体><FONT color=#ff8000>/* <BR>** Title.........: PHP4 HTTP Compression Speeds up the Web <BR>** Version.......: 1.20 <BR>** Author........: catoc <catoc@163.net> <br>** Filename......: gzdoc.php <br>** Last changed..: 18/10/2000 <br>** Requirments...: PHP4 >= 4.0.1 <br>** PHP was configured with --with-zlib[=DIR] <br>** Notes.........: Dynamic Content Acceleration compresses <br>** the data transmission data on the fly <br>** code by sun jin hu (catoc) <catoc@163.net> <br>** Most newer browsers since 1998/1999 have <br>** been equipped to support the HTTP 1.1 <br>** standard known as "content-encoding." <br>** Essentially the browser indicates to the <br>** server that it can accept "content encoding" <br>** and if the server is capable it will then <br>** compress the data and transmit it. The <br>** browser decompresses it and then renders <br>** the page. <br>** <br>** Modified by John Lim (jlim@natsoft.com.my) <br>** based on ideas by Sandy McArthur, Jr <br>** Usage........: <br>** No space before the beginning of the first '<?' tag. <BR>** ------------Start of file---------- <BR>** |<? <BR>** | include('gzdoc.php'); <BR>** |? > <br>** |<HTML> <br>** |... the page ... <br>** |</HTML> <br>** |<? <BR>** | gzdocout(); <BR>** |? > <br>** -------------End of file----------- <br>*/ <br></font><font color="#0000bb">ob_start</font></font><font face="新宋体"><font color="#007700">(); <br></font><font color="#0000bb">ob_implicit_flush</font><font color="#007700">(</font><font color="#0000bb">0</font></font><font face="新宋体"><font color="#007700">); <br>function </font><font color="#0000bb">CheckCanGzip</font></font><font face="新宋体"><font color="#007700">() { <br>        global </font><font color="#0000bb">$HTTP_ACCEPT_ENCODING</font></font><font face="新宋体"><font color="#007700">; <br>        if (</font><font color="#0000bb">headers_sent</font><font color="#007700">() || </font><font color="#0000bb">connection_timeout</font><font color="#007700">() || </font><font color="#0000bb">connection_aborted</font></font><font face="新宋体"><font color="#007700">()) { <br>                return </font><font color="#0000bb">0</font></font><font face="新宋体"><font color="#007700">; <br>        } <br>        if (</font><font color="#0000bb">strpos</font><font color="#007700">(</font><font color="#0000bb">$HTTP_ACCEPT_ENCODING</font><font color="#007700">, </font><font color="#dd0000">'x-gzip'</font><font color="#007700">) !== </font><font color="#0000bb">false</font><font color="#007700">) return </font><font color="#dd0000">"x-gzip"</font></font><font face="新宋体"><font color="#007700">; <br>        if (</font><font color="#0000bb">strpos</font><font color="#007700">(</font><font color="#0000bb">$HTTP_ACCEPT_ENCODING</font><font color="#007700">, </font><font color="#dd0000">'gzip'</font><font color="#007700">) !== </font><font color="#0000bb">false</font><font color="#007700">) return </font><font color="#dd0000">"gzip"</font></font><font face="新宋体"><font color="#007700">; <br>        return </font><font color="#0000bb">0</font></font><font face="新宋体" color="#007700">; <br>}<br></font><font face="新宋体"><font color="#ff8000">/* $level = compression level 0-9, 0=none, 9=max */ <br></font><font color="#007700">function </font><font color="#0000bb">GzDocOut</font><font color="#007700">(</font><font color="#0000bb">$level </font><font color="#007700">= </font><font color="#0000bb">1</font><font color="#007700">, </font><font color="#0000bb">$debug </font><font color="#007700">= </font><font color="#0000bb">0</font></font><font face="新宋体"><font color="#007700">) { <br>        </font><font color="#0000bb">$ENCODING </font><font color="#007700">= </font><font color="#0000bb">CheckCanGzip</font></font><font face="新宋体"><font color="#007700">(); <br>        if (</font><font color="#0000bb">$ENCODING</font></font><font face="新宋体"><font color="#007700">) { <br>                print </font><font color="#dd0000">"n<!-- Use compress $ENCODING -->n"</font></font><font face="新宋体"><font color="#007700">; <br>                </font><font color="#0000bb">$Contents </font><font color="#007700">= </font><font color="#0000bb">ob_get_contents</font></font><font face="新宋体"><font color="#007700">(); <br>                </font><font color="#0000bb">ob_end_clean</font></font><font face="新宋体"><font color="#007700">(); <br>                if (</font><font color="#0000bb">$debug</font></font><font face="新宋体"><font color="#007700">) { <br>                        </font><font color="#0000bb">$s </font><font color="#007700">= </font><font color="#dd0000">"<p>Not compress length: " </font><font color="#007700">. </font><font color="#0000bb">strlen</font><font color="#007700">(</font><font color="#0000bb">$Contents</font></font><font face="新宋体"><font color="#007700">); <br>                        </font><font color="#0000bb">$s </font><font color="#007700">.= </font><font color="#dd0000">"Compressed length: " </font><font color="#007700">. </font><font color="#0000bb">strlen</font><font color="#007700">(</font><font color="#0000bb">gzcompress</font><font color="#007700">(</font><font color="#0000bb">$Contents</font><font color="#007700">, </font><font color="#0000bb">$level</font></font><font face="新宋体"><font color="#007700">)); <br>                        </font><font color="#0000bb">$Contents </font><font color="#007700">.= </font><font color="#0000bb">$s</font></font><font face="新宋体"><font color="#007700">; <br>                }<br>                </font><font color="#0000bb">header</font><font color="#007700">(</font><font color="#dd0000">"Content-Encoding: $ENCODING"</font></font><font face="新宋体"><font color="#007700">); <br>                print </font><font color="#dd0000">"x1fx8bx08x00x00x00x00x00"</font></font><font face="新宋体"><font color="#007700">; <br>                </font><font color="#0000bb">$Size </font><font color="#007700">= </font><font color="#0000bb">strlen</font><font color="#007700">(</font><font color="#0000bb">$Contents</font></font><font face="新宋体"><font color="#007700">); <br>                </font><font color="#0000bb">$Crc </font><font color="#007700">= </font><font color="#0000bb">crc32</font><font color="#007700">(</font><font color="#0000bb">$Contents</font></font><font face="新宋体"><font color="#007700">); <br>                </font><font color="#0000bb">$Contents </font><font color="#007700">= </font><font color="#0000bb">gzcompress</font><font color="#007700">(</font><font color="#0000bb">$Contents</font><font color="#007700">, </font><font color="#0000bb">$level</font></font><font face="新宋体"><font color="#007700">); <br>                </font><font color="#0000bb">$Contents </font><font color="#007700">= </font><font color="#0000bb">substr</font><font color="#007700">(</font><font color="#0000bb">$Contents</font><font color="#007700">, </font><font color="#0000bb">0</font><font color="#007700">, </font><font color="#0000bb">strlen</font><font color="#007700">(</font><font color="#0000bb">$Contents</font><font color="#007700">) - </font><font color="#0000bb">4</font></font><font face="新宋体"><font color="#007700">); <br>                print </font><font color="#0000bb">$Contents</font></font><font face="新宋体"><font color="#007700">; <br>                print </font><font color="#0000bb">pack</font><font color="#007700">(</font><font color="#dd0000">'V'</font><font color="#007700">, </font><font color="#0000bb">$Crc</font></font><font face="新宋体"><font color="#007700">); <br>                print </font><font color="#0000bb">pack</font><font color="#007700">(</font><font color="#dd0000">'V'</font><font color="#007700">, </font><font color="#0000bb">$Size</font></font><font face="新宋体"><font color="#007700">); <br>                exit; <br>        } else { <br>                </font><font color="#0000bb">ob_end_flush</font></font><font face="新宋体"><font color="#007700">(); <br>                exit; <br>        } <br>} <br><br></font><font color="#0000bb">?></font> </font>

这是catoc的一段很早以前的代码，是在weblogs.com看到的，他利用了zlib的函数，对传输的内容进行了压缩，测试表明，对于10k以上的页面，会产生效果，而且页面越大，效果越明显……