PHP CLI按行读取标准输入并处理空行的实现方法

PHP CLI 处理管道数据时，最稳妥的做法是打开 php://stdin，用 fgets() 一次读取一行，并用 === false 判断真正的 EOF。空行不等于 EOF：fgets() 读到空行时仍会返回包含换行符的字符串，只有没有更多数据或发生读取错误时才返回 false。

官方地址：https://www.php.net/features.commandline

先把标准输入当作可持续的流

PHP 的 CLI SAPI 面向 shell 应用，标准输入既可能来自键盘，也可能来自 cat data.txt | php script.php 或 php script.php 。这些来源都可以通过 php://stdin 统一读取。打开失败时应立即报错退出，避免后面把无效句柄传给 fgets()。

这里的 STDERR 只用于输出错误，不会污染标准输出的数据结果。脚本也可以直接读取预定义的 STDIN，但显式保存句柄更容易在函数之间传递和统一关闭。

用 fgets 循环读取，并把 EOF 与空行分开

fgets() 默认读取到换行符、流结束或发生错误为止；如果没有额外长度限制，长行会持续读到行尾。关键判断是“返回值是否严格等于 false”，因为空行仍然是字符串，不应提前结束循环。

不要写成 while ($line = fgets($stdin)) 后再用空字符串判断结束，也不要用 feof() 作为唯一循环条件。EOF 只有在尝试读取之后才有意义；“先判断 feof、再读取”容易多处理一次无效结果。

空行处理要先确定业务语义

“空行”至少有三种情况：只有换行符的行、只包含空格或制表符的行，以及去掉行尾换行后长度为零的最后一行。若输入是用户名、订单号等记录，通常跳过纯空白行；若输入是 Markdown、配置片段或按空行分隔的段落，空行可能是结构的一部分，就应该保留。

如果只想识别“全是空白”的行，可以在保留原始值的同时单独判断：if (trim($line) === '')。不要因为需要判断空行，就直接把后续要保存的内容替换成 trim($line)，否则缩进、尾部空格和制表符都会丢失。

管道、重定向与长行的边界处理

管道输入天然适合流式消费，不需要先用 file_get_contents() 把全部内容放进内存。最后一行即使没有换行符，fgets() 仍会返回它；因此不要用“是否以换行结尾”判断记录是否完整。

如果单行可能非常长，可以传入长度参数，例如 fgets($stdin, 8192)。但这会改变语义：一行可能被拆成多个片段，业务层必须自行拼接。对普通日志、CSV 行或 shell 文本，优先使用默认的读到行尾行为，再在输入协议层限制最大行长。

这个模板适合 cat input.txt | php count.php 或 shell 重定向。若 fgets() 在尚未到 EOF 时返回 false，可能是读取错误；需要更严格的批处理程序可以在循环结束后结合 feof(STDIN) 记录异常，而不是静默吞掉。

常见问题

PHP CLI 读取空行时为什么没有结束？

因为空行仍是字符串，通常是 "\n" 或 "\r\n"。只有 fgets() 返回 false 才表示没有更多数据或读取失败。

应该用 trim 还是 rtrim 处理输入？

只想去掉换行符时用 rtrim($line, "\r\n")；要把首尾空格视为无意义输入时才用 trim()。

为什么不一次性使用 file_get_contents？

整段读取适合小文本，但输入很大或来自持续管道时会增加内存占用。逐行读取能让处理逻辑随数据到达推进，并明确控制每行的处理边界。