宝塔面板 PHP 版本切换教程：多版本共存与站点切换的操作步骤及常见问题-速维云

适用场景与操作前准备

PHP 版本是网站运行环境的核心参数，切换版本是站长和运维人员经常遇到的操作。常见的切换场景有四类：一是建站程序提出了最低版本要求，比如新版 WordPress 官方建议 PHP 7.4 以上，部分插件和主题甚至要求 8.0；二是升级之后网站出现兼容问题，需要切回旧版本先恢复访问；三是旧版本官方已停止维护，继续使用会积累安全风险；四是追求性能，PHP 8.x 在执行效率上明显优于 7.x。无论哪种场景，切换都不只是"换个数字"那么简单，操作前请先做好三项准备。

第一项是备份。建议通过宝塔面板的手动备份或计划任务，把网站文件目录（一般为 /www/wwwroot/站点目录）和数据库各备份一份，并确认备份文件能正常下载到本地。第二项是选择低峰期操作，切换过程虽然只有几秒钟，但后续验证需要反复刷新页面，尽量避开访客高峰。第三项是记录当前环境：在站点设置里记下当前 PHP 版本，并到 PHP 扩展页面记录已安装的扩展清单（如 redis、opcache、imap、exif 等），这些扩展在新版本里需要重新确认是否安装。另外，不同版本的宝塔面板界面略有差异，下文步骤以主流版本为准，请以实际显示为准。

安装多个 PHP 版本，实现多版本共存

宝塔面板支持多个 PHP 版本同时运行，切换版本的正确做法是"先安装新版本，再切换站点"，而不是先卸载旧版本。进入"软件商店"，在运行环境分类下找到 PHP，选择需要的版本（如 PHP-7.4、PHP-8.1）点击安装。安装过程由面板自动完成，包括 PHP-FPM 服务注册，无需手动编译。安装完成后，在软件商店里能看到多个 PHP 版本并列显示，各自状态均为运行中，这就形成了多版本共存的环境。

需要特别提醒的是：在旧版本仍被站点使用期间，切勿卸载旧版本，否则相关网站会立即出现 502 或 500 错误。正确顺序是安装新版本、切换站点、全站验证、观察数日确认无异常后，再考虑卸载旧版本。如果想通过 SSH 确认服务器上安装了哪些 PHP，可以执行下面的命令，返回的每个子目录就是一个已安装的版本：

ls /www/server/php/

为网站切换 PHP 版本的操作步骤

下面以宝塔面板 Linux 版为例，说明单个站点的版本切换步骤，整个过程在网页界面完成，不需要登录 SSH。不同面板版本按钮位置可能略有差异，逻辑是一致的。

第一步，进入"网站"页面，找到目标站点，点击右侧的"设置"。第二步，在弹出的窗口中选择"PHP 版本"选项卡，在版本下拉列表里选择要切换的目标版本，例如从 PHP-7.4 切换到 PHP-8.1。第三步，点击"保存"，面板会自动重载对应版本的 PHP-FPM 服务，切换即时生效，无需手动重启服务。第四步，打开网站前台和后台各刷新一次，确认页面正常显示，并回到站点设置的 PHP 版本页面，确认当前版本已变为目标版本。

如果有多个站点需要切换，需要逐个站点重复上述操作，宝塔面板没有提供一键切换所有站点 PHP 版本的功能。切换完成后建议保留旧版本一段时间，确认所有站点稳定运行后再做卸载处理，这样一旦出新问题可以第一时间切回。

切换 PHP 版本前建议先备份网站文件与数据库，并在低峰期操作

命令行下的 PHP 版本管理

很多服务器上还跑着定时脚本、Composer 或队列进程，这些命令行程序调用的 PHP 与网站的 PHP-FPM 相互独立，在面板里切换版本不会改变命令行的默认版本。通过 SSH 登录后执行 php -v 可以看到默认 CLI 版本。如果需要用指定版本执行命令，直接写该版本的完整路径最为稳妥，宝塔各版本的可执行文件位于 /www/server/php/版本号/bin/ 目录下：

/www/server/php/80/bin/php -v

版本号目录的命名规则是去掉小数点，例如 PHP 8.0 对应目录 80，PHP 7.4 对应 74。使用 Composer 安装依赖时，如果项目要求 PHP 8.0 以上，可以用全路径方式调用，避免因默认 CLI 版本过低而报错：

/www/server/php/81/bin/php /usr/bin/composer install --no-dev

另外，宝塔面板"计划任务"中的 Shell 脚本如果调用了 php 命令，同样受默认 CLI 版本影响，建议在脚本里写全路径。至于修改 /usr/bin/php 软链接来切换全局默认版本的做法，会影响服务器上所有命令行行为，普通用户不建议操作，全路径调用是更安全的方式。

切换后的检查事项

版本切换完成后，建议按下面的顺序做一遍检查。先访问网站前台：首页、栏目页、内容页各打开一次，再登录后台，检查仪表盘、文章发布、媒体上传等常用功能是否正常。接着查看错误日志：在宝塔面板的站点设置里找到网站日志入口，或直接查看 /www/wwwlogs/ 目录下的 PHP 错误日志，出现 Deprecated 警告可以先观察，出现 Fatal error 则必须处理。

然后检查扩展：进入站点设置的 PHP 扩展页面，对比操作前记录的清单，确认 redis、opcache、mysqli、pdo_mysql、imap、exif 等项目处于已安装状态。不同 PHP 版本的扩展相互独立，新版本默认只安装少量核心扩展，漏装扩展是切换后白屏和 500 错误最常见的原因。最后检查 HTTPS 与缓存：确认证书加载正常，如果启用了 opcache，可在扩展页面重启一次 opcache，清除旧版本的字节码缓存。