phpenv install失败主因是系统编译依赖缺失，非PHP自身问题；需按系统安装build-essential（Ubuntu）或Development Tools（CentOS）及libxml2-dev等开发包，并执行phpenv rehash生效。
“phpenv install” 失败，90% 是编译依赖没装全，不是 PHP 本身的问题。
configure: no acceptable C compiler found 或 configure: error: xml2-config not found
这类报错直接指向系统缺少基础构建工具或开发头文件。不是「PHP 装不了」，而是连编译器和 libxml2 的开发包都没到位。
- Debian/Ubuntu 系统必须运行：
sudo apt-get install build-essential autoconf bison re2c libxml2-dev libssl-dev libcurl4-openssl-dev libonig-dev libreadline-dev libsqlite3-dev libzip-dev - CentOS/RHEL 系统用：
sudo yum groupinstall "Development Tools"+sudo yum install libxml2-devel openssl-devel curl-devel oniguruma-devel readline-devel sqlite-devel libzip-devel - 别信“只差一个包”，
build-essential（或Development Tools）是前提，漏了它，gcc都找不到，后续全卡住
Definition xxx not found（如 mbstring、readline 符号未定义）
这是 PHP 8.4.2 等新版在默认 configure 下链接失败的典型表现——不是代码写错了，是编译时没显式启用对应模块，导致运行时符号缺失。
- 必须为 PHP 8.4.2 创建自定义配置文件，比如
~/.phpenv/plugins/php-build/share/php-build/definitions/8.4.2，内容至少含：--enable-mbstring --with-readline --enable-zip --with-config-file-path=$PREFIX/etc - 或者更稳妥地设环境变量：
PHPBUILD_CONFIGURE_OPTS="--enable-mbstring --with-readline" phpenv install 8.4.2 - 注意：
--with-readline在 8.4+ 已非默认启用，不加就会报readline_read_history未定义
phpenv: command not found 或 phpenv install 后 php -v 仍是旧版本
说明 phpenv 没真正接管 shell，shim 机制没生效，PATH 和初始化脚本任一环节断了都会这样。
立即学习“PHP免费学习笔记（深入）”；
- 检查
~/.phpenv/bin是否在$PATH最前面：echo $PATH | grep phpenv；没出现就补：export PATH="$HOME/.phpenv/bin:$PATH"到~/.bashrc或~/.zshrc - 确认初始化已执行：
eval "$(phpenv init -)"必须出现在 shell 配置末尾，且要source ~/.bashrc（或对应文件）重载 - 安装完新版本后，一定跑：
phpenv rehash—— 否则php命令根本不会指向新编译的二进制文件
编译卡在 [Compiling]: /tmp/php-build/source/xxx 或日志里满屏 warning
不是“卡住”，是编译器正在处理大量源码；但若超 20 分钟无进展，大概率是内存不足或某依赖静态库路径没被识别到。
- 先看日志末尾：
tail -n 50 ~/.phpenv/plugins/php-build/share/php-build/log/8.4.2.log，重点找error:行，不是warning: - 常见静默失败点：libzip 版本太低（需 ≥1.6）、OpenSSL 头文件路径混乱（
libssl-dev装了但pkg-config --modversion libssl报错）、或系统时间严重偏差（影响证书验证） - 最小化复现：临时删掉
~/.phpenv/plugins/php-build/share/php-build/definitions/8.4.2，改用最简参数重试：PHPBUILD_CONFIGURE_OPTS="--disable-all --enable-cli" phpenv install 8.4.2，能过说明是扩展依赖冲突
真正麻烦的从来不是“装不上”，而是错误信息指向 A，根因在 B（比如报 mbstring 错，实际是 libonig-dev 没装）；每次失败后，先盯紧 log 最后 10 行的 error:，再反查对应依赖，比重装系统快得多。
