直接写IP或域名导致配置难维护，因地址变更需改代码重启，且$cfg['Servers'][$i]['verbose']未设时下拉列表只显示IP无法区分；应通过关联数组统一管理host与verbose映射，并确保port、extension、MySQL远程权限等连接参数正确。
为什么直接写 IP 或域名会导致配置难维护
当你在 $cfg['servers'][$i]['host'] 里硬编码 '192.168.1.10' 或 'db-prod.example.com'，后续只要服务器地址变更、端口调整、或想加别名（比如叫“测试库”“生产库”），就得改代码、重启服务、还容易漏掉某一处。更麻烦的是，$cfg['servers'][$i]['verbose'] 不填的话，下拉列表里只显示 ip，根本分不清哪个是哪个。
用 $cfg['Servers'][$i]['verbose'] 设置可读主机名
这个字段就是专门用来显示在登录页下拉框里的文字标签，它不参与连接，只负责“叫什么”。必须显式设置，否则 phpMyAdmin 默认不显示该服务器项（尤其在多服务器循环配置中）。
-
$cfg['Servers'][$i]['verbose']值建议用简短、无空格、带环境标识的字符串，比如'local-dev'、'staging-mariadb'、'prod-us-east' - 它和
$cfg['Servers'][$i]['host']完全解耦：一个管显示，一个管连哪儿 - 如果
$cfg['Servers'][$i]['verbose']为空或未定义，该服务器可能在登录页消失——这是最常被忽略的坑
结合数组循环统一管理 host + verbose 映射
别手动写一堆 $cfg['Servers'][1]、$cfg['Servers'][2]……用关联数组一次性定义「别名 → 连接参数」，再用 foreach 拆解，既防错又易扩展。
$server_list = [
'dev-local' => ['host' => '127.0.0.1', 'port' => 3306, 'user' => 'root', 'password' => ''],
'test-docker' => ['host' => '172.18.0.1', 'port' => 3307, 'user' => 'app', 'password' => 'secret'],
'prod-remote' => ['host' => '10.0.2.5', 'port' => 3306, 'user' => 'admin', 'password' => 'xxx'],
];
$i = 0;
foreach ($server_list as $verbose_name => $conf) {
$i++;
$cfg['Servers'][$i]['verbose'] = $verbose_name;
$cfg['Servers'][$i]['host'] = $conf['host'];
$cfg['Servers'][$i]['port'] = $conf['port'] ?? 3306;
$cfg['Servers'][$i]['user'] = $conf['user'];
$cfg['Servers'][$i]['password'] = $conf['password'];
$cfg['Servers'][$i]['auth_type'] = 'cookie';
$cfg['Servers'][$i]['connect_type'] = 'tcp';
$cfg['Servers'][$i]['extension'] = 'mysqli';
}
注意：$i 必须从 0 开始并在循环内递增；索引必须为整数且从 1 起跳，不能用字符串键（如 $cfg['Servers']['dev-local'] 无效）。
别名生效后仍连不上？检查三个关键点
下拉列表能看见别名，不代表真能连。常见断连原因不是别名设错了，而是底层连接参数没对齐：
-
$cfg['Servers'][$i]['port']没配时默认走 3306，但 Docker 或远程服务器常改端口，漏写就会超时 -
$cfg['Servers'][$i]['extension']必须是'mysqli'（PHP 7.0+ 已弃用'mysql'），写错会报Extension not found - 远程服务器未开启远程访问：MySQL 用户权限需包含
'user'@'%'或具体 IP，且bind-address不能是127.0.0.1
真正麻烦的从来不是起个好名字，而是每个 $cfg['Servers'][$i] 块里那几行看似重复、实则一碰就断的连接参数——别名只是表，连接细节才是里。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
