PHP 的 readline() 在 CLI 环境中默认启用系统级 Tab 补全，导致多次按 Tab 键时意外输出文件列表（如 scandir 结果），影响交互体验；可通过 readline_completion_function() 注册空补全回调彻底禁用该行为。
php 的 `readline()` 在 cli 环境中默认启用系统级 tab 补全，导致多次按 tab 键时意外输出文件列表（如 `scandir` 结果），影响交互体验；可通过 `readline_completion_function()` 注册空补全回调彻底禁用该行为。
在 PHP 命令行脚本中使用 readline() 获取用户输入时，若未显式配置补全逻辑，PHP 会继承底层 GNU Readline 库的默认行为：当用户在提示符后输入字符并连续按两次 Tab 键时，系统将触发路径补全（即 scandir 当前目录内容），并将结果直接插入输入缓冲区——这并非 PHP 脚本本身的问题，而是 shell 终端与 readline 库协同作用的结果。你甚至可以在不运行 PHP 的情况下，在终端中直接输入 > 后连按两次 Tab，复现相同现象。
要彻底消除这一干扰，最简洁可靠的方式是调用 readline_completion_function() 注册一个“无操作”补全回调函数。该函数接收当前输入字符串作为参数，返回一个空数组 []，即可明确告知 readline 不提供任何补全建议，从而禁用所有自动补全行为（包括文件名、命令、路径等）。
以下是修复后的完整示例代码：
<?php // 禁用 readline 默认补全行为（避免 Tab 触发 scandir）
readline_completion_function(function (string $input): array {
return [];
});
$msg = '';
while ($msg !== 'quit') {
// 过滤空输入和回车符，确保有效输入
while ($msg === '' || $msg === "\r" || $msg === "\n") {
$msg = readline('> ');
// 可选：清除输入历史中的空白行（提升 UX）
if ($msg !== null && trim($msg) === '') {
readline_add_history('');
}
}
echo "收到: " . trim($msg) . PHP_EOL;
$msg = ''; // 重置，准备下一轮输入
}
⚠️ 注意事项：
-
readline_completion_function()必须在首次调用readline()之前注册，否则无效； - 该函数仅影响当前 PHP 进程的 readline 行为，不会修改系统或 shell 设置；
- 若后续需自定义补全（如命令历史、关键词匹配），可在此回调中实现逻辑，返回匹配字符串数组即可；
- 在 Windows 上若使用 Git Bash 或 WSL，行为一致；原生 CMD/PowerShell 不支持 readline，此问题不出现。
通过这一配置，你的 CLI 工具将获得干净、可控的输入体验——Tab 键不再触发意外扫描，真正回归为纯粹的用户输入辅助键。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
