phpMyAdmin升级PHP版本后为何变成空白页面？

升级 PHP 后 phpMyAdmin 白屏，大概率不是“兼容性问题”本身，而是旧配置、缺失扩展或启动阶段崩溃被静默吞掉了——PHP 7.4+ 和 8.x 对扩展加载、错误报告、BOM 处理更严格，老环境里能蒙混过关的配置，一升级就直接终止输出。说白了，不是 PHP 不兼容，是系统把报错信息藏起来了，你只看到一片空白。

下面逐个排查，别跳步骤，很多时候是多个问题叠加。

mysqli 扩展没启用是头号原因

phpMyAdmin 4.9 起强制依赖 mysqli，不再接受 mysql 或仅靠 pdo_mysql。升级 PHP 后，原有的 extension=mysqli 可能失效——比如配置文件被覆盖、扩展目录变了。怎么验证？

• Linux（如 Ubuntu）：运行 php -m | grep mysqli，无输出就说明没加载；需执行 sudo phpenmod mysqli（Debian/Ubuntu）或检查 /etc/php/*/mods-a vailable/mysqli.ini 是否启用
• Windows：确认 php.ini 中 extension=php_mysqli.dll 前的分号已去掉，且 extension_dir 指向真实 DLL 所在目录
• Docker：基础镜像（如 php:8.3-apache）默认不带 mysqli，必须加 RUN docker-php-ext-install mysqli
• 验证是否真可用：光看 php -m 不够，还要访问 phpinfo() 页面，搜索 “mysqli” 区块，确认有“Client API library version”等运行时信息

这一步往往能解决一半的白屏问题。

php-gettext 扩展在 PHP 7+ 上成了硬依赖

Ubuntu 16.04+、Debian 系及多数 PHP 7.0+ 环境中，php-gettext 不再是可选组件——它负责多语言字符串处理，缺失会导致 phpMyAdmin 启动时解析失败并静默退出，页面全空。很多人在升级后忘了这个模块，结果死活找不到原因。

• Debian/Ubuntu：运行 sudo apt install php-gettext，然后重启 Web 服务（sudo systemctl restart apache2 或 sudo systemctl restart php*-fpm）
• CentOS/RHEL：安装 php-common（通常已含 gettext），若仍白屏，检查 extension=gettext.so 是否在生效的 php.ini 中启用
• 别跳过验证：创建 test.php 内容为 ，返回 bool(true) 才算到位

config.inc.php 语法或废弃配置触发 parse error

PHP 升级后解析器更严格，旧版 config.inc.php 里几个常见雷区会直接让整个入口脚本崩掉，而且因为错误显示关闭，你只能看到白页。几个最坑的地方：

• $cfg['blowfish_secret'] 为空或长度不足 32 字符：新版会报错，但因错误显示关闭，只留白页
• 用了已移除的配置项，比如 $cfg['Servers'][$i]['auth_type'] = 'http'（5.2+ 已弃用）
• 注释跨了 PHP 开始标签：/* 这类写法在 PHP 8.0+ 会解析失败
• 文件末尾有多余空格、BOM 或 UTF-8 BOM 头：用 VS Code 打开 → 右下角点编码 → “Sa ve with Encoding” → 选 “UTF-8 without BOM”
• 快速验证：运行 php -l /path/to/phpmyadmin/config.inc.php，有语法错误会明确提示第几行

这三行命令比瞎猜有效得多。

错误报告仍关闭，你根本看不到它在哪摔的

升级 PHP 后，display_errors 和 error_reporting 很可能被重置为默认值（Off + E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED），导致致命错误发生时浏览器只收空响应。很多人在服务器上折腾半天，其实看一眼日志就能定位。

• 临时补救：在 phpMyAdmin 的 index.php 顶部（ 后第一行）插入：
error_reporting(E_ALL); ini_set('display_errors', '1'); ini_set('display_startup_errors', '1');
• 更可靠的做法：改生效的 php.ini。先通过 phpinfo() 查 “Loaded Configuration File”，再编辑该文件，设 display_errors = On 和 error_reporting = E_ALL，最后重启 Web 服务（不是 reload）
• 注意路径：Apache mod_php 和 PHP-FPM 加载的 php.ini 路径不同，FPM 下常是 /etc/php/*/fpm/php.ini，改错位置等于没改

真正麻烦的不是某一个点，而是多个限制叠加：比如 mysqli 加载了但 php-gettext 缺失，或者 config.inc.php 语法正确但 blowfish_secret 是空字符串——PHP 解析完配置后才在初始化阶段挂掉，此时连日志都未必留下痕迹。务必按顺序逐项排除，别靠猜。