首頁 >後端開發 >php教程 >關於PHP中Streams工具的解析

關於PHP中Streams工具的解析

不言原創: 2018-06-21 10:21:361125瀏覽

這篇文章主要介紹了PHP中的Streams工具,主要用來處理PHP中的包裝類別,需要的朋友可以參考下

Streams 是PHP提供的一個強有力的工具，我們常常在不經意會使用到它，如果善加利用將大大提高PHP的生產力。駕馭Streams的強大力量後，應用程式將提升到一個新的高度。

以下是PHP手冊中對Streams的一段描述：

Streams 是在PHP 4.3.0版本中引入的，它被用於統一文件、網路、資料壓縮等類別檔案的操作方式，為這些類別檔案操作提供了一組通用的函數介面。簡而言之，一個stream就是一個具有串流行為的資源物件。也就是說，我們可以用線性的方式來對stream進行讀取和寫入。並且可以用使用fseek()來跳到stream內的任意位置。

每個Streams物件都有一個包裝類，在包裝中可以加入處理特殊協定和編碼的相關程式碼。 PHP中已經內建了一些常用的包裝類，我們也可以建立和註冊自訂的包裝類。我們甚至能夠使用現有的context和filter對包裝類別進行修改和增強。

Stream 基礎

Stream 可以透過e8ecf1fabecb2bbf3952eba1f0f8a7ec://b4bef09dd2761803871f1d83e55d08b2方式來引用。其中e8ecf1fabecb2bbf3952eba1f0f8a7ec是包裝類別的名字，b4bef09dd2761803871f1d83e55d08b2中的內容是由包裝類別的語法指定，不同的包裝類別的語法會有所不同。

PHP預設的包裝類別是file://，也就是說我們在存取檔案系統的時候，其實就是在使用一個stream。我們可以透過下面兩種方式來讀取檔案中的內容，readfile('/path/to/somefile.txt')或readfile('file:///path/to/somefile.txt')，這兩種方式是等效的。如果你是使用readfile('http://google.com/')，那麼PHP會選取HTTP stream包裝類別來進行操作。

如上文所述，PHP提供了不少內建的包轉類，protocol以及filter。依照下文所述的方式，可以查詢到本機所支援的包裝類別：

<?php
print_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] => 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工具來做一個簡單的測試：

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

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

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

我們注意$_POST array中是無法存取到第一項資料的。但如果我們使用readfile('php://input')，結果就不同了：

Hello World&foo=bar&name=John

PHP 5.1又增加了php:/ /memory和php://tempstream這兩個包轉類，用來讀寫暫存資料。正如包裝類別命名中所暗示的，這些資料被儲存在底層系統中的記憶體或暫存檔案中。

php://filter是一個元包裝類，用於為stream增加filter功能。使用readfile()或file_get_contents()/stream_get_contents()開啟stream時，filter將會被啟用。以下是一個例子：

<?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");

在第一個範例中使用了一個filter來對儲存到磁碟中的資料進行編碼處理，在二個例子中，使用兩個級聯的filter來從遠端的URL讀取資料。使用filter能為你的應用程式帶來極為強大的功能。

Stream上下文

context是一組stream相關的參數或選項，使用context可以修改或增強包裝類別的行為。例如使用context來修改HTTP包裝器是常用來的使用場景。這樣我們就可以不使用cURL工具，就能完成一些簡單的網路操作。以下是一個範例：

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

首先要定義一個options array,這是一個二位數群組，可以透過$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(&#39;http://localhost/dev/streams/php_input.php&#39;, false, $alternative);

结论

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

以上就是本文的全部内容，希望对大家的学习有所帮助，更多相关内容请关注PHP中文网！

關於PHP中Streams工具的解析

相關文章