Streams 是PHP提供的一個(gè)強(qiáng)有力的工具，我們常常在不經(jīng)意會(huì)使用到它，如果善加利用將大大提高PHP的生產(chǎn)力。 駕馭Streams的強(qiáng)大力量后，應(yīng)用程序?qū)⑻嵘揭粋€(gè)新的高度。

下面是PHP手冊(cè)中對(duì)Streams的一段描述：

每個(gè)Streams對(duì)象都有一個(gè)包裝類，在包裝中可以添加處理特殊協(xié)議和編碼的相關(guān)代碼。PHP中已經(jīng)內(nèi)置了一些常用的包裝類，我們也可以創(chuàng)建和注冊(cè)自定義的包裝類。我們甚至能夠使用現(xiàn)有的context和filter對(duì)包裝類進(jìn)行修改和增強(qiáng)。

Stream 基礎(chǔ)知識(shí)

Stream 可以通過<scheme>://<target>方式來(lái)引用。其中<scheme>是包裝類的名字，<target>中的內(nèi)容是由包裝類的語(yǔ)法指定，不同的包裝類的語(yǔ)法會(huì)有所不同。

PHP默認(rèn)的包裝類是file://，也就是說(shuō)我們?cè)谠L問文件系統(tǒng)的時(shí)候，其實(shí)就是在使用一個(gè)stream。我們可以通過下面兩種方式來(lái)讀取文件中的內(nèi)容，readfile('/path/to/somefile.txt')或者readfile('file:///path/to/somefile.txt')，這兩種方式是等效的。如果你是使用readfile('http://google.com/')，那么PHP會(huì)選取HTTP stream包裝類來(lái)進(jìn)行操作。

正如上文所述，PHP提供了不少內(nèi)建的包轉(zhuǎn)類，protocol以及filter。 按照下文所述的方式，可以查詢到本機(jī)所支持的包裝類：

<?php 
print_r(stream_get_transports()); 
print_r(stream_get_wrappers()); 
print_r(stream_get_filters()); 

在我機(jī)器上的輸出結(jié)果為：

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.* 
) 

提供的功能非常多，看上去還不錯(cuò)吧？

除了上述內(nèi)建的Stream，我們還可以為 Amazon S3, MS Excel, Google Storage, Dropbox 甚至Twitter編寫更多的第三方的Stream。

php:// 包裝類

PHP中內(nèi)建了本語(yǔ)言用于處理I/O stream的包裝類?？梢苑譃閹最悾A(chǔ)的有php://stdin,php://stdout, 以及php://stderr，這3個(gè)stream分別映射到默認(rèn) 的I/O資源。同時(shí)PHP還提供了php://input，通過這個(gè)包裝類可以使用只讀的方式訪問POST請(qǐng)求中的raw body。 這是一項(xiàng)非常有用的功能，特別是在處理那些將數(shù)據(jù)負(fù)載嵌入到POST請(qǐng)求中的遠(yuǎn)程服務(wù)時(shí)。

下面我們使用cURL工具來(lái)做一個(gè)簡(jiǎn)單的測(cè)試：

curl -d "Hello World" -d "foo=bar&name=John" http://localhost/dev/streams/php_input.php 

在PHP腳本中使用print_r($_POST)的測(cè)試結(jié)果如下所示：

Array 
( 
    [foo] => bar 
    [name] => John 
) 

我們注意$_POST array中是無(wú)法訪問到第一項(xiàng)數(shù)據(jù)的。但是如果我們使用readfile('php://input')，結(jié)果就不同了：

Hello World&foo=bar&name=John 

PHP 5.1又增加了php://memory和php://tempstream這兩個(gè)包轉(zhuǎn)類，用于讀寫臨時(shí)數(shù)據(jù)。正如包裝類命名中所暗示的，這些數(shù)據(jù)被存儲(chǔ)在底層系統(tǒng)中的內(nèi)存或者臨時(shí)文件中。 

php://filter是一個(gè)元包裝類，用于為stream增加filter功能。在使用readfile()或者file_get_contents()/stream_get_contents()打開stream時(shí)，filter將被使能。下面是一個(gè)例子：

<?php 
// Write encoded data 
file_put_contents("php://filter/write=string.rot13/resource=file:///path/to/somefile.txt","Hello World"); 
  
// Read data and encode/decode 
readfile("php://filter/read=string.toupper|string.rot13/resource=http://www.google.com"); 

在第一個(gè)例子中使用了一個(gè)filter來(lái)對(duì)保存到磁盤中的數(shù)據(jù)進(jìn)行編碼處理，在二個(gè)例子中，使用兩個(gè)級(jí)聯(lián)的filter來(lái)從遠(yuǎn)端的URL讀取數(shù)據(jù)。使用filter能為你的應(yīng)用帶來(lái)極為強(qiáng)大的功能。

Stream上下文

context是一組stream相關(guān)的參數(shù)或選項(xiàng)，使用context可以修改或增強(qiáng)包裝類的行為。例如使用context來(lái)修改HTTP包裝器是一個(gè)常用到的使用場(chǎng)景。 這樣我們就可以不使用cURL工具，就能完成一些簡(jiǎn)單的網(wǎng)絡(luò)操作。下面是一個(gè)例子：

<?php 
$opts = array( 
  'http'=>array( 
    'method'=>"POST", 
    'header'=> "Auth: SecretAuthTokenrn" . 
        "Content-type: application/x-www-form-urlencodedrn" . 
              "Content-length: " . strlen("Hello World"), 
    'content' => 'Hello World' 
  ) 
); 
$default = stream_context_get_default($opts); 
readfile('http://localhost/dev/streams/php_input.php'); 

首先要定義一個(gè)options array,這是個(gè)二位數(shù)組，可以通過$array['wrapper']['option_name']的形式來(lái)訪問其中的參數(shù)。（注意每個(gè)包裝類中context的options是不同的）。然后調(diào)用stream_context_get_default()來(lái)設(shè)置這些option,stream_context_get_default()同時(shí)還會(huì)將默認(rèn)的context作為結(jié)果返回回來(lái)。設(shè)置完成后，接下來(lái)調(diào)用readfile()，就會(huì)應(yīng)用剛才設(shè)置好的context來(lái)抓取內(nèi)容。

在上面的例子中，內(nèi)容被嵌入到request的body中，這樣遠(yuǎn)端的腳本就可以使用php://input來(lái)讀取這些內(nèi)容。同時(shí)，我們還能使用apache_request_headers()來(lái)獲取request的header，如下所示：

Array 
( 
    [Host] => localhost 
    [Auth] => SecretAuthToken 
    [Content-type] => application/x-www-form-urlencoded 
    [Content-length] => 11 
) 

在上面的例子中是修改默認(rèn)context的參數(shù)，當(dāng)然我們也可以創(chuàng)建一個(gè)新的context,進(jìn)行交替使用。

<?php 
$alternative = stream_context_create($other_opts); 
readfile('http://localhost/dev/streams/php_input.php', false, $alternative); 

結(jié)論

我們?cè)鯓釉诂F(xiàn)實(shí)世界中駕馭stream的強(qiáng)大力量呢？使用stream能為我們的程序帶來(lái)什么現(xiàn)實(shí)的好處？ 正如前文介紹的那樣，stream對(duì)所有文件系統(tǒng)相關(guān)的功能進(jìn)行了抽象，所以我第一個(gè)想到的應(yīng)用場(chǎng)景是使用虛擬文件系統(tǒng)的包裝類來(lái)訪問PaaS供應(yīng)商提供的服務(wù)，比如說(shuō)訪問HeroKu或者AppFog，它們實(shí)際上都沒有真正文件系統(tǒng)。 使用stream只要對(duì)我們的應(yīng)用程序稍作修改，就可以將其移植到云端。 接下來(lái)--在我的下一篇文章中--我將介紹如何編寫自定義的包裝類以實(shí)現(xiàn)對(duì)特殊文件格式和編碼格式的操作。