phpenv编译PHP默认不带readline扩展，必须重编译并显式添加--with-readline参数，否则readline_list_history()等函数不可用；验证需用php -r "var_dump(function_exists('readline_list_history'));"返回true才表示完整支持。
phpenv 编译安装的 PHP 默认不带 readline 扩展，必须重新编译并显式启用 --with-readline，否则 readline() 函数可用但历史、补全等高级功能全部失效（比如 readline_list_history() 直接报 Call to undefined function）。
确认当前 PHP 是否真有 readline 支持
别只看 php -m | grep readline —— 这个命令即使没编译进 readline 也可能输出一行（因为部分系统 fallback 到 libedit，但功能残缺）。真正验证方式是：
- 运行
php -r "var_dump(function_exists('readline_list_history'));"，返回bool(true)才算完整支持 - 如果返回
bool(false)，说明只启用了 libedit 兼容层，readline_add_history()、readline_completion_function()等全不可用 -
php -i | grep -i readline可能显示Readline Support => enabled，但这不保证是 GNU Readline；得结合函数存在性判断
用 phpenv + php-build 重新编译带 readline 的 PHP
phpenv 本身不管理编译参数，靠 php-build 插件控制。关键不是“安装扩展”，而是“在编译 PHP 时链接系统 readline 库”：
- 先确保系统已装开发包：
yum install -y readline-devel（CentOS/RHEL）或apt install -y libreadline-dev（Debian/Ubuntu） - 编辑配置文件：
~/.phpenv/plugins/php-build/share/php-build/default_configure_options - 在 configure 参数里追加
--with-readline（不要写成--with-libedit，后者功能受限） - 执行编译：
phpenv install 8.3.5（替换成你要的版本），过程会自动调用 php-build 并应用你改过的参数 - 装完后用
phpenv global 8.3.5切换，再跑上面的function_exists检查
为什么不能用 pecl 或 so 扩展方式补装？
readline 不是独立扩展，它是 PHP CLI/CGI SAPI 编译期绑定的底层能力，和 openssl、zlib 类似：
立即学习“PHP免费学习笔记（深入）”；
- 没有
readline.so文件，extension=readline.so在php.ini里直接无效 - 试图用
pecl install readline会失败：PECL 上根本没有这个包 - 已安装的 PHP 二进制若没带 readline，唯一办法就是重编译 —— phpenv 的优势正在于此，它天然支持多版本按需编译
交互式脚本里 readline 历史和补全的最小可用样板
光有扩展还不够，实际用时容易漏掉初始化步骤。以下代码能跑通的前提是上面已确认 readline_list_history() 存在：
#!/usr/bin/env php
<?php
readline_callback_handler_install("λ ", function($line) {
if (trim($line)) {
readline_add_history($line); // 必须手动加，不加 history 就是空的
echo "You said: $line\n";
}
});
while (true) {
readline_callback_read_char(); // 非阻塞读字符，触发回调
}
?>
注意：readline_completion_function() 要求你提前注册补全逻辑，且补全回调接收的是当前输入前缀（不是整行），这个细节很多人第一次写就卡住。
最常被忽略的一点：Windows 下虽从 PHP 7.1+ 开始支持 readline，但 phpenv 是 Linux/macOS 工具，如果你在 WSL 里用 phpenv，记得确认 WSL 发行版已装 libreadline-dev，而不是 Windows 原生的 PHP 安装包。
