PHP Streams是內置核心操作,可能一般的開發者很少用,它用於統一文件、網絡、數據壓縮等類文件操作方式,並為這些類文件操作提供一組通用的函數接口。
一個stream就是一個具有流式行為的資源對象,每個stream對象都有一個包裝類。Stream 可以通過<scheme>://<target>方式來引用。其中<scheme>是包裝類的名字,<target>中的內容是由包裝類的語法指定,不同的包裝類的語法會有所不同。
來看看PHP 默認有哪些內置的包裝類:
print_r(stream_get_wrappers()); /* Array ( [0] => php [1] => file [2] => glob [3] => data [4] => http [5] => ftp [6] => zip [7] => compress.zlib [8] => https [9] => ftps [10] => phar ) */
看看PHP手冊中關於PHP支持的協議和包裝類。
看下面一段使用file_get_contents()獲取數據的代碼:
/* Read local file from /home/bar */ $localfile = file_get_contents ( "/home/bar/foo.txt" ); /* Identical to above, explicitly naming FILE scheme */ $localfile = file_get_contents ( "file:///home/bar/foo.txt" ); /* Read remote file from www.example.com using HTTP */ $httpfile = file_get_contents ( "http://www.example.com/foo.txt" ); /* Read remote file from www.example.com using HTTPS */ $httpsfile = file_get_contents ( "https://www.example.com/foo.txt" ); /* Read remote file from ftp.example.com using FTP */ $ftpfile = file_get_contents ( "ftp://user:[email protected]/foo.txt" ); /* Read remote file from ftp.example.com using FTPS */ $ftpsfile = file_get_contents ( "ftps://user:[email protected]/foo.txt" );
實際上readfile('/path/to/somefile.txt')或者readfile('file:///path/to/somefile.txt'),這兩種方式是等效的。因為PHP的默認包裝類就是file://。
手冊上明確指出,可以通過stream_register_wrapper()注冊自己的包裝器 ,可以去看看手冊中的例子。
OK,這裡簡單介紹一個PHP://,它是PHP用來處理IO流的包裝類(點擊這裡看個例子)。通過PHP://可以訪問更強大的輸入輸出流:
php://stdin:訪問PHP進程相應的輸入流,比如用在獲取cli執行腳本時的鍵盤輸入。
php://stdout:訪問PHP進程相應的輸出流。
php://stderr:訪問PHP進程相應的錯誤輸出。
php://input:訪問請求的原始數據的只讀流。
php://output:只寫的數據流,以 print 和 echo 一樣的方式寫入到輸出區。
php://fd:允許直接訪問指定的文件描述符。例 php://fd/3 引用了文件描述符 3。
php://memory:允許讀寫臨時數據。 把數據儲存在內存中。
php://temp:同上,會在內存量達到預定義的限制後(默認是 2MB)存入臨時文件中。
php://filter:過濾器。
PHP還可以通過context和filter對包裝類進行修飾和增強。
(1)關於context,如PHP通過stream_context_create()來設置獲取文件超時時間,這段代碼大家肯定用過:
$opts = array( 'http'=>array( 'method'=>"GET", 'timeout'=>60, ) ); $context = stream_context_create($opts); $html =file_get_contents('http://www.jb51.net', false, $context);
(2)關於filter過濾器,首先來看看PHP有哪些內置的過濾器:
print_r(stream_get_filters()); /* Array ( [0] => convert.iconv.* [1] => mcrypt.* [2] => mdecrypt.* [3] => string.rot13 [4] => string.toupper [5] => string.tolower [6] => string.strip_tags [7] => convert.* [8] => consumed [9] => dechunk [10] => zlib.* ) */
通過stream_filter_register()和內置的php_user_filter可創建自定義的過濾器,如下:
/* Define our filter class */ class strtoupper_filter extends php_user_filter { function filter ( $in , $out , & $consumed , $closing ) { while ( $bucket = stream_bucket_make_writeable ( $in )) { $bucket -> data = strtoupper ( $bucket -> data ); $consumed += $bucket -> datalen ; stream_bucket_append ( $out , $bucket ); } return PSFS_PASS_ON ; } } /* Register our filter with PHP */ stream_filter_register ( "strtoupper" , "strtoupper_filter" ) or die( "Failed to register filter" ); $fp = fopen ( "foo-bar.txt" , "w" ); /* Attach the registered filter to the stream just opened */ stream_filter_append ( $fp , "strtoupper" ); fwrite ( $fp , "Line1\n" ); fwrite ( $fp , "Word - 2\n" ); fwrite ( $fp , "Easy As 123\n" ); fclose ( $fp ); readfile ( "foo-bar.txt" ); /* 結果如下: LINE1 WORD - 2 EASY AS 123 */
提供PHP中streams函數列表如下:
stream_bucket_append函數:為隊列添加數據 stream_bucket_make_writeable函數:從操作的隊列中返回一個數據對象 stream_bucket_new函數:為當前隊列創建一個新的數據 stream_bucket_prepend函數:預備數據到隊列 stream_context_create函數:創建數據流上下文 stream_context_get_default函數:獲取默認的數據流上下文 stream_context_get_options函數:獲取數據流的設置 stream_context_set_option函數:對數據流、數據包或者上下文進行設置 stream_context_set_params函數:為數據流、數據包或者上下文設置參數 stream_copy_to_stream函數:在數據流之間進行復制操作 stream_filter_append函數:為數據流添加過濾器 stream_filter_prepend函數:為數據流預備添加過濾器 stream_filter_register函數:注冊一個數據流的過濾器並作為PHP類執行 stream_filter_remove函數:從一個數據流中移除過濾器 stream_get_contents函數:讀取數據流中的剩余數據到字符串 stream_get_filters函數:返回已經注冊的數據流過濾器列表 stream_get_line函數:按照給定的定界符從數據流資源中獲取行 stream_get_meta_data函數:從封裝協議文件指針中獲取報頭/元數據 stream_get_transports函數:返回注冊的Socket傳輸列表 stream_get_wrappers函數:返回注冊的數據流列表 stream_register_wrapper函數:注冊一個用PHP類實現的URL封裝協議 stream_select函數:接收數據流數組並等待它們狀態的改變 stream_set_blocking函數:將一個數據流設置為堵塞或者非堵塞狀態 stream_set_timeout函數:對數據流進行超時設置 stream_set_write_buffer函數:為數據流設置緩沖區 stream_socket_accept函數:接受由函數stream_ socket_server()創建的Socket連接 stream_socket_client函數:打開網絡或者UNIX主機的Socket連接 stream_socket_enable_crypto函數:為一個已經連接的Socket打開或者關閉數據加密 stream_socket_get_name函數:獲取本地或者網絡Socket的名稱 stream_socket_pair函數:創建兩個無區別的Socket數據流連接 stream_socket_recvfrom函數:從Socket獲取數據,不管其連接與否 stream_socket_sendto函數:向Socket發送數據,不管其連接與否 stream_socket_server函數:創建一個網絡或者UNIX Socket服務端 stream_wrapper_restore函數:恢復一個事先注銷的數據包 stream_wrapper_unregister函數:注銷一個URL地址包