理解 PHP 中的 Streams

最新推荐文章于 2023-04-15 15:29:41 发布

转载最新推荐文章于 2023-04-15 15:29:41 发布 · 597 阅读

PHP 专栏收录该内容

184 篇文章

订阅专栏

本文深入探讨PHP中的Streams概念，包括其基本原理、内置包装器及过滤器，并介绍了如何使用Stream上下文来增强网络请求。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

转载自：http://www.oschina.net/translate/understanding-streams-in-php

理解 PHP 中的 Streams

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。按照下文所述的方式，可以查询到本机所支持的包装类：

 
    1<?php
 
    2print_r(stream_get_transports());
 
    3print_r(stream_get_wrappers());
 
    4print_r(stream_get_filters());

在我机器上的输出结果为：

 
    01Array
 
    02(
 
    03    [0] => tcp
 
    04    [1] => udp
 
    05    [2] => unix
 
    06    [3] => udg
 
    07    [4] => ssl
 
    08    [5] => sslv3
 
    09    [6] => sslv2
 
    10    [7] => tls
 
    11)
 
    12Array
 
    13(
 
    14    [0] => https
 
    15    [1] => ftps
 
    16    [2] => compress.zlib
 
    17    [3] => compress.bzip2
 
    18    [4] => php
 
    19    [5] => file
 
    20    [6] => glob
 
    21    [7] => data
 
    22    [8] => http
 
    23    [9] => ftp
 
    24    [10] => zip
 
    25    [11] => phar
 
    26)
 
    27Array
 
    28(
 
    29    [0] => zlib.*
 
    30    [1] => bzip2.*
 
    31    [2] => convert.iconv.*
 
    32    [3] => string.rot13
 
    33    [4] => string.toupper
 
    34    [5] => string.tolower
 
    35    [6] => string.strip_tags
 
    36    [7] => convert.*
 
    37    [8] => consumed
 
    38    [9] => dechunk
 
    39    [10] => mcrypt.*
 
    40    [11] => mdecrypt.*
 
    41)

提供的功能非常多，看上去还不错吧？

除了上述内建的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工具来做一个简单的测试：

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

在PHP脚本中使用print_r($_POST)的测试结果如下所示：

 
    1Array
 
    2(
 
    3    [foo] => bar
 
    4    [name] => John
 
    5)

我们注意$_POST array中是无法访问到第一项数据的。但是如果我们使用readfile('php://input')，结果就不同了：

`1`	`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将被使能。下面是一个例子：

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

在第一个例子中使用了一个filter来对保存到磁盘中的数据进行编码处理，在二个例子中，使用两个级联的filter来从远端的URL读取数据。使用filter能为你的应用带来极为强大的功能。

Stream上下文

context是一组stream相关的参数或选项，使用context可以修改或增强包装类的行为。例如使用context来修改HTTP包装器是一个常用到的使用场景。这样我们就可以不使用cURL工具，就能完成一些简单的网络操作。下面是一个例子：

 
    01<?php
 
    02$opts = array(
 
    03  'http'=>array(
 
    04    'method'=>"POST",
 
    05    'header'=> "Auth: SecretAuthTokenrn" .
 
    06        "Content-type: application/x-www-form-urlencodedrn" .
 
    07              "Content-length: " . strlen("Hello World"),
 
    08    'content' => 'Hello World'
 
    09  )
 
    10);
 
    11$default = stream_context_get_default($opts);
 
    12readfile('http://localhost/dev/streams/php_input.php');

首先要定义一个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，如下所示：

 
    1Array
 
    2(
 
    3    [Host] => localhost
 
    4    [Auth] => SecretAuthToken
 
    5    [Content-type] => application/x-www-form-urlencoded
 
    6    [Content-length] => 11
 
    7)

在上面的例子中是修改默认context的参数，当然我们也可以创建一个新的context,进行交替使用。

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

结论

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

本文地址：http://www.oschina.net/translate/understanding-streams-in-php

原文地址：http://www.sitepoint.com/%EF%BB%BFunderstanding-streams-in-php/

本文中的所有译文仅用于学习和交流目的，转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议，如果我们的工作有侵犯到您的权益，请及时联系我们