Ubuntu22.04降级PHP8.1至7.4后phpMyAdmin故障求助

核心原因 #

你当前安装的phpMyAdmin版本大概率是适配PHP 8.x的，和PHP 7.4存在兼容性冲突，这是导致页面无法加载的主要原因。

具体修复步骤 #

1. 确认当前phpMyAdmin版本
   查看phpMyAdmin的版本文件（通常在/usr/share/phpmyadmin/VERSION或安装目录下的README文件），如果版本是5.2.x及以上，它虽标注支持PHP 7.4+，但部分新特性在7.4环境下可能引发异常，更稳妥的是使用适配PHP 7.4的稳定版本（比如4.9.x或5.1.x）。

2. 备份现有phpMyAdmin数据
   先备份配置文件和核心目录，避免丢失自定义设置：

   sudo cp -r /usr/share/phpmyadmin /usr/share/phpmyadmin_backup
   sudo cp /etc/phpmyadmin/config.inc.php /etc/phpmyadmin/config.inc.php_backup
   

3. 安装兼容PHP 7.4的phpMyAdmin版本

   • 卸载当前版本：

     sudo apt remove --purge phpmyadmin
     sudo apt autoremove
     

   • 下载适配版本（以5.1.4为例，完美支持PHP 7.4）：

     cd /tmp
     wget https://files.phpmyadmin.net/phpMyAdmin/5.1.4/phpMyAdmin-5.1.4-all-languages.tar.gz
     tar xzf phpMyAdmin-5.1.4-all-languages.tar.gz
     sudo mv phpMyAdmin-5.1.4-all-languages /usr/share/phpmyadmin
     

4. 恢复配置文件并设置权限
   将备份的配置文件复制回去，同时确保Web服务用户拥有目录权限：

   sudo cp /etc/phpmyadmin/config.inc.php_backup /etc/phpmyadmin/config.inc.php
   sudo chown -R www-data:www-data /usr/share/phpmyadmin
   

5. 重启Web服务
   根据你使用的Web服务器执行对应命令：

   • Apache：

     sudo systemctl restart apache2
     

   • Nginx：

     sudo systemctl restart nginx
     

6. 补全PHP 7.4必要模块
   确保PHP 7.4的核心扩展已安装：

   sudo apt install php7.4-mbstring php7.4-zip php7.4-gd php7.4-json php7.4-curl
   

   安装完成后再次重启Web服务。

额外排查点 #

• 查看Web服务器错误日志（Apache：/var/log/apache2/error.log；Nginx：/var/log/nginx/error.log），如果有具体报错（比如模块缺失、权限不足），针对性解决。
• 确认phpMyAdmin的Web服务配置文件中，PHP解析器指向的是7.4版本，而非旧的8.1。

内容的提问来源于stack exchange，提问作者Diksha Chaudhary