Php/docs/wrappers.php
php://
php:// — 访问各个输入/输出流(I/O streams)
说明
PHP 提供了一些杂项输入/输出(IO)流,允许访问 PHP 的输入输出流、标准输入输出和错误描述符, 内存中、磁盘备份的临时文件流以及可以操作其他读取写入文件资源的过滤器。
php://stdin, php://stdout 和 php://stderr
php://stdin
、php://stdout
和
php://stderr
允许直接访问 PHP 进程相应的输入或者输出流。
数据流引用了复制的文件描述符,所以如果你打开 php://stdin
并在之后关了它,
仅是关闭了复制品,真正被引用的 STDIN
并不受影响。
注意 PHP 在这方面的行为有很多 BUG 直到 PHP 5.2.1。
推荐你简单使用常量 STDIN
、
STDOUT
和 STDERR
来代替手工打开这些封装器。
php://stdin
是只读的,
php://stdout
和 php://stderr
是只写的。
php://input
php://input
是个可以访问请求的原始数据的只读流。
POST 请求的情况下,最好使用 php://input
来代替 $HTTP_RAW_POST_DATA
,因为它不依赖于特定的 php.ini
指令。
而且,这样的情况下 $HTTP_RAW_POST_DATA
默认没有填充,
比激活 always_populate_raw_post_data
潜在需要更少的内存。
enctype="multipart/form-data"
的时候
php://input
是无效的。
Note:
在 PHP 5.6 之前
php://input
打开的数据流只能读取一次; 数据流不支持 seek 操作。 不过,依赖于 SAPI 的实现,请求体数据被保存的时候, 它可以打开另一个php://input
数据流并重新读取。 通常情况下,这种情况只是针对 POST 请求,而不是其他请求方式,比如 PUT 或者 PROPFIND。
php://fd
php://fd
允许直接访问指定的文件描述符。
例如 php://fd/3
引用了文件描述符 3。
php://memory 和 php://temp
php://memory
和 php://temp
是一个类似文件
包装器的数据流,允许读写临时数据。
两者的唯一区别是 php://memory
总是把数据储存在内存中,
而 php://temp
会在内存量达到预定义的限制后(默认是 2MB)存入临时文件中。
临时文件位置的决定和 sys_get_temp_dir() 的方式一致。
php://temp
的内存限制可通过添加 /maxmemory:NN
来控制,NN
是以字节为单位、保留在内存的最大数据量,超过则使用临时文件。
php://filter
php://filter
是一种元封装器,
设计用于数据流打开时的筛选过滤应用。
这对于一体式(all-in-one)的文件函数非常有用,类似 readfile()、
file() 和 file_get_contents(),
在数据流内容读取之前没有机会应用其他过滤器。
php://filter
目标使用以下的参数作为它路径的一部分。
复合过滤链能够在一个路径上指定。详细使用这些参数可以参考具体范例。
名称 | 描述 |
---|---|
resource=<要过滤的数据流>
|
这个参数是必须的。它指定了你要筛选过滤的数据流。 |
read=<读链的筛选列表>
|
)分隔。 |
write=<写链的筛选列表>
|
)分隔。 |
<;两个链的筛选列表>
|
任何没有以 read= 或 write= 作前缀
的筛选器列表会视情况应用于读或写链。 |
更新日志
版本 | 说明 |
---|---|
5.6.0 | php://input 可反复使用。
|
5.3.6 | 增加 php://fd 。
|
5.1.0 | 增加 php://memory 和 php://temp 。
|
范例
Example #1 php://temp/maxmemory
这个可选选项允许设置 php://temp
开始使用临时文件前的最大内存限制。
<?php// Set the limit to 5 MB.$fiveMBs = 5 * 1024 * 1024;$fp = fopen("php://temp/maxmemory:$fiveMBs", 'r+');fputs($fp, "hello\n");// Read what we have written.rewind($fp);echo stream_get_contents($fp);?>
Example #2 php://filter/resource=<待过滤的数据流>
这个参数必须位于 php://filter
的末尾,并且指向需要过滤筛选的数据流。
<?php/* 这简单等同于: readfile("http://www.example.com%22); 实际上没有指定过滤器 */readfile("php://filter/resource=http://www.example.com%22);?>
Example #3 php://filter/read=<读链需要应用的过滤器列表>
这个参数采用一个或以管道符 |
分隔的多个过滤器名称。
<?php/* 这会以大写字母输出 www.example.com 的全部内容 */readfile("php://filter/read=string.toupper/resource=http://www.example.com%22);/* 这会和以上所做的一样,但还会用 ROT13 加密。 */readfile("php://filter/read=string.toupper|string.rot13/resource=http://www.example.com%22);?>
Example #4 php://filter/write=<写链需要应用的过滤器列表>
这个参数采用一个或以管道符 |
分隔的多个过滤器名称。
<?php/* 这会通过 rot13 过滤器筛选出字符 "Hello World" 然后写入当前目录下的 example.txt */file_put_contents("php://filter/write=string.rot13/resource=example.txt","Hello World");?>
Example #5 php://memory 和 php://temp 是一次性的
php://memory
和 php://temp
是一次性的,比如:stream 流关闭后,就无法再次得到以前的内容了。
file_put_contents('php://memory', 'PHP');echo file_get_contents('php://memory'); // 啥也没有