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-available/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 打开 → 右下角点击编码 → “Save 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 解析完配置后，在初始化阶段才崩溃，此时连日志都可能不留痕迹。请务必按顺序逐项排除，切勿依靠猜测。