深入理解PHP中的Streams工具

              本文重点:深入理解PHP中的Streams工具

              每个Streams对象都有一个包装类,在包装中可以添加处理特殊协议和编码的相关代码。

              PHP中已经内置了一些常用的包装类,我们也可以创建和注册自定义的包装类。

              我们甚至能够使用现有的context和filter对包装类进行修改和增强。 Stream基础知识Stream可以通过scheme://target方式来引用。 其中scheme是包装类的名字,target中的内容是由包装类的语法指定,不同的包装类的语法会有所不同。 PHP默认的包装类是file://,也就是说我们在访问文件系统的时候,其实就是在使用一个stream。 我们可以通过下面两种方式来读取文件中的内容,readfile(/path/to/)或者readfile(file:///path/to/),这两种方式是等效的。 如果你是使用readfile(http:///),那么PHP会选取HTTPstream包装类来进行操作。

              正如上文所述,PHP提供了不少内建的包转类,protocol以及filter。 按照下文所述的方式,可以查询到本机所支持的包装类:phpprint_r(stream_get_transports());print_r(stream_get_wrappers());print_r(stream_get_filters());在我机器上的输出结果为:Array([0]=tcp[1]=udp[2]=unix[3]=udg[4]=ssl[5]=sslv3[6]=sslv2[7]=tls)Array([0]=https[1]=ftps[2]=[3]=[4]=php[5]=file[6]=glob[7]=data[8]=http[9]=ftp[10]=zip[11]=phar)Array([0]=zlib.*[1]=bzip2.*[2]=*[3]=[4]=[5]=[6]=_tags[7]=convert.*[8]=consumed[9]=dechunk[10]=mcrypt.*[11]=mdecrypt.*)提供的功能非常多,看上去还不错吧?除了上述内建的Stream,我们还可以为AmazonS3,MSExcel,GoogleStorage,Dropbox甚至Twitter编写更多的第三方的Stream。 php://包装类PHP中内建了本语言用于处理I/Ostream的包装类。 可以分为几类,基础的有php://stdin,php://stdout,以及php://stderr,这3个stream分别映射到默认的I/O资源。 同时PHP还提供了php://input,通过这个包装类可以使用只读的方式访问POST请求中的rawbody。

              这是一项非常有用的功能,特别是在处理那些将数据负载嵌入到POST请求中的远程服务时。

              下面我们使用cURL工具来做一个简单的测试:curl-dHelloWorld-dfoo=barname=Johnhttp://localhost/dev/streams/php_在PHP脚本中使用print_r($_POST)的测试结果如下所示:Array([foo]=bar[name]=John)我们注意$_POSTarray中是无法访问到第一项数据的。

              但是如果我们使用readfile(php://input),结果就不同了:HelloWorldfoo=barname=又增加了php://memory和php://tempstream这两个包转类,用于读写临时数据。 正如包装类命名中所暗示的,这些数据被存储在底层系统中的内存或者临时文件中。

              php://filter是一个元包装类,用于为stream增加filter功能。 在使用readfile()或者file_get_contents()/stream_get_contents()打开stream时,filter将被使能。

              下面是一个例子:php//Writeencodeddatafile_put_contents(php://filter/write=/resource=file:///path/to/,HelloWorld);//Readdataandencode/decodereadfile(php://filter/read=|/resource=http://);在第一个例子中使用了一个filter来对保存到磁盘中的数据进行编码处理,在二个例子中,使用两个级联的filter来从远端的URL读取数据。

              使用filter能为你的应用带来极为强大的功能。

              Stream上下文context是一组stream相关的参数或选项,使用context可以修改或增强包装类的行为。 例如使用context来修改HTTP包装器是一个常用到的使用场景。

              这样我们就可以不使用cURL工具,就能完成一些简单的网络操作。

              下面是一个例子:php$opts=array(http=array(method=POST,header=Auth::application/:.strlen(HelloWorld),content=HelloWorld));$default=stream_context_get_default($opts);readfile(http://localhost/dev/streams/php_首先要定义一个optionsarray,这是个二位数组,可以通过$array[wrapper][option_name]的形式来访问其中的参数。 (注意每个包装类中context的options是不同的)。

              然后调用stream_context_get_default()来设置这些option,stream_context_get_default()同时还会将默认的context作为结果返回回来。 设置完成后,接下来调用readfile(),就会应用刚才设置好的context来抓取内容。

              在上面的例子中,内容被嵌入到request的body中,这样远端的脚本就可以使用php://input来读取这些内容。 同时,我们还能使用apache_request_headers()来获取request的header,如下所示:Array([Host]=localhost[Auth]=SecretAuthToken[Content-type]=application/x-www-form-urlencoded[Content-length]=11)在上面的例子中是修改默认context的参数,当然我们也可以创建一个新的context,进行交替使用。

              php$alternative=stream_context_create($other_opts);readfile(http://localhost/dev/streams/php_,false,$alternative);结论我们怎样在现实世界中驾驭stream的强大力量呢?使用stream能为我们的程序带来什么现实的好处?正如前文介绍的那样,stream对所有文件系统相关的功能进行了抽象,所以我第一个想到的应用场景是使用虚拟文件系统的包装类来访问PaaS供应商提供的服务,比如说访问HeroKu或者AppFog,它们实际上都没有真正文件系统。 使用stream只要对我们的应用程序稍作修改,就可以将其移植到云端。

              接下来--在我的下一篇文章中--我将介绍如何编写自定义的包装类以实现对特殊文件格式和编码格式的操作。