MX-Linux下PHP7.4升级至8.1后phpMyAdmin报错的解决方法

核心原因 #

错误日志里的Call to undefined function PhpMyAdmin\mb_strpos()明确说明PHP8.1缺少mbstring扩展，这是phpMyAdmin依赖的核心扩展之一。

具体修复步骤 #

1. 安装PHP8.1的mbstring扩展
   在MX-Linux终端执行命令：

   sudo apt install php8.1-mbstring
   

2. 重启Apache2服务
   安装完成后重启web服务让扩展生效：

   sudo systemctl restart apache2
   

3. 验证扩展是否启用
   可在web根目录（如/var/www/html/）创建phpinfo.php文件，内容如下：

   <?php phpinfo(); ?>
   

   访问http://localhost/phpinfo.php，搜索mbstring确认模块已加载。

解决phpMyAdmin自动安装PHP8.2的问题 #

如果重装phpMyAdmin时自动拉取PHP8.2，可指定版本安装对应PHP8.1的依赖包：

sudo apt install phpmyadmin php8.1-mysql php8.1-curl php8.1-gd php8.1-intl php8.1-zip

安装过程中按提示选择Apache2作为web服务器，并完成数据库配置操作。

额外排查点 #

确保Apache2启用的是PHP8.1模块，而非其他版本：

sudo a2dismod php7.4 php8.2 # 禁用不需要的PHP模块
sudo a2enmod php8.1 # 启用PHP8.1模块
sudo systemctl restart apache2

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