必须将host设为'localhost'、socket填绝对路径且port留空，才能启用MySQL Unix socket连接；因'localhost'强制触发socket逻辑，而'127.0.0.1'强制走TCP，且phpMyAdmin不读php.ini的socket设置，须显式配置匹配MySQL实际socket路径。
必须在 config.inc.php 中为每个服务器单独配置 socket 字段，且不能和 host、port 冲突 —— 否则 phpmyadmin 会忽略 socket 或报错 #2002。
为什么 host = 'localhost' 不等于走 socket？
MySQL 客户端库对 'localhost' 和 '127.0.0.1' 的处理完全不同：'localhost' 强制触发 Unix socket 连接逻辑；'127.0.0.1' 强制走 TCP。但前提是：你得显式告诉 phpMyAdmin socket 文件在哪，否则它会 fallback 到默认路径（比如 /tmp/mysql.sock），而这个路径很可能和 MySQL 实际用的不一致。
常见错误现象：#2002 Cannot log in to the MySQL server，查日志发现连接被拒绝，实际就是 phpMyAdmin 去错了 socket 路径。
-
host必须设为'localhost'（字符串字面量，不能是变量或空） -
socket必须填绝对路径，例如'/var/run/mysqld/mysqld.sock' -
port必须留空或设为''，设成3306会覆盖 socket 逻辑 - 若用 Docker 或非标准部署，确认该路径在 phpMyAdmin 所在容器/系统中真实可访问（不是 MySQL 容器内部路径）
怎么确认 MySQL 实际用的 socket 路径？
别猜，直接问 MySQL 服务本身。登录后执行：
mysql> SHOW VARIABLES LIKE 'socket';
或者命令行运行：
立即学习“PHP免费学习笔记（深入）”；
mysqladmin -u root -p variables | grep socket
输出类似 UNIX socket | /var/lib/mysql/mysql.sock —— 这个值才是真实路径，必须一字不差地复制到 phpMyAdmin 配置里。
- 如果
mysqladmin报Can't connect to local MySQL server through socket，说明 mysqld 没起来，或你当前用户没权限读 socket 目录 - 路径中不能有软链接未展开的情况（如
/var/run → /run），phpMyAdmin 不解析 symlink - PHP 进程用户（如 www-data）必须对 socket 文件及其父目录有读+执行权限（
ls -ld /var/run/mysqld看权限）
多个服务器共存时，socket 路径能一样吗？
可以，但仅限于它们本就是同一个 MySQL 实例；如果配的是多个独立实例（比如不同端口、不同数据目录），那每个实例的 socket 路径必须不同，否则启动会冲突。
例如本地跑两个 MySQL：一个默认 3306 + /var/run/mysqld/mysqld.sock，另一个 3307 + /var/run/mysqld/mysqld-3307.sock。这时 phpMyAdmin 的两个 $cfg['Servers'][1] 和 $cfg['Servers'][2] 就要分别指向这两个路径。
- 每个
$cfg['Servers'][$i]的socket值必须唯一且匹配对应实例 - 不能复用前一个服务器的
socket字段却不改host或port，否则登录时可能连错实例 - 修改后务必检查
config.inc.php语法（比如末尾少逗号、引号不闭合），会导致整个 phpMyAdmin 白屏
php.ini 里的 mysqli.default_socket 还用管吗？
不用。phpMyAdmin 完全绕过 PHP 全局 socket 设置，它自己通过 mysqli_real_connect() 显式传入 socket 参数。所以即使你改了 php.ini，对 phpMyAdmin 无效。
但要注意：如果你在 phpMyAdmin 里用了“执行 SQL”功能调用 LOAD DATA INFILE 或 SOURCE，而这些操作依赖 MySQL 服务端路径解析，那么 MySQL 自身的 secure_file_priv 和 socket 所在磁盘的挂载方式就变得关键 —— 这属于更深层的权限链问题，不在 phpMyAdmin 配置范围内。
真正容易被忽略的是：socket 路径写对了，但父目录权限不对，或者 SELinux/AppArmor 拦截了 PHP 进程访问 socket 文件 —— 这类问题不会报路径错误，而是静默失败或超时。
