phpenv install 报 “please reinstall the libxml2 distribution” 等错误，本质是系统缺少编译依赖，需在 Debian/Ubuntu 上执行 sudo apt-get install -y build-essential autoconf bison re2c libxml2-dev libssl-dev libcurl4-openssl-dev 等完整工具链与开发头文件。
phpenv install 报 “please reinstall the libxml2 distribution” 等编译错误
这是最典型的编译失败信号，本质是系统缺少 PHP 源码构建所需的开发头文件和工具链，不是 PHP 本身的问题，而是环境没配齐。
常见错误信息包括：please reinstall the libxml2 distribution、configure: error: Cannot find OpenSSL's <evp.h>、re2c not found、bison: command not found。
- Debian/Ubuntu 系统必须先运行：
sudo apt-get update && sudo apt-get install -y build-essential autoconf bison re2c libxml2-dev libssl-dev libcurl4-openssl-dev libpng-dev libfreetype6-dev libjpeg-dev libzip-dev - CentOS/RHEL 系统对应命令是：
sudo yum groupinstall "Development Tools" && sudo yum install -y autoconf bison re2c libxml2-devel openssl-devel libcurl-devel libpng-devel freetype-devel libjpeg-devel libzip-devel - 别信“只装几个就行”——
phpenv install默认启用大量扩展（如mysqli、curl、gd），缺任一依赖都会在 configure 阶段中断 - 安装后仍报错？用
tail -n 50 ~/.phpenv/plugins/php-build/share/php-build/log/7.4.30.log查最后一屏真实报错，比看终端滚动更准
phpenv 命令找不到或切换版本无效
现象是输入 phpenv 提示 command not found，或执行 phpenv global 8.1.27 后 php -v 仍是旧版本——根本原因几乎全是 shims 机制未生效。
- 确认
~/.phpenv/bin和~/.phpenv/shims都已加入$PATH，且shims在bin之前（否则会优先调到系统自带 php） - 检查是否漏了
eval "$(phpenv init -)"这行——它负责把 shims 目录注入 shell 的 command lookup 路径 - 改完配置后必须
source ~/.bashrc（或~/.zshrc），不能只开新终端：Zsh 用户尤其容易卡在这步 - 执行
phpenv rehash强制重建所有 shim 文件；如果~/.phpenv/versions/下有版本但shims里没对应php可执行文件，就说明这步没跑成功
安装卡在 [Compiling] 或耗时超 30 分钟
这不是网络问题，而是编译器被阻塞或资源不足。PHP 源码编译是 CPU 和内存密集型任务，最小化系统常因 swap 不足或并行数过高直接 hang 住。
立即学习“PHP免费学习笔记（深入）”；
- 临时降低编译并发数：
MAKEFLAGS="-j2" phpenv install 8.2.12（-j1更稳，但慢；默认-j$(nproc)在 4 核以上机器易触发内存 OOM） - 检查可用内存：
free -h，若available < 1.5G，建议先关掉浏览器等大内存进程 - 不要在 WSL1 或老旧虚拟机里硬扛 —— WSL2 / 实体机 / 新版 VirtualBox（启用了嵌套虚拟化）才适合编译 PHP
- 如果反复卡在同一个文件（如
ext/standard/string.c），大概率是 GCC 版本太高（GCC 13+ 对某些 PHP 7.x 版本不兼容），可临时降级：sudo apt install gcc-12 g++-12 && sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-12 100
php -v 正常但网页报 Call to undefined function curl_init()
这说明 CLI 和 Web SAPI（如 Apache mod_php 或 PHP-FPM）用的根本不是同一个 PHP 实例，phpenv 只管命令行，不管 Web 服务器加载的模块。
- 先运行
php --ini看 CLI 加载的php.ini路径；再在网页里建info.php写<?php phpinfo(); ?>，搜索 “Loaded Configuration File”，两个路径必须一致 - Apache 用户：确认
LoadModule php_module指向的是~/.phpenv/versions/8.2.12/lib/httpd/modules/libphp.so，而不是系统自带路径 - PHP-FPM 用户：检查
php-fpm.conf里的php_admin_value[extension_dir]是否指向~/.phpenv/versions/8.2.12/lib/php/extensions/no-debug-zts-20220829/ - Windows 用户绕不开 VC/TS 匹配问题：必须用
phpenv install --enable-debug编译的版本去配 Apache，否则php_curl.dll会静默失败
