怎么在phpMyAdmin配置连接本地多个MySQL服务_多端口本地测试-phpMyAdmin-PHP中文网

phpMyAdmin 能连接多个本地 MySQL 实例，但需手动在 config.inc.php 中定义多个 $cfg['Servers'][n] 条目，明确指定 host、port 等参数，并设 $cfg['ServerDefault'] = 0 强制下拉选择。

phpMyAdmin 能不能连多个本地 MySQL 实例

能，但不是靠“添加多个服务器”界面点几下就完事——config.inc.php 里必须手动定义多个 $cfg['servers'] 条目，且每个都要明确指定 host、port、socket（如果走 socket）或 connect_type。默认安装只配了 $cfg['servers'][1]，多实例必须从 [1] 开始往后递增编号，比如 [2]、[3]。

配置多个端口时最常踩的坑

现象：点了第二个服务器链接，却还是进到第一个 MySQL 实例；或者报错 #2002 Cannot log in to the MySQL server。

port 值写错（比如填成字符串 '3307' 而不是整数 3307，PHP 会静默转成 0）
漏设 $cfg['Servers'][$i]['host'] = '127.0.0.1' —— 如果只写 'localhost'，MySQL 会优先走 socket 连接，无视 port
没关掉 $cfg['Servers'][$i]['auth_type'] = 'cookie' 下的自动跳转逻辑，导致始终 fallback 到默认服务器
多个实例用了相同 $cfg['Servers'][$i]['verbose'] 名字，phpMyAdmin 下拉菜单里分不清谁是谁

一个可用的双实例 config.inc.php 片段

假设你本地跑着 3306（默认）和 3307（自定义端口），MySQL 都监听 127.0.0.1：

$cfg['Servers'][1]['host'] = '127.0.0.1';
$cfg['Servers'][1]['port'] = 3306;
$cfg['Servers'][1]['verbose'] = 'MySQL 3306';

$cfg['Servers'][2]['host'] = '127.0.0.1';
$cfg['Servers'][2]['port'] = 3307;
$cfg['Servers'][2]['verbose'] = 'MySQL 3307';

// 必须加这行，否则 phpMyAdmin 可能不显示下拉选择
$cfg['ServerDefault'] = 0;

注意：$cfg['ServerDefault'] = 0 表示“不预选任何服务器”，强制用户点击下拉菜单选择；设成 1 就默认进第一个，设成 2 就默认进第二个。

Windows 下用命名 pipe 或 WSL 时的特殊处理

如果你的第二个 MySQL 实例跑在 WSL 里，或者 Windows 上启用了命名 pipe（mysql.sock 不适用），就不能依赖 host = 'localhost'：

WSL 实例：用 $cfg['Servers'][2]['host'] = '127.0.0.1' + 明确 port，确保 WSL 的 MySQL 绑定到了 0.0.0.0:3307 并放行 Windows 防火墙
命名 pipe（仅 Windows）：必须设 $cfg['Servers'][2]['connect_type'] = 'socket' 且 $cfg['Servers'][2]['socket'] = 'C:/path/to/mysql.sock'，port 字段此时无效
任意场景下，改完 config.inc.php 后要清浏览器 cookie 或换无痕窗口，否则旧登录态可能干扰服务器切换

端口冲突、host 解析歧义、auth_type 和 ServerDefault 的联动关系——这些地方不动手试一遍，光看文档根本绕不过去。