必须升级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。
常见现象：
- 刚打开首页就白屏，错误日志里明确出现
mysql_connect、mysql_query或mysql_num_rows - 哪怕只做存在性判断（如
function_exists('mysql_connect')），也会触发未定义函数错误
别试降级 PHP 版本绕过——PHP 8.2 同样没有 mysql_*，能跑只是旧版 phpMyAdmin 没走到那段分支，属于侥幸，不可靠。
为什么启用 mysqli 扩展后还是提示“缺少 mysqli 扩展”
因为 phpMyAdmin 检查的是运行时实际加载的扩展，不是你“以为启用了”的那个。
实操要点：
立即学习“PHP免费学习笔记（深入）”；
- 确认当前 phpMyAdmin 绑定的 PHP 实例路径：执行
ps aux | grep phpmyadmin，看进程里用的是/www/server/php/83/bin/php-cgi还是/www/server/php/82/bin/php-cgi——版本号就在路径末尾数字里 - 去对应版本的
php.ini（比如 PHP 8.3 就是/www/server/php/83/etc/php.ini），确保有且仅有一行未注释的：extension=mysqli - 检查扩展目录是否正确：
extension_dir必须指向含mysqli.so（Linux）或php_mysqli.dll（Windows）的目录 - 改完必须重启 PHP-CGI 进程：
killall -9 php-cgi，再重启宝塔或对应服务，否则配置不生效
升级到 phpMyAdmin 5.3+ 后仍报 mysqli_real_escape_string(): Argument #1 ($mysql) must be of type mysqli, null given
这是新版对连接对象校验更严格导致的，通常发生在配置错位或连接未建立成功时。
关键排查点：
-
$cfg['Servers'][$i]['auth_type']设为'config'但数据库凭据填错，导致连接对象为null；临时改成'cookie'能登录就说明是这个原因 - 检查
$cfg['Servers'][$i]['host']值：设成'localhost'会走 socket 文件，而 PHP 8.3 默认可能找不到mysql.sock；改成'127.0.0.1'强制走 TCP - 确认 MySQL 服务确实在运行，且监听地址允许该 PHP 实例访问（尤其 Docker 或远程 MySQL 场景）
导入 CSV 时中文乱码或字段数错误，和 PHP 版本有关吗
无关。这类问题纯属导入配置与文件实际格式不匹配，PHP 版本升级不会改变 CSV 解析逻辑。
必须手动核对：
- 用 Notepad++ 或 VS Code 打开 CSV 文件，**肉眼确认第一行真实分隔符** —— 是逗号、分号还是制表符？填到 phpMyAdmin 导入页的“字段分隔符”框里，前后不能有空格
- 编码必须是 UTF-8 无 BOM；Excel 导出选“CSV (逗号分隔)”而非“CSV UTF-8”，后者自带 BOM，phpMyAdmin 不识别
- 字符集下拉框选
utf8mb4，且目标表的COLLATION也得是utf8mb4_unicode_ci类型，否则 SELECT 仍乱码
真正卡住人的地方，往往不是版本号写错了，而是进程绑定了哪个 PHP 实例、php.ini 改了哪一份、CSV 文件到底用什么字符分隔——这些细节不亲眼确认，光看报错信息容易绕远路。
