phpMyAdmin 通过 $cfg['Servers'][$i]['host'] = 'localhost' 与 $cfg['Servers'][$i]['socket'] 联合识别不同 MySQL 实例的 socket 文件；仅当 host 严格为 'localhost' 时 socket 参数生效，若设为 '127.0.0.1' 则强制走 TCP 并忽略 socket 设置。
phpMyAdmin 怎么识别不同 MySQL 实例的 socket 文件
phpMyAdmin 本身不直接解析 socket 路径做连接，它依赖 PHP 的 mysqli 或 pdo_mysql 扩展，而这两个扩展在连接时：当 host 是 localhost，会强制走 Unix socket（忽略 port）；只有指定 host = 127.0.0.1 才走 TCP。所以「配置不同 socket 路径」这件事，实际要靠两层配合：MySQL 实例自身暴露正确的 socket 路径 + phpMyAdmin 显式用 host + socket 组合连接。
$cfg['Servers'][$i]['socket'] 必须和 $cfg['Servers'][$i]['host'] 配合使用
phpMyAdmin 从 4.x 开始支持 $cfg['Servers'][$i]['socket'] 参数，但它**仅在 host 值为 localhost 时生效**——注意不是“任意字符串”，必须是字面量 'localhost'。如果填了 127.0.0.1，这个 socket 字段会被完全忽略。
-
$cfg['Servers'][1]['host'] = 'localhost';→ 此时$cfg['Servers'][1]['socket'] = '/data/mysql/instance1/socket/mysql.sock';才起作用 -
$cfg['Servers'][2]['host'] = '127.0.0.1';→ 即使设了socket，PHP 也会走 TCP 连port，不会读该路径 - 多个实例共用
localhost时，必须确保每个实例的socket路径互不重叠，且文件可被 web 服务器用户（如www-data或apache）读取
本地多实例连接失败最常见的三个原因
连不上不是配置没写对，而是底层机制被绕过了。典型现象：页面报错 mysqli::real_connect(): (HY000/2002): No such file or directory，或直接空白页。
- MySQL 实例没启动，或者
socket路径写错（比如漏掉/mysql.sock后缀，或路径权限不对） - phpMyAdmin 配置里用了
host = 'localhost'，但对应实例实际监听的是127.0.0.1:3307（即禁用了 socket），此时必须改用host = '127.0.0.1'+port，放弃socket - SELinux 或 AppArmor 拦截了 web 进程访问 socket 文件（CentOS/RHEL 常见），临时验证可执行：
setsebool -P httpd_can_network_connect_db 1
一个能跑通的最小配置示例
假设你有两个本地实例：
立即学习“PHP免费学习笔记（深入）”；
instance1：port=3307，socket=/data/mysql/instance1/socket/mysql.sock instance2：port=3308，socket=/data/mysql/instance2/socket/mysql.sock
在 config.inc.php 中这样写：
$cfg['Servers'][1]['host'] = 'localhost'; $cfg['Servers'][1]['socket'] = '/data/mysql/instance1/socket/mysql.sock'; $cfg['Servers'][1]['port'] = '3307'; // 这行可省，但建议留着作标识 $cfg['Servers'][2]['host'] = 'localhost'; $cfg['Servers'][2]['socket'] = '/data/mysql/instance2/socket/mysql.sock'; $cfg['Servers'][2]['port'] = '3308';
注意：不要给 $cfg['Servers'][*] 设置 user 和 password ——这会让所有实例共享同一套登录凭据，违背多实例隔离初衷；应保持空值，让每次登录手动输账号密码。
真正容易被忽略的是 socket 文件的属主和 SELinux 上下文 —— 写对路径只是第一步，web 进程得有权限打开它才行。
