如何配置phpMyAdmin 5.2支持PHP 8.3？

必须升级phpMyAdmin至5.3.0+并启用mysqli扩展，因PHP 8.3已彻底移除mysql_*函数且无兼容层，旧版5.2.x代码中调用即报Fatal error，降级PHP或仅启用扩展均无效。

phpMyAdmin 5.2 在 PHP 8.3 下报 Call to undefined function mysql_connect() 怎么办

根本没法配——phpMyAdmin 5.2.x 不支持 PHP 8.3，不是配置问题，是代码里真调用了已被彻底删除的 mysql_* 函数。PHP 8.3 连兼容层都不留，一走到相关分支就 fatal error。

常见现象：

1. 刚打开首页就白屏，错误日志里明确出现 mysql_connect、mysql_query 或 mysql_num_rows
2. 哪怕只做存在性判断（如 function_exists('mysql_connect')），也会触发未定义函数错误

别试降级 PHP 版本绕过——PHP 8.2 同样没有 mysql_*，能跑只是旧版 phpMyAdmin 没走到那段分支，属于侥幸，不可靠。

为什么启用 mysqli 扩展后还是提示“缺少 mysqli 扩展”

因为 phpMyAdmin 检查的是运行时实际加载的扩展，不是你“以为启用了”的那个。

实操要点：

1. 确认当前 phpMyAdmin 绑定的 PHP 实例路径：执行 ps aux | grep phpmyadmin，看进程里用的是 /www/server/php/83/bin/php-cgi 还是 /www/server/php/82/bin/php-cgi ——版本号就在路径末尾数字里
2. 去对应版本的 php.ini（比如 PHP 8.3 就是 /www/server/php/83/etc/php.ini），确保有且仅有一行未注释的：extension=mysqli
3. 检查扩展目录是否正确：extension_dir 必须指向含 mysqli.so（Linux）或 php_mysqli.dll（Windows）的目录
4. 改完必须重启 PHP-CGI 进程：killall -9 php-cgi，再重启宝塔或对应服务，否则配置不生效

升级到 phpMyAdmin 5.3+ 后仍报 mysqli_real_escape_string(): Argument #1 ($mysql) must be of type mysqli, null given

这是新版对连接对象校验更严格导致的，通常发生在配置错位或连接未建立成功时。

关键排查点：

1. $cfg['Servers'][$i]['auth_type'] 设为 'config' 但数据库凭据填错，导致连接对象为 null；临时改成 'cookie' 能登录就说明是这个原因
2. 检查 $cfg['Servers'][$i]['host'] 值：设成 'localhost' 会走 socket 文件，而 PHP 8.3 默认可能找不到 mysql.sock；改成 '127.0.0.1' 强制走 TCP
3. 确认 MySQL 服务确实在运行，且监听地址允许该 PHP 实例访问（尤其 Docker 或远程 MySQL 场景）

导入 CSV 时中文乱码或字段数错误，和 PHP 版本有关吗

无关。这类问题纯属导入配置与文件实际格式不匹配，PHP 版本升级不会改变 CSV 解析逻辑。

必须手动核对：

1. 用 Notepad++ 或 VS Code 打开 CSV 文件，**肉眼确认第一行真实分隔符** —— 是逗号、分号还是制表符？填到 phpMyAdmin 导入页的“字段分隔符”框里，前后不能有空格
2. 编码必须是 UTF-8 无 BOM；Excel 导出选“CSV (逗号分隔)”而非“CSV UTF-8”，后者自带 BOM，phpMyAdmin 不识别
3. 字符集下拉框选 utf8mb4，且目标表的 COLLATION 也得是 utf8mb4_unicode_ci 类型，否则 SELECT 仍乱码

真正卡住人的地方，往往不是版本号写错了，而是进程绑定了哪个 PHP 实例、php.ini 改了哪一份、CSV 文件到底用什么字符分隔——这些细节不亲眼确认，光看报错信息容易绕远路。