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://output
php://output是一个只写的数据流,允许你以print和echo一样的方式写入到输出缓冲区。
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=作前缀的筛选器列表会视情况应用于读或写链。 |
可选项
属性 | 支持 |
---|---|
受限于allow_url_fopen | No |
受限于allow_url_include | 仅php://input、php://stdin、php://memory和php://temp。 |
允许读取 | 仅php://stdin、php://input、php://fd、php://memory和php://temp。 |
允许写入 | 仅php://stdout、php://stderr、php://output、php://fd、php://memory和php://temp。 |
允许追加 | 仅php://stdout、php://stderr、php://output、php://fd、php://memory和php://temp(等于写入) |
允许同时读写 | 仅php://fd、php://memory和php://temp。 |
支持stat() | 仅php://memory和php://temp。 |
支持unlink() | No |
支持rename() | No |
支持mkdir() | No |
支持rmdir() | No |
仅仅支持stream_select() | php://stdin、php://stdout、php://stderr、php://fd和php://temp。 |
更新日志
版本 | 说明 |
---|---|
5.6.0 | php://input可反复使用。 |
5.3.6 | 增加php://fd。 |
5.1.0 | 增加php://memory和php://temp。 |
5.0.0 | 增加php://filter。 |
范例
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"); 实际上没有指定过滤器 */ readfile("php://filter/resource=http://www.example.com"); ?>
Example #3 php://filter/read=<读链需要应用的过滤器列表>
这个参数采用一个或以管道符|分隔的多个过滤器名称。
<?php /* 这会以大写字母输出 www.example.com 的全部内容 */ readfile("php://filter/read=string.toupper/resource=http://www.example.com"); /* 这会和以上所做的一样,但还会用 ROT13 加密。 */ readfile("php://filter/read=string.toupper|string.rot13/resource=http://www.example.com"); ?>
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'); // 啥也没有