php:// 协议详解：PHP内置I/O流的全面指南
在PHP开发中，除了常规的文件与网络操作，系统还内置了一套高效便捷的“特殊通道”——php://协议族。这是一组功能强大的输入/输出（I/O）流包装器，为开发者提供了直接访问PHP进程自身I/O系统的途径。通过php://，您可以轻松操作标准输入输出、处理原始请求数据、使用内存或临时文件流，甚至在数据读取前应用过滤器链。掌握这些协议能显著提升代码的灵活性与性能，是PHP高级编程与系统优化的必备知识。
php://stdin, php://stdout 与 php://stderr
这三个流分别对应PHP进程的标准输入、标准输出和标准错误流，主要用于命令行环境下的脚本交互。
需要注意的是，php://stdin、php://stdout 和 php://stderr 实际上引用的是对应文件描述符的副本。这意味着关闭这些流副本不会影响原始的STDIN、STDOUT和STDERR常量。在PHP 5.2.1之前版本中存在相关行为BUG，因此更推荐直接使用PHP内置的常量STDIN、STDOUT和STDERR，它们更稳定且易于使用。
访问权限方面，php://stdin仅支持读取，而php://stdout和php://stderr仅支持写入操作。
php://input
这是一个极为常用的只读流，专门用于获取HTTP请求的原始数据体。在处理POST请求时，相比$HTTP_RAW_POST_DATA，php://input具有两大优势：首先，它不依赖php.ini中的always_populate_raw_post_data配置；其次，它能避免填充$HTTP_RAW_POST_DATA可能产生的额外内存消耗。
重要限制：当表单的enctype属性设置为"multipart/form-data"（常用于文件上传场景）时，php://input将无法使用。
技术要点： php://input流具有一次性读取特性，不支持指针寻址（seek）。不过根据SAPI实现差异，如果请求体数据已被保存，可能支持重新打开读取。这一特性主要针对POST请求，PUT、PROPFIND等其他请求方式不一定适用。
php://output
这是一个只写流，允许开发者像使用print或echo一样，将数据直接写入输出缓冲区。它在实现自定义输出处理、内容压缩或缓存机制时特别有用。
php://fd
该协议支持直接访问指定的文件描述符。语法简洁直观，例如php://fd/3表示引用文件描述符3。这为操作已打开的文件句柄提供了标准化接口。
php://memory 与 php://temp
这两个流都是临时数据存储容器，行为类似于文件包装器，支持读写操作。它们的核心差异在于存储策略：
- php://memory：始终将数据保存在内存中，访问速度快，但受可用内存容量限制。
- php://temp：采用智能存储策略。数据首先存储在内存中，当数据量超过预设阈值（默认2MB）后，会自动将溢出数据转存到系统临时文件。临时文件路径由
sys_get_temp_dir()函数确定。
对于php://temp，您可以通过/maxmemory:NN参数自定义内存阈值，其中NN代表数据保留在内存中的最大字节数。
php://filter
这是一个设计精巧的“元封装器”，核心价值在于能够在数据流打开时同步应用过滤器链。这对于readfile()、file()和file_get_contents()等单次读取函数尤其重要，因为这些函数通常不提供预处理数据的机会。
使用php://filter时，过滤器参数需要作为路径的一部分进行配置。支持多个过滤器组合形成处理链。其路径支持以下参数：
| 参数名称 | 功能说明 |
|---|---|
resource=<要过滤的数据流> | 必需参数。指定需要过滤的原始数据流来源。 |
read=<读链过滤器列表> | 可选参数。设置应用于读取链的过滤器名称，多个过滤器用竖线（|）分隔。 |
write=<写链过滤器列表> | 可选参数。设置应用于写入链的过滤器名称，同样用竖线（|）分隔。 |
<未前缀的过滤器列表> | 未使用read=或write=前缀的过滤器列表，将根据上下文自动应用于读链或写链。 |
封装协议功能对比表
下表系统总结了php://协议族各成员的功能特性（php://filter的支持情况取决于底层封装器）：
| 功能属性 | 支持情况 |
|---|---|
| 受 allow_url_fopen 限制 | 否 |
| 受 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() | 否 |
| 支持 rename() | 否 |
| 支持 mkdir() | 否 |
| 支持 rmdir() | 否 |
| 支持 stream_select() | php://stdin、php://stdout、php://stderr、php://fd、php://temp |
版本更新记录
| PHP版本 | 更新内容 |
|---|---|
| 5.3.6 | 新增 php://fd 协议 |
| 5.1.0 | 新增 php://memory 和 php://temp 协议 |
| 5.0.0 | 新增 php://filter 协议 |
实用代码示例
示例一：php://temp/maxmemory 使用
演示如何通过可选参数设置php://temp的内存上限。
示例二：php://filter/resource 基础用法
展示resource参数的基本结构，该参数必须置于php://filter路径末尾。
示例三：php://filter/read 读取链过滤
演示如何对读取链应用单个或多个过滤器。
示例四：php://filter/write 写入链过滤
展示如何对写入链应用过滤器处理数据。
本文内容基于PHP官方文档：https://www.php.net/manual/zh/wrappers.php.php
