宝塔面板PHP安装失败的根本原因是系统源失效，需先切换至CentOS Vault归档源并启用powertools，再安装-devel依赖包，最后在宝塔中重载配置更新软链接和PATH。
宝塔面板PHP安装失败，根本不是面板问题
报错的根源几乎都在系统层：CentOS 8/AlmaLinux/Rocky 8 等发行版已 EOL（2021年12月31日终止支持），mirror.centos.org 镜像源彻底失效。宝塔调用 yum 或 dnf 安装依赖时，会卡在 “Error: Failed to download metadata for repo 'powertools': Cannot prepare internal mirrorlist” 这类错误上——它连基础编译工具都拉不下来，更别说 PHP 源码编译了。
修复系统源是必须的第一步
不修源，后面所有操作都是白忙。尤其注意 CentOS 8+ 用户，别再试默认源或随便换一个镜像站，必须切换到 Vault（归档）源：
- 备份原 repo：
mv /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.bak - 下载阿里云归档源（适配 CentOS 8.5）：
wget -O /etc/yum.repos.d/CentOS-Base.repo http://mirrors.aliyun.com/repo/Centos-vault-8.5.2111.repo - 对 AppStream 和 PowerTools 同样处理：
sed -i 's/mirrorlist/#mirrorlist/g' /etc/yum.repos.d/CentOS-*.repo；sed -i 's|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g' /etc/yum.repos.d/CentOS-*.repo - 清缓存并重建：
yum clean all && yum makecache
完成后执行 dnf repolist，应能看到 baseos、appstream、powertools 均为 active 状态。
编译依赖包不能只装“Development Tools”
仅运行 yum groupinstall "Development Tools" 远远不够。PHP 编译实际需要的是带 -devel 后缀的头文件包，漏一个就会在 configure 阶段报 “xxx not found”。常见缺失项包括：
立即学习“PHP免费学习笔记（深入）”；
-
libxml2-devel（XML 支持）、openssl-devel（HTTPS/SSL）、curl-devel（cURL 扩展） -
oniguruma-devel（PCRE2 正则，PHP 7.3+ 必需）、libzip-devel（Zip 扩展）、sqlite-devel - CentOS 8+/Rocky 8+ 还要先启用 powertools：
dnf config-manager --set-enabled powertools，否则libzip-devel找不到 - 若报
undefined reference to libiconv_open，加编译参数--without-iconv，或装glibc-static（CentOS）
宝塔后台“安装成功”但没PHP？检查 PATH 和软链接
编译完成后，php -v 仍显示旧版本或报错，大概率是 PATH 没更新，或宝塔没重建软链接：
- 手动验证新 PHP 是否可用：
/www/server/php/80/bin/php -v（把80换成你装的版本号） - 进宝塔「软件管理」→「PHP」→ 对应版本右侧点「设置」→「配置修改」→ 拉到底部点「重载配置」——这步会刷新
/www/server/php/default软链接和环境变量注册 - 别跳过「重载配置」。很多用户只重启网站或 Nginx，结果 CLI 和 Web 环境仍在用
/usr/bin/php - 如仍不生效，可临时追加：
echo 'export PATH="/www/server/php/80/bin:$PATH"' >> /etc/profile && source /etc/profile
最易被忽略的是：宝塔的「重载配置」不是重启服务，而是重建路径映射。没点这一下，等于编译完了却没交钥匙。
