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

升级PHP后phpMyAdmin白屏主因是mysqli或php-gettext扩展未启用、config.inc.php语法错误或启动阶段崩溃；需验证扩展加载、检查配置文件语法并启用错误显示。

升级 php 后 phpmyadmin 白屏，大概率不是“兼容性问题”本身，而是旧配置、缺失扩展或启动阶段崩溃被静默吞掉了——php 7.4+ 和 8.x 对扩展加载、错误报告、bom 处理更严格，老环境里能蒙混过关的配置，一升级就直接终止输出。

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 内容为 <?php var_dump(function_exists('gettext'));，返回 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 ... */ 这类写法在 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），导致致命错误发生时浏览器只收空响应。

立即学习“PHP免费学习笔记（深入）”；

• 临时补救：在 phpMyAdmin 的 index.php 顶部（<?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 解析完配置后才在初始化阶段挂掉，此时连日志都未必留下痕迹。务必按顺序逐项排除，别靠猜。