• 首页
  • vue
  • TypeScript
  • JavaScript
  • scss
  • css3
  • html5
  • php
  • MySQL
  • redis
  • jQuery
  • php://

    访问各个输入/输出流(I/O streams)

    说明

    PHP 提供了一些杂项输入/输出(IO)流,允许访问 PHP 的输入输出流、标准输入输出和错误描述符,内存中、磁盘备份的临时文件流以及可以操作其他读取写入文件资源的过滤器。

    php://stdin, php://stdout 和 php://stderr

    php://stdinphp://stdoutphp://stderr允许直接访问 PHP 进程相应的输入或者输出流。数据流引用了复制的文件描述符,所以如果你打开php://stdin并在之后关了它,仅是关闭了复制品,真正被引用的STDIN并不受影响。注意 PHP 在这方面的行为有很多 BUG 直到 PHP 5.2.1。推荐你简单使用常量STDINSTDOUTSTDERR来代替手工打开这些封装器。

    php://stdin是只读的,php://stdoutphp://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://memoryphp://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目标使用以下的参数作为它路径的一部分。复合过滤链能够在一个路径上指定。详细使用这些参数可以参考具体范例。

    php://filter 参数
    名称描述
    resource=<要过滤的数据流>这个参数是必须的。它指定了你要筛选过滤的数据流。
    read=<读链的筛选列表>该参数可选。可以设定一个或多个过滤器名称,以管道符(|)分隔。
    write=<写链的筛选列表>该参数可选。可以设定一个或多个过滤器名称,以管道符(|)分隔。
    <;两个链的筛选列表>任何没有以read=write=作前缀的筛选器列表会视情况应用于读或写链。

    可选项

    封装协议摘要(针对php://filter,参考被筛选的封装器。)
    属性支持
    受限于allow_url_fopenNo
    受限于allow_url_includephp://inputphp://stdinphp://memoryphp://temp
    允许读取php://stdinphp://inputphp://fdphp://memoryphp://temp
    允许写入php://stdoutphp://stderrphp://outputphp://fdphp://memoryphp://temp
    允许追加php://stdoutphp://stderrphp://outputphp://fdphp://memoryphp://temp(等于写入)
    允许同时读写php://fdphp://memoryphp://temp
    支持stat()php://memoryphp://temp
    支持unlink()No
    支持rename()No
    支持mkdir()No
    支持rmdir()No
    仅仅支持stream_select()php://stdinphp://stdoutphp://stderrphp://fdphp://temp

    更新日志

    版本说明
    5.6.0php://input可反复使用。
    5.3.6增加php://fd
    5.1.0增加php://memoryphp://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://memoryphp://temp是一次性的,比如:stream 流关闭后,就无法再次得到以前的内容了。

    file_put_contents('php://memory', 'PHP');
    echo file_get_contents('php://memory'); // 啥也没有

    上篇:ftp://

    下篇:zlib://