phpMyAdmin 5.2 在 PHP 8.3 下无法启动，主因是 mysqli 和 mbstring 扩展未启用、$cfg['blowfish_secret'] 缺失或 $cfg['TempDir'] 配置不当，三者任一缺失均导致白屏或报错。
phpMyAdmin 5.2 在 PHP 8.3 下无法启动，大概率不是版本不兼容，而是 mysqli、mbstring 扩展未启用或 $cfg['blowfish_secret'] 缺失 —— 这两个是硬性门槛，缺一不可。
确认 mysqli 和 mbstring 扩展已启用
PHP 8.3 默认不自动加载所有扩展，而 phpMyAdmin 5.2 依赖 mysqli（数据库连接）和 mbstring（多字节字符串处理，用于编码检测、JSON 解析等）。哪怕只缺一个，就会报“缺少 mysqli 扩展”或白屏无提示。
- Linux（如宝塔/Nginx+PHP-FPM）：进 PHP 设置 →「扩展管理」→ 确保
mysqli和mbstring已勾选启用；若用命令行，检查php -m | grep -E 'mysqli|mbstring'是否有输出 - Windows（如 phpStudy、WampServer）：打开
php.ini，确认以下两行已取消注释且路径正确：extension=php_mysqli.dllextension=php_mbstring.dll
同时确认extension_dir指向正确的ext/目录（如extension_dir = "E:/php/ext"） - 重启 PHP 服务（不是仅重启 Web 服务器）——否则扩展不会真正加载
必须手动配置 config.inc.php 的两个关键项
phpMyAdmin 5.2 不再容忍缺失配置。从官网下载解压后，config.sample.inc.php 必须重命名为 config.inc.php，并至少补全以下两项，否则登录页 JS 加密失败、会话初始化中断、页面直接空白：
-
$cfg['blowfish_secret']必须是非空 32 字符以上随机字符串（例如'6a9f8c2e1d4b7a0f3c9e2d1b8a5f0c3e'），不能留空或用默认占位符 -
$cfg['TempDir']必须显式指定一个 Nginx/Apache 进程用户（如www-data或apache）有读写权限的目录，例如：$cfg['TempDir'] = '/var/lib/phpmyadmin/tmp';
别用系统/tmp—— 很多发行版挂载时带noexec或nosuid，会导致模板编译失败
Nginx 下需压制 PHP 8.3 的 E_DEPRECATED 提示
PHP 8.3 对弃用函数的提示更严格，phpMyAdmin 5.2.1+ 虽声明支持，但仍调用少量被标记为 @deprecated 的反射或 mbstring 内部逻辑。这些不是错误，但 E_DEPRECATED 会输出到响应体开头，破坏 HTML 结构，导致 AJAX 失败、登录跳转中断、JS 报错。
立即学习“PHP免费学习笔记（深入）”；
- 不能改全局
php.ini的error_reporting，否则你自己的业务代码警告也被掩盖 - 应在 Nginx 的 phpMyAdmin location 块中单独压制：
fastcgi_param PHP_VALUE "error_reporting = E_ALL & ~E_DEPRECATED & ~E_NOTICE"; - 确保该行在
fastcgi_pass之后、且未被其他fastcgi_param或php_admin_value覆盖（Nginx 配置后写的生效） - 改完必须重启
php8.3-fpm和nginx，浏览器用 Ctrl+Shift+R 硬刷新，并清空$cfg['TempDir']下缓存文件
宝塔或一键环境里别硬塞进网站根目录
宝塔 8.x 及多数一键环境默认禁用 phpMyAdmin 是有原因的：它的路由和权限模型与面板的多用户隔离机制冲突，直接解压到 /www/wwwroot/xxx.com/phpmyadmin 极易触发 403 或空白页。
- 不要复用旧版
config.inc.php—— 5.2.x 配置结构已调整，尤其$cfg['Servers'][$i]['auth_type']默认是cookie，若误设为http却没配好 Web 服务器认证，会静默失败 - 推荐走「独立子目录 + 显式 alias」方式：新建站点或子目录，Nginx 配置中用
alias指向 phpMyAdmin 实际路径，并确保该 location 块内包含 PHP 处理逻辑（location ~ \.php$必须能命中） - 部署后立即检查 Nginx 错误日志（如
/www/wwwlogs/xxx.error.log），比看浏览器更有用 —— 很多问题（如权限拒绝、找不到扩展）只记在日志里
最容易被忽略的是 $cfg['TempDir'] 权限和 PHP_VALUE 的作用域。前者写错路径或权限不对，会导致 session 初始化失败，现象是反复跳回登录页；后者若没限定在 phpMyAdmin 的 location 块内，就等于关掉了整个 PHP 应用的弃用提示，埋下维护隐患。
