CentOS服务器装PHP必须启用Remi仓库并安装带版本前缀的包（如php82），而非直接yum install php；因官方源PHP版本过旧（如CentOS 7为5.4、8为7.2），已EOL且不兼容现代框架，易导致composer报错、Laravel启动失败、扩展缺失等问题。
直接上结论：独立服务器装 PHP，别碰源码编译——除非你明确需要定制 SAPI 或调试内核；CentOS 上最稳、最快、最容易维护的方式是启用 remi 仓库 + dnf/yum 安装，再配好 php-fpm 和 Web 服务器的 FastCGI 对接。
为什么不能直接 yum install php？
CentOS 官方源里的 php 包版本太老（如 CentOS 7 默认是 PHP 5.4，8 是 7.2），早已 EOL，连安全补丁都不再提供。硬装会导致：composer 报错不兼容、laravel 启动失败、openssl 扩展缺失、甚至 json_encode 返回 null 等隐性问题。
常见错误现象：
-
php -v显示PHP 7.2.24，但php --ri openssl提示 extension not loaded - Web 页面空白，
error_log里反复出现Primary script unknown -
systemctl start php-fpm失败，报Failed to start The PHP FastCGI Process Manager，实际是依赖模块没装全
正确做法是先启用第三方可信仓库：
立即学习“PHP免费学习笔记（深入）”；
- CentOS 7：
sudo yum install epel-release && sudo yum install https://rpms.remirepo.net/enterprise/remi-release-7.rpm - CentOS 8/9：
sudo dnf install dnf-plugins-core && sudo dnf config-manager --set-enabled powertools && sudo dnf config-manager --add-repo https://rpms.remirepo.net/enterprise/remi-release-8.rpm
怎么选对 PHP 版本并启用它？
Remi 为每个 PHP 小版本都建了独立仓库（如 remi-8.2、remi-8.3），不手动启用就装不到——这是最容易被跳过的一步。
操作流程：
- 查可用版本：
sudo dnf module list php（CentOS 8+）或dnf repolist --enabled | grep remi（CentOS 7） - 启用目标版本（以 PHP 8.2 为例）：
CentOS 7：sudo yum-config-manager --enable remi-php82
CentOS 8/9：sudo dnf module reset php && sudo dnf module enable php:remi-8.2 - 确认启用成功：
sudo yum repolist enabled | grep remi应看到带remi-php82的条目
⚠️ 容易踩的坑：yum-config-manager 命令在 CentOS 7 需要先装 yum-utils；CentOS 8+ 若没运行 dnf module reset php 就直接 enable，会因模块冲突导致安装失败。
必须装哪些 PHP 模块才跑得起来？
只装 php 和 php-fpm 是不够的。现代 PHP 应用（Laravel、WordPress、Nextcloud）至少依赖以下扩展：
-
php-cli：命令行执行必需 -
php-fpm：FastCGI 进程管理器，和 Nginx/Apache 对接的核心 -
php-mysqlnd：MySQL 原生驱动（比php-mysql更稳定，支持 PDO::MYSQL_ATTR_SSL_*） -
php-opcache：性能关键，不启的话响应慢一倍以上 -
php-gd、php-mbstring、php-xml、php-curl：几乎每个框架都调用 -
php-bcmath：Laravel Passport、加密库常用
一次性装全（以 PHP 8.2 为例）：sudo dnf install php-cli php-fpm php-mysqlnd php-opcache php-gd php-mbstring php-xml php-curl php-bcmath php-zip php-json
验证是否加载：php -m | grep -E 'opcache|mysqlnd|gd' 应全部输出；若缺模块，别急着重装，先看 /etc/php.d/ 下对应 .ini 文件是否被注释或路径写错。
PHP-FPM 配置后为什么 Nginx 还 502？
装完只是开始，php-fpm 默认监听 127.0.0.1:9000，但很多生产环境出于 SELinux 或权限限制，必须改用 Unix socket。Nginx 配置里如果还写 fastcgi_pass 127.0.0.1:9000，而 php-fpm.conf 实际监听的是 /run/php-fpm/www.sock，就会 502。
检查与修复步骤：
- 确认
php-fpm监听方式：grep -E 'listen =|listen.owner' /etc/php-fpm.d/www.conf - 若用 socket，确保三者一致：
–listen = /run/php-fpm/www.sock
–listen.owner = nginx（或www-data，取决于 Web 服务用户）
–listen.group = nginx - Nginx server block 中对应写：
fastcgi_pass unix:/run/php-fpm/www.sock; - 重启服务顺序不能错：
sudo systemctl restart php-fpm && sudo systemctl reload nginx
SELinux 是另一个隐藏杀手：audit.log 里若出现 avc: denied { connectto } for ... scontext=system_u:system_r:httpd_t:s0，说明 SELinux 阻断了 Nginx 连 socket。临时放行：sudo setsebool -P httpd_can_network_connect 1；长期方案是用 semanage fcontext 标记 socket 路径上下文。
最后提醒一句：所有配置改完，别忘了 php-fpm -t 测试语法，php --ini 确认加载的是 /etc/php.ini 而不是某个 Docker 里残留的路径——这点在重装过多次的旧服务器上特别容易忽略。
