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 系统必须运行：
CentOS/RHEL 系统用：
+
别信“只差一个包”，
（或
）是前提，漏了它，
都找不到，后续全卡住
Definition xxx not found（如 mbstring、readline 符号未定义）
这是 PHP 8.4.2 等新版在默认 configure 下链接失败的典型表现——不是代码写错了，是编译时没显式启用对应模块，导致运行时符号缺失。
必须为 PHP 8.4.2 创建自定义配置文件，比如
，内容至少含：
或者更稳妥地设环境变量：
注意：
在 8.4+ 已非默认启用，不加就会报
未定义
phpenv: command not found 或 phpenv install 后 php -v 仍是旧版本
说明 phpenv 没真正接管 shell，shim 机制没生效，PATH 和初始化脚本任一环节断了都会这样。
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
立即学习
“
PHP免费学习笔记（深入）
”；
检查
是否在
最前面：
；没出现就补：
到
或
确认初始化已执行：
必须出现在 shell 配置末尾，且要
（或对应文件）重载
安装完新版本后，一定跑：
—— 否则
命令根本不会指向新编译的二进制文件
编译卡在 [Compiling]: /tmp/php-build/source/xxx 或日志里满屏 warning
不是“卡住”，是编译器正在处理大量源码；但若超 20 分钟无进展，大概率是内存不足或某依赖静态库路径没被识别到。
先看日志末尾：
，重点找
行，不是
常见静默失败点：libzip 版本太低（需 ≥1.6）、OpenSSL 头文件路径混乱（
装了但
报错）、或系统时间严重偏差（影响证书验证）
最小化复现：临时删掉
，改用最简参数重试：
，能过说明是扩展依赖冲突
真正麻烦的从来不是“装不上”，而是错误信息指向 A，根因在 B（比如报 mbstring 错，实际是 libonig-dev 没装）；每次失败后，先盯紧 log 最后 10 行的
，再反查对应依赖，比重装系统快得多。
sudo apt-get install build-essential autoconf bison re2c libxml2-dev libssl-dev libcurl4-openssl-dev libonig-dev libreadline-dev libsqlite3-dev libzip-devsudo yum groupinstall "Development Tools"sudo yum install libxml2-devel openssl-devel curl-devel oniguruma-devel readline-devel sqlite-devel libzip-develbuild-essentialDevelopment Toolsgcc~/.phpenv/plugins/php-build/share/php-build/definitions/8.4.2--enable-mbstring --with-readline --enable-zip --with-config-file-path=$PREFIX/etcPHPBUILD_CONFIGURE_OPTS="--enable-mbstring --with-readline" phpenv install 8.4.2--with-readlinereadline_read_history~/.phpenv/bin$PATHecho $PATH | grep phpenvexport PATH="$HOME/.phpenv/bin:$PATH"~/.bashrc~/.zshrceval "$(phpenv init -)"source ~/.bashrcphpenv rehashphptail -n 50 ~/.phpenv/plugins/php-build/share/php-build/log/8.4.2.logerror:warning:libssl-devpkg-config --modversion libssl~/.phpenv/plugins/php-build/share/php-build/definitions/8.4.2PHPBUILD_CONFIGURE_OPTS="--disable-all --enable-cli" phpenv install 8.4.2error: