phpmyadmin 5.2 必须显式设置 connect_type 为 'socket' 或 'tcp'，host 与 socket 不可共存，索引需从 1 开始连续递增，混用实例时统一用 auth_type='cookie' 并确保 socket 文件权限正确。
phpMyAdmin 5.2 不支持自动识别 socket 或 tcp 模式，必须显式指定 connect_type
phpMyAdmin 5.2 读取 $cfg['Servers'][$i] 时，connect_type 默认是 'tcp'，哪怕你填了 'localhost' 也不会自动切到 socket。它不会“猜”你要走哪条路——填了 host => 'localhost' + 没设 connect_type，它就走 TCP；填了 socket => '/tmp/mysql.sock' 但没关 host，它可能优先用 host 导致连接失败。
实操建议：
-
connect_type必须明确设为'socket'或'tcp'，不能省略 - 走 socket 时，
host字段可留空或设为''（不是'localhost'），否则 phpMyAdmin 可能忽略socket配置 - 走 TCP 时，
host必须是 IP 或可解析域名，port必须显式写出（如3307），不能依赖默认值 - 一个实例不能同时启用
socket和host——二者冲突，后者会覆盖前者
混合配置时，$i 索引错一位，整个后续列表就全丢
phpMyAdmin 5.2 解析 $cfg['Servers'] 数组时，只认从 1 开始的连续整数索引。写成 $i = 0 → $i++ → $cfg['Servers'][$i]['host'] 是对的；但若中间漏掉一次 $i++，或误写 $cfg['Servers'][2]['host'] 后又写 $cfg['Servers'][2]['port']（重复索引），后者的值会覆盖前者，导致该条目只剩 port、没 host。
常见错误现象：登录页下拉框里只显示 1 个服务器，或点开后报 Cannot log in to the MySQL server，但配置文件里明明写了 3 条。
实操建议：
- 所有服务器块前统一用
$i++，不要手动赋值$i = 2这类操作 - 每个服务器配置块之间不加空行或注释干扰（phpMyAdmin 不解析注释，但人容易看串行）
- 配完用
var_dump(array_keys($cfg['Servers']));临时加在 config.inc.php 末尾，确认输出是array(1, 2, 3)而非array(1, 3)
MySQL 实例混用 socket 和 TCP 时，auth_type = 'cookie' 是唯一安全选项
如果你有 1 个本地 socket 实例（/var/lib/mysql.sock）和 1 个远程 TCP 实例（10.0.1.5:3308），auth_type = 'http' 会彻底失效：Nginx 剥离 Authorization 头、phpMyAdmin 拿不到原始凭据、不同实例无法区分账号。而 auth_type = 'config' 把密码明文写死在配置里，一旦某实例用的是 MySQL 8.0+ 的 caching_sha2_password 插件，连不上就是静默失败。
实操建议：
- 全部设
'auth_type' => 'cookie'，登录页选服务器 → 手动输对应账号密码 → 凭据存在 session 里 - 确保每个
$cfg['Servers'][$i]块里都删掉socket或host中冗余项：socket 实例删host和port，TCP 实例删socket - MySQL 8.0+ 实例提前执行
ALTER USER 'xxx'@'%' IDENTIFIED WITH mysql_native_password BY 'xxx';，避免插件不兼容
Unix socket 路径权限不对，连得上也查不了 information_schema
即使 connect_type = 'socket' + socket = '/tmp/mysql3307.sock' 都对，phpMyAdmin 登录后仍可能报 #1045 - Access denied for user 'root'@'localhost' 或卡在加载数据库列表。这不是认证失败，而是 PHP 进程用户（如 www-data）没权限读 socket 文件，导致 MySQL 认为连接来自 'root'@'localhost'（socket 上的 localhost 和 TCP 上的 localhost 是两个身份）。
实操建议：
- 检查 socket 文件权限：
ls -l /tmp/mysql3307.sock，确保属组包含 web 用户（如mysql:www-data），且权限至少是srw-rw---- - MySQL 配置里加
user=mysql和group=www-data（或对应 web 组），启动时自动 chown - 避免把 socket 放在
/tmp下——某些系统重启清空 tmp，改用/var/run/mysqld/mysql3307.sock
配置多实例时最易被忽略的不是语法，而是 MySQL 层面对 localhost 的双重语义：它既是 socket 标识符，又是 TCP 主机名。phpMyAdmin 不做转换，你填什么，它就传什么。填错一个字段，后面十条配置都白写。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
