流的作用是在出发地和目的地之间传输数据。出发地和目的地可以是文件、命令行进程、网络连接、ZIP或TAR压缩文件、临时内存、标准输入或输出,或是通过PHP流封装协议实现的任何其它资源。
定义
流的作用是使用统一的方式处理文件、网络和数据压缩等共用同一套函数和用法的操作。简单而言,流是具有流式行为的资源对象。因此,流可以线性读写、或许还能使用fseek()函数定位到流中的任何位置 --PHP手册。
下面我们简化一下,以便理解,流的作用是在出发地和目的地之间传输数据。出发地和目的地可以是文件、命令行进程、网络连接、ZIP或TAR压缩文件、临时内存、标准输入或输出,或是通过PHP流封装协议实现的任何其它资源。
流封装协议
流式数据的种类各异,每种类型需要独特的协议,以便读写数据。我们称这些协议为流封装协议。流封装协议的作用是使用通用的接口封装不同通信方式间的差异。每个流都有一个协议和一个目标。格式如下:
://
其中
示例:使用HTTP流封装协议与Flickr API通信
file_get_contents()函数的字符串参数其实是一个流标识符。http协议会让PHP使用HTTP流封装协议。在这个参数中,http之后是流的目标。流的目标之所以看起来像是普通的网页URL,是因为HTTP流封装协议就是这样规定的。其它流封装协议可能不是这样。(普通的URL其实就是PHP流封装协议标识符的伪装)。
file://流封装协议
我们使用file_get_contents()、fopen()、fwrite()和fclose()函数读写文件系统,因为PHP默认使用的流封装协议是file://,所以我们很少认为这些函数使用的是PHP流。我们在不经意间就使用流PHP流!
示例:隐式使用file://流封装协议
下面这个示例的作用一样,不过这一次我们在流标识符中明确指定流file://流封装协议
示例:显式的使用file://流封装协议
我们通常会是省略file://封装协议,因为这是PHP使用的默认值。
php://流封装协议
这个流封装协议但作用是与PHP脚本的标准输入、标准输出和标准错误文件描述符通信。我们可以使用PHP提供的文件系统函数打开、读取或写入下述四个流:
php://stdin
这个是只读PHP流,其中的数据来自标准输入。例如,PHP脚本可以使用这个流接收命令行传入的脚本的信息。
php://stdout
这个PHP流的作用是把数据写入当前的输出缓冲区。这个流只能写,无法读或寻址。
php://memory
这个PHP流的作用是从系统内存中读取数据,或者把数据写入系统内存。这个PHP流的缺点是,可用内存是有限的,使用php://temp流更安全。
php://temp
这个PHP流的作用和php://memory类似,不过,没有可用内存时,PHP会把数据写入临时文件。
其它流封装协议
PHP和PHP扩展还提供流很多其他流封装协议,例如,与ZIP和TAR压缩文件、FTP服务器、数据压缩库等通信的流封装协议。
流上下文
有些PHP流能接收一系列可选的参数,这些参数叫流上下文,用于定制流的行为。流上下文使用stream_context_create()函数创建。这个函数返回的上下文对象可以传入大多数文件系统和流函数。
示例:流上下文(使用file_get_contents()函数发送HTTP POST请求)
array( 'method' => 'POST', 'header' => "Content-Type: application/json;charset=utf-8;\r\n" . "Content-Length: " . mb_strlen($requestBody), 'content' => $requestBody )
));
$response = file_get_contents('https://my-api.com/users', false, $context);
流过滤器
PHP真正强大的地方在于过滤、转换、添加或删除流中传输的数据。