Nginx 下 PHP7.4 升级 PHP8.1 如何切换 PHP-FPM-php教程-PHP中文网

切换PHP 7.4至8.1需同步Nginx、PHP-FPM与CLI三者：先确认php8.1-fpm已安装并运行，修改Nginx的fastcgi_pass指向其监听地址（如unix:/run/php/php8.1-fpm.sock），再用update-alternatives设CLI默认版本为8.1，最后reload Nginx并用phpinfo()验证。

nginx 下 php7.4 升级 php8.1 如何切换 php-fpm

在 Nginx 环境下将 PHP 7.4 升级切换为 PHP 8.1，核心不是“替换”，而是让 Nginx、PHP-FPM 和 CLI 三者同时指向 PHP 8.1 实例。只改其中一项（比如只装了 php8.1-fpm 却没调 Nginx 配置），网站仍会报 502 或继续跑旧版本。

确认 PHP 8.1 已安装且 FPM 服务就绪

先确保系统中确实存在可用的 PHP 8.1 FPM 二进制和服务单元：

检查已安装版本：运行 ls /usr/bin/php*（Ubuntu/Debian）或 rpm -qa | grep php81（RHEL/CentOS），确认有 php8.1 和 php8.1-fpm
查看 FPM 服务状态：执行 systemctl list-units | grep php8.1-fpm，若未列出，需先安装（如 sudo apt install php8.1-fpm）
启动并设开机自启：sudo systemctl start php8.1-fpm && sudo systemctl enable php8.1-fpm
验证监听地址：打开 /etc/php/8.1/fpm/pool.d/www.conf，确认 listen = 行值，常见为 unix:/run/php/php8.1-fpm.sock 或 127.0.0.1:9001（注意端口别和 php7.4-fpm 冲突）

停用旧版 FPM 并更新 Nginx 配置

Nginx 不会自动感知 PHP 版本变化，必须手动修改 fastcgi_pass 指向新 socket 或端口：

PHP 8.5.12

修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。

下载

停止旧服务：sudo systemctl stop php7.4-fpm（可选，避免资源占用或端口冲突）
编辑站点配置文件（通常在 /etc/nginx/sites-enabled/your-site 或 /usr/local/nginx/conf/vhost/）
定位 location ~ \.php$ { ... } 块，找到 fastcgi_pass 行，将其改为与 php8.1-fpm 的 listen 值完全一致，例如：
fastcgi_pass unix:/run/php/php8.1-fpm.sock; 或 fastcgi_pass 127.0.0.1:9001;
检查 fastcgi_param SCRIPT_FILENAME 是否仍为动态写法：$document_root$fastcgi_script_name（不可写死路径）

重载 Nginx 并验证结果

配置改完后必须让 Nginx 重新加载，而不是重启整个服务：

测试语法是否正确：sudo nginx -t，显示 success 才能继续
重载配置：sudo systemctl reload nginx（或 sudo nginx -s reload）
创建临时验证页：echo "" > /var/www/html/info.php，浏览器访问 http://yoursite/info.php
确认页面顶部显示 “PHP Version 8.1.x”，且下方 “Loaded Configuration File” 指向 /etc/php/8.1/... 路径

补充：CLI 和扩展同步建议

虽然网站已切到 8.1，但命令行（如 composer、artisan）可能还在用 php7.4，建议一并调整：

注册版本到 alternatives：sudo update-alternatives --install /usr/bin/php php /usr/bin/php7.4 74 和 sudo update-alternatives --install /usr/bin/php php /usr/bin/php8.1 81
交互切换：sudo update-alternatives --config php → 选 81 → 再执行 php -v 验证
检查常用扩展是否启用：PHP 8.1 废弃了 mysql 扩展，确保 mysqli 或 pdo_mysql 在 /etc/php/8.1/fpm/php.ini 中已开启

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！