如何在Lightsail的Bitnami WordPress堆栈中升级PHP？

一、前置必做准备 #

• 全量备份虚拟机：重点备份/opt/bitnami目录（Bitnami核心环境）和WordPress数据库，操作前一定要做，避免翻车无法回滚
• 停止所有Bitnami服务：

  sudo /opt/bitnami/ctlscript.sh stop
  

二、Bitnami环境专属的PHP升级步骤 #

Bitnami是独立封装的环境，不能直接用系统包管理工具升级，得用匹配的Bitnami PHP包替换：

1. 下载对应系统架构（x86_64/arm64）的目标版本Bitnami PHP安装包（比如PHP 8.2）
2. 解压到临时目录：

   mkdir /tmp/php-upgrade && tar -xzf php-*.tar.gz -C /tmp/php-upgrade
   

3. 替换旧PHP目录：

   sudo mv /opt/bitnami/php /opt/bitnami/php-old
   sudo mv /tmp/php-upgrade/php /opt/bitnami/
   

4. 修复目录权限：

   sudo chown -R bitnami:bitnami /opt/bitnami/php
   

三、解决配置冲突的关键调整 #

之前手动升级失败核心是Bitnami的环境变量和Web服务配置绑定了旧PHP路径，需要逐一适配：

• 更新环境变量：编辑/opt/bitnami/scripts/setenv.sh，把所有旧PHP路径（如/opt/bitnami/php-old/bin）替换为新路径/opt/bitnami/php/bin
• 适配Web服务器：
  • Apache环境：编辑/opt/bitnami/apache/conf/bitnami/bitnami.conf和/opt/bitnami/apache/conf/httpd.conf，找到PHPIniDir、LoadModule php*_module的行，替换为新PHP的模块路径（比如/opt/bitnami/php/lib/apache2/libphp8.so）
  • Nginx环境：编辑/opt/bitnami/nginx/conf/nginx.conf和站点配置文件，把fastcgi_pass指向新的PHP-FPM套接字（比如unix:/opt/bitnami/php/var/run/www.sock）
• 重启服务验证：

  sudo /opt/bitnami/ctlscript.sh start php-fpm apache
  

  （如果是Nginx就替换成nginx）

四、验证与问题排查 #

• 检查PHP版本：

  /opt/bitnami/php/bin/php -v
  

• 访问WordPress前台和后台，确认功能正常；如果出错，查看日志：
  • Apache日志：/opt/bitnami/apache/logs/error_log
  • PHP-FPM日志：/opt/bitnami/php/var/log/php-fpm.log
  • WordPress调试日志：在wp-config.php中开启WP_DEBUG，查看wp-content/debug.log

五、过渡备选方案（适合重构前临时使用） #

如果上述步骤遇到难以解决的冲突，可以用多版本共存的方式过渡：

• 额外安装新版本Bitnami PHP-FPM，不替换旧版本
• 通过Apache/Nginx的站点配置，指定WordPress站点单独使用新版本PHP-FPM，其他服务继续用旧版本，直到完成堆栈重构

内容的提问来源于stack exchange，提问作者Jan Mykhail Hasselbring