必须显式启用--with-readline，否则readline函数退化为libedit模式；需安装系统readline开发库、修改php-build配置、重装PHP并验证函数存在性。
phpenv 编译 PHP 时必须显式启用 --with-readline
phpenv 本身不控制扩展开关，它只是版本管理器；readline 扩展是否可用，完全取决于你用 php-build 编译 PHP 时有没有传入 --with-readline。默认配置（比如 default_configure_options）通常不含该选项，所以即使装了系统库，readline() 函数仍会报错或退化为无历史/无编辑功能的 libedit 模式。
常见错误现象：readline_list_history() 返回 false、上下箭头键输入乱码、readline_add_history() 无效、readline_info() 报 undefined function。
- 确认系统已安装开发库：Ubuntu/Debian 运行
sudo apt install libreadline-dev，CentOS/RHEL 运行sudo yum install readline-devel（或dnf install readline-devel） - 修改
~/.phpenv/plugins/php-build/share/php-build/default_configure_options，在末尾追加一行：--with-readline - 删掉已编译的旧版本（如
phpenv uninstall 8.3.0），再重新安装：phpenv install 8.3.0 - 验证：运行
php -m | grep readline应输出readline；再执行php -r "var_dump(function_exists('readline'));"应返回bool(true)
为什么 php -a 有历史但你的脚本没有？
php -a 启动的是 PHP 内置交互模式，它内部调用 readline（如果可用），但你的自定义 CLI 脚本不会自动继承——必须手动调用 readline() 并配合 readline_add_history() 才能启用完整功能。
关键点在于：readline 历史是 per-process 的，且默认不持久化。每次脚本退出，历史就清空，除非你显式调用 readline_read_history() 和 readline_write_history()。
- 想让脚本启动时加载历史文件，先调用
readline_read_history('/path/to/history')（路径需存在且可写） - 每次成功读取输入后，立即调用
readline_add_history($input)，否则历史不会累积 - 脚本退出前调用
readline_write_history('/path/to/history')，否则本次新增记录丢失 - 注意：PHP 7.1+ Windows 支持 readline，但仅限 CLI SAPI；Web SAPI（如 Apache/FPM）下这些函数始终不可用
readline_callback_handler_install() 是唯一安全的交互方式
直接在循环里反复调用 readline() 会导致终端状态混乱（比如光标错位、回车不换行），尤其在 Ctrl+C 中断后。真正健壮的 CLI 交互必须用回调模式，由 readline 库接管输入流和信号处理。
典型陷阱：用 while (true) { $line = readline('> '); ... } —— 看似简单，实则无法响应 SIGINT（Ctrl+C），历史操作易崩溃，多线程环境（如某些 SAPI）下直接触发段错误。
- 初始化：调用
readline_callback_handler_install('> ', function($line) { /* 处理输入 */ }); - 主循环中只调用
readline_callback_read_char()，它不阻塞，适合嵌入事件循环 - 退出前必须调用
readline_callback_handler_remove()，否则终端设置残留（如关闭回显） - 若需支持 Ctrl+R 搜索历史等高级功能，还需搭配
readline_completion_function()注册补全逻辑
Windows 下 readline 功能受限且依赖 MSVC 运行时
PHP 7.1+ 虽宣称支持 Windows readline，但实际依赖于 libreadline 的 Windows 移植版（如 win-readline），而主流发行版（如 XAMPP、WAMP、phpstudy）打包的 PHP 通常只链接了 libedit，导致 readline_list_history()、readline_info() 等函数不可用。
更隐蔽的问题：即使编译时加了 --with-readline，若 PHP 是用 MSVC 编译的（绝大多数 Windows 二进制包如此），而 libreadline 是 MinGW 编译的，会出现 DLL 加载失败或内存访问冲突。
- 最稳方案：在 Windows 上改用
ext/readline的替代实现，比如symfony/console的QuestionHelper，它纯 PHP 实现，兼容所有环境 - 若坚持用原生 readline，必须自己用相同编译器（MSVC）从源码构建
libreadline，再交叉编译 PHP，成本远高于收益 - 检查当前行为：运行
php -r "echo readline_info('done') ?: 'libedit';"，若输出libedit，说明功能已被阉割
readline 的核心价值不在“读一行”，而在历史导航、行内编辑、补全提示这些交互细节——它们全靠底层库状态机驱动。一旦编译时漏掉 --with-readline 或运行时链接了 libedit，这些能力就不可逆地降级，且没有任何运行时警告。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
