phpmyadmin 5.2.1是首个官方支持php 8.2的稳定版，但必须完整替换旧包、正确配置blowfish_secret（≥32字符）、将host设为127.0.0.1而非localhost、启用mysqli和mbstring扩展，并清理残留文件，否则会报错或白屏。
phpmyadmin 5.2.1 是首个官方支持 php 8.2 的稳定版，但必须完整替换旧包、正确配置 blowfish_secret 和数据库连接参数，否则会直接报错或白屏——不是版本“能跑”，而是“跑对了才不崩”。
确认你真在用 5.2.1+ 版本
旧版（如 5.2.0 或更早）在 PHP 8.2 下解析即失败，典型错误是：ParseError: syntax error, unexpected token "string"。别信“下载页写着 5.2 就行”，必须精确到小版本：
- 执行
cat /www/server/phpmyadmin/VERSION（宝塔）或查看解压目录下的VERSION文件 - 低于
5.2.1的所有版本都不可用，包括5.2.0 - 推荐直接上
5.4.0（已适配 PHP 8.3+），避免后续升级麻烦
必须改的三处 config.inc.php 配置
光有新包不够，config.inc.php 里这几行写错，登录页都出不来：
-
$cfg['blowfish_secret']必须设为 32 字符随机串，不能留空或用默认值；可用openssl rand -base64 24生成 -
$cfg['Servers'][$i]['host']别写localhost——PHP 8.2 + MySQL 默认走 socket，而 phpMyAdmin 5.2+ 要求 TCP 连接；改成127.0.0.1或实际 IP -
$cfg['Servers'][$i]['auth_type']暂时设为'cookie'，别用'config'；后者在凭据错误时会直接抛出mysqli_real_escape_string(): Argument #1 ($mysql) must be of type mysqli, null given白屏
权限与扩展：两个容易被跳过的硬性条件
即使版本和配置都对，这两点没到位，照样 500 或报错：
-
config.inc.php权限必须是644，tmp/目录权限必须是755且 Web 用户可写；宝塔用户尤其注意，上传后常被自动设成600 - PHP 必须启用
mysqli和mbstring扩展；宝塔用户进「PHP 设置 → 扩展管理」勾选它们，并确认「禁用函数」里没删掉mysqli_connect
弃用警告污染 WordPress 界面？别动全局 error_reporting
PHP 8.2 的 E_DEPRECATED 警告从 phpMyAdmin 泄露到整个站点（比如 WordPress 后台顶部一堆黄条），根源是 Web 服务器把错误级别透传了：
- 不要改全局
php.ini的error_reporting，否则你自己的代码问题也被掩盖 - Nginx 用户，在站点配置的
location ~ \.php$块里加：fastcgi_param PHP_VALUE "error_reporting = E_ALL & ~E_DEPRECATED & ~E_NOTICE"; - Apache 用户，在
<directory></directory>块内用php_admin_value error_reporting "E_ALL & ~E_DEPRECATED & ~E_NOTICE"，确保位置靠前 - 改完清空 phpMyAdmin 的
tmp/目录，再硬刷新（Ctrl+Shift+R）
最常被忽略的其实是残留文件——升级时只覆盖了主目录，却没删干净旧版的 ./libraries/vendor/ 或 ./tmp/，导致部分老代码仍在执行。彻底清空再解压，比“覆盖升级”少踩 80% 的坑。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
