PHP 如何读取 Shell 管道（stdin）传入的数据

理解 Shell 管道与 PHP 标准输入

在 Linux/Unix 系统中，管道符号 | 的核心作用是将左侧命令的标准输出（stdout）重定向为右侧命令的标准输入（stdin）。虽然底层通过 pipe 机制实现，但在编写 PHP 代码时，你只需要关注如何从“标准输入”中读取内容即可，这与读取普通文件没有任何区别。

方法一：使用文件句柄逐行读取

对于需要实时处理每一行数据或希望精细控制读取过程的情况，可以使用 fopen 打开 php://stdin 伪协议对应的资源。

第1步：打开标准输入流

• 入口：php://stdin
• 动作：使用 fopen("php://stdin", "r") 获取文件指针 $fp。

第2步：循环读取直到结束

• 参数：feof($fp) 用于判断是否到达文件末尾（EOF），fgets($fp, 128) 每次最多读取 128 字节（可根据需求调整缓冲区大小）。
• 逻辑：将读取到的片段追加到字符串变量中，直到 feof 返回真。

<?php
$fp = fopen("php://stdin", "r");
$s = '';
while (!feof($fp)) {
    $s .= fgets($fp, 128);
}
var_dump($s);
fclose($fp);
?>

这种方式适合需要逐行解析日志或处理结构化数据的场景，但手动拼接字符串在处理极大数据量时可能效率较低。

方法二：直接读取全部内容

如果管道传输的数据量较小（例如简单的字符串验证、短参数传递），可以直接使用 file_get_contents() 函数，它会自动读取整个标准输入流。

<?php
$data = file_get_contents('php://stdin');
// 处理 $data...
?>

测试该功能的 Shell 命令示例如下：

ls -lh | php your_script.php

方法三：大数据量的分块处理与内存优化

当使用 find / | php script.php 此类涉及成千上万条文件路径的命令时，数据量可能远超内存限制。此时若直接使用 file_get_contents('php://stdin')，PHP 会尝试一次性将所有数据载入内存，导致“Out of memory”错误。

解决方案：
不要试图一次性读取所有数据，而是采用流式处理（Streaming）的方式。即每次只读取固定大小的数据块（如 4KB 或更大），处理完毕后释放内存，再继续下一轮读取。这类似于上面方法一中提到的逐行或分批读取逻辑，核心在于“读一部分、处理一部分、丢弃一部分”。

1. 目的：避免同时加载海量数据导致内存溢出。
2. 操作：在 while 循环中持续调用 fgets 或 fread。
3. 完成状态：当遇到 EOF 时循环退出，且中间产生的临时变量已正确释放。

例如遍历大型目录树时：

find /path/to/search -type f | php large_data_processor.php

在 large_data_processor.php 中应确保使用循环结构逐个处理每一行或每个数据块，而不是等待全部传输完成后再统一处理。

总结

PHP 通过 php://stdin 完美支持 Shell 管道的数据注入。小数据场景推荐使用 file_get_contents 简化代码；大数据场景务必采用循环读取模式以保护服务器内存稳定性。以上关于 PHP 读取 shell 管道传输内容的详细内容，更多关于 PHP 环境配置与性能优化的资料请关注本站其它相关文章！