Streams 是PHP提供的一个强有力的工具,我们常常在不经意会使用到它,如果善加利用将大大提高PHP的生产力。 驾驭Streams的强大力量后,应用程序将提升到一个新的高度。
下面是PHP手册中对Streams的一段描述:
Streams 是在PHP 4.3.0版本被引入的,它被用于统一文件、网络、数据压缩等类文件的操作方式,为这些类文件操作提供了一组通用的函数接口。简而言之,一个stream就是一个具有流式行为的资源对象。也就是说,我们可以用线性的方式来对stream进行读取和写入。并且可以用使用fseek()来跳转到stream内的任意位置。
每个Streams对象都有一个包装类,在包装中可以添加处理特殊协议和编码的相关代码。PHP中已经内置了一些常用的包装类,我们也可以创建和注册自定义的包装类。我们甚至能够使用现有的context和filter对包装类进行修改和增强。
Stream 基础知识Stream 可以通过<scheme>://<target>方式来引用。其中<scheme>是包装类的名字,<target>中的内容是由包装类的语法指定,不同的包装类的语法会有所不同。
PHP默认的包装类是file://,也就是说我们在访问文件系统的时候,其实就是在使用一个stream。我们可以通过下面两种方式来读取文件中的内容,readfile('/path/to/somefile.txt')或者readfile('file:///path/to/somefile.txt'),这两种方式是等效的。如果你是使用readfile('http://google.com/'),那么PHP会选取HTTP stream包装类来进行操作。
正如上文所述,PHP提供了不少内建的包转类,PRotocol以及filter。 按照下文所述的方式,可以查询到本机所支持的包装类:
1234 | <?php print_r(stream_get_transports()); print_r(stream_get_wrappers()); print_r(stream_get_filters()); |
在我机器上的输出结果为:
1234567891011121314151617181920212223242526272829303132333435363738394041 | Array (
[0]=>tcp
[1]=>udp
[2]=>unix
[3]=>udg
[4]=>ssl
[5]=>sslv3
[6]=>sslv2
[7]=>tls ) Array (
[0]=>https
[1]=>ftps
[2]=>compress.zlib
[3]=>compress.bzip2
[4]=>php
[5]=>file
[6]=> glob
[7]=>data
[8]=>http
[9]=>ftp
[10]=>zip
[11]=>phar ) Array (
[0]=>zlib.*
[1]=>bzip2.*
[2]=>convert.iconv.*
[3]=>string.rot13
[4]=>string.toupper
[5]=>string.tolower
[6]=>string. strip_tags
[7]=>convert.*
[8]=>consumed
[9]=>dechunk
[10]=>mcrypt.*
[11]=>mdecrypt.* ) |
提供的功能非常多,看上去还不错吧?
除了上述内建的Stream,我们还可以为Amazon S3,MS Excel,Google Storage,Dropbox甚至Twitter编写更多的第三方的Stream。
php:// 包装类PHP中内建了本语言用于处理I/O stream的包装类。可以分为几类,基础的有php://stdin,php://stdout, 以及php://stderr,这3个stream分别映射到默认 的I/O资源。同时PHP还提供了php://input,通过这个包装类可以使用只读的方式访问POST请求中的raw body。 这是一项非常有用的功能,特别是在处理那些将数据负载嵌入到POST请求中的远程服务时。
下面我们使用cURL工具来做一个简单的测试:
1 | curl-d "HelloWorld" -d "foo=bar&name=John" <a href= "http://localhost/dev/streams/php_input.php" >http://localhost/dev/streams/php_input.php</a> |
在PHP脚本中使用print_r($_POST)的测试结果如下所示:
12345 | Array (
[foo]=>bar
[name]=>John ) |
我们注意$_POST array中是无法访问到第一项数据的。但是如果我们使用readfile('php://input'),结果就不同了:
1 | HelloWorld&foo=bar&name=John |
PHP 5.1又增加了php://memory和php://tempstream这两个包转类,用于读写临时数据。正如包装类命名中所暗示的,这些数据被存储在底层系统中的内存或者临时文件中。
php://filter是一个元包装类,用于为stream增加filter功能。在使用readfile()或者file_get_contents()/stream_get_contents()打开stream时,filter将被使能。下面是一个例子:
123456 | <?php //Writeencodeddata file_put_contents ( "php://filter/write=string.rot13/resource=file:///path/to/somefile.txt" , "HelloWorld" ); //Readdataandencode/decode readfile( "php://filter/read=string.toupper|string.rot13/resource=http://www.google.com" ); |
在第一个例子中使用了一个filter来对保存到磁盘中的数据进行编码处理,在二个例子中,使用两个级联的filter来从远端的URL读取数据。使用filter能为你的应用带来极为强大的功能。
Stream上下文context是一组stream相关的参数或选项,使用context可以修改或增强包装类的行为。例如使用context来修改HTTP包装器是一个常用到的使用场景。 这样我们就可以不使用cURL工具,就能完成一些简单的网络操作。下面是一个例子:
123456789101112 | <?php $opts = array (
'http' => array (
'method' => "POST" ,
'header' => "Auth:SecretAuthTokenrn" .
"Content-type:application/x-www-form-urlencodedrn" .
|