升级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 解析完配置后才在初始化阶段挂掉，此时连日志都未必留下痕迹。务必按顺序逐项排除，别靠猜。
