PHP 8.2+ 运行 phpMyAdmin 5.2.x 报错因 string 等成保留字，须升级至 5.3.0+（PHP 8.2）或 5.4.0+（PHP 8.3）；同时需正确配置 $cfg['TempDir'] 权限、验证数据库凭据、调高超时限制，并完整覆盖 vendor/ 和 js/dist/ 文件。
PHP 8.2+ 导入时提示 ParseError: syntax error, unexpected token "string"
这是 phpmyadmin 5.2.x 及更早版本在 php 8.2+ 上的典型兼容问题，根源是旧版代码里用了 string、int、bool 这类新保留字作变量名或类属性名。php 8.2 把它们正式列为保留关键字，解析器直接报错，连登录页都打不开。
实操建议：
- 确认当前 phpMyAdmin 版本：
cat /path/to/phpmyadmin/VERSION—— 若是5.2.1或更低，必须升级 - 不要尝试打补丁或注释掉报错行：这些关键字散落在
PMA\libraries\classes\和libraries/classes/多个文件中（如DatabaseInterface.php），手动改极易遗漏或引发新错误 - PHP 8.2 推荐搭配 phpMyAdmin
5.3.0+；PHP 8.3 则至少要5.4.0+，否则仍会遇到mixed类型声明冲突
升级前必须检查 config.inc.php 中的 $cfg['TempDir'] 权限
新版 phpMyAdmin（5.3+）默认启用服务端导入预处理，严重依赖临时目录写入能力。如果 $cfg['TempDir'] 指向的路径不可写，或仍沿用旧版默认值（如 ./tmp/），上传大 SQL 文件时会静默失败，只显示“未选择文件”或空错误提示。
实操建议：
- 在
config.inc.php中显式设置：$cfg['TempDir'] = '/var/lib/phpmyadmin/tmp'; - 确保该路径由 Web 服务器用户（如
www-data或apache）可写：sudo chown www-data:www-data /var/lib/phpmyadmin/tmp && sudo chmod 750 /var/lib/phpmyadmin/tmp - 避免设为
/tmp根目录——部分系统启用了private tmp隔离，Web 进程实际看不到里面的内容
从 5.2 升级到 5.4 后，mysqli 扩展报 mysqli_real_escape_string(): Argument #1 ($mysql) must be of type mysqli, null given
这不是扩展没装，而是新版对连接初始化更严格：当 $cfg['Servers'][$i]['auth_type'] 设为 config 且数据库凭据错误时，旧版会降级回登录页，新版直接抛出未初始化的 mysqli 实例调用异常，导致整个页面白屏。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
- 检查
config.inc.php中每个$i对应的$cfg['Servers'][$i]['host']、$cfg['Servers'][$i]['user']、$cfg['Servers'][$i]['password']是否真实有效（尤其 Docker 环境常因网络别名失效） - 临时将
$cfg['Servers'][$i]['auth_type']改为cookie，验证是否能正常登录——若可以，说明凭据或 host 解析有问题 - PHP 8.3 下还须确认
mysqli扩展已启用：php -m | grep mysqli，某些精简镜像默认不带
升级后导入大 SQL 文件卡在“正在分析…”且无进度条
phpMyAdmin 5.3+ 默认关闭了客户端 JavaScript 分块解析，转而依赖服务端 ini_set('memory_limit', ...) 和 max_execution_time。但很多运维习惯性保留旧版 Nginx/Apache 超时配置（如 fastcgi_read_timeout 60），导致请求被代理层中断，前端只看到卡住。
实操建议：
- 调高 PHP 层限制：
ini_set('memory_limit', '1G');和set_time_limit(0);加到config.inc.php开头（注意：仅限可信内网环境） - Nginx 用户需同步调整：
fastcgi_read_timeout 600;和client_max_body_size 512M; - 真正超大文件（>200MB）别硬扛：用命令行
mysql -u user -p database < file.sql更稳，phpMyAdmin 本质是管理界面，不是导入工具
最易被忽略的一点：phpMyAdmin 升级不是替换文件就完事，vendor/ 目录和 js/dist/ 下的构建产物必须完整更新。用官方 ZIP 包解压覆盖，别用 rsync 差量同步——漏掉一个 manifest.json 就可能导致 JS 模块加载失败，错误藏在浏览器控制台里，后端日志完全安静。
