PHP源码包校验失败或解压出错，主因是下载中断、镜像延迟、代理污染或防火墙拦截；应删缓存、换国内镜像、手动验证SHA256，并检查curl响应与系统资源。
安装程序损坏不是文件本身问题，而是下载过程或解压环节出错，直接重装不会解决根本问题。
下载的 PHP 源码包校验失败（php-build 报 checksum mismatch）
phpenv 依赖 php-build 插件下载并编译 PHP 源码，它默认从 php.net 获取 tar.xz 包，并用内置 SHA256 值校验。一旦网络中断、代理缓存污染或镜像同步延迟，就可能拿到不完整或被篡改的包。
- 手动验证：进入
~/.phpenv/plugins/php-build/share/php-build/definitions/，找到对应版本定义文件（如8.3.0），复制其中的sha256值，再用shasum -a 256 ~/.phpenv/cache/php-8.3.0.tar.xz对比 - 跳过校验（仅调试用）：临时注释掉定义文件中
sha256行，或加参数phpenv install --force 8.3.0 - 换源下载：编辑定义文件，把
url改成国内镜像，例如：https://mirrors.huaweicloud.com/php/distributions/php-8.3.0.tar.xz
解压时提示 gzip: stdin: not in gzip format 或 tar: Unexpected EOF in archive
这类错误说明 .tar.xz 文件实际是空文件、HTML 错误页（如 404/503）、或被截断的二进制流——常见于公司防火墙拦截、DNS 污染导致重定向到登录页。
- 先删缓存：
rm -f ~/.phpenv/cache/php-*.tar.xz - 用
curl -I检查 URL 是否返回200 OK和正确的Content-Type: application/x-xz - 手动下载测试：
curl -L -o php-8.3.0.tar.xz <url></url>，再tar -tJf php-8.3.0.tar.xz | head -n5看能否列出目录 - 若手动下载正常，但
phpenv install仍失败，说明插件调用wget或curl时被代理干扰，可临时关闭代理：unset http_proxy https_proxy
编译中途卡在 [Compiling]: /tmp/php-build/source/xxx 超过 30 分钟
这不是“损坏”，而是编译进程被阻塞：常见于内存不足（尤其是 WSL 或低配 VPS）、磁盘满、或 GCC 编译器因缺少依赖静默失败（比如没装 libonig-dev 导致 PCRE2 编译退出，但脚本未捕获错误码）。
立即学习“PHP免费学习笔记（深入）”；
- 看实时日志：
tail -f ~/.phpenv/plugins/php-build/share/php-build/log/8.3.0.log，重点找最后一行是否含error:、fatal error或make: *** - 检查系统资源：
free -h（内存）、df -h（磁盘）、ulimit -v（虚拟内存限制） - 强制启用详细输出：
phpenv install -v 8.3.0 2>&1 | tee install.log，避免错误被吞掉 - WSL 用户注意：默认 swap 空间为 0，需手动配置
/etc/wsl.conf加[wsl2] swap=2GB并重启
真正难排查的其实是「看似成功实则损坏」：比如 phpenv versions 显示版本存在，但 phpenv global 8.3.0 后 php -v 仍报段错误或立即退出——这时要怀疑 configure 阶段漏掉了关键检测（如 --with-openssl 找不到头文件），最终生成的二进制链接了错误的系统库。别急着重装，先跑 ldd $(which php) | grep "not found"。
