手动写 $i++ 易出错，因顺序、作用域或条件分支导致索引跳号、重复或覆盖；PHP解析到语法错误、空值或缺失host/auth_type时会中止遍历，后续服务器全不加载。
为什么手动写 $i++ 容易出错
直接在 config.inc.php 里反复写 $i++、再赋值到 $cfg['servers'][$i]，看似简单，实则极易因顺序、作用域或条件分支导致索引跳号、重复或覆盖。比如把两个服务器配置分别塞进 if ($env === 'prod') 和 else 块里，$i 在不同分支里各自递增，最终可能只生成 $cfg['servers'][1] 和 $cfg['servers'][1]（后者覆盖前者），或者漏掉中间编号。
更隐蔽的问题是：PHP 解析时遇到语法错误（如注释后紧跟数组赋值）、空值或缺失必需键（'host'、'auth_type'），phpMyAdmin 会直接中止遍历 $cfg['Servers']，后续所有服务器都不加载——你根本看不到报错，只发现下拉列表少了一半。
- 索引必须严格从
1开始，不能用0或负数 -
$i必须在每次循环前唯一递增，不能靠if/else分段控制 - 避免在配置块之间插入注释行（如
// Prod server）后直接跟 PHP 代码，PHP 会误解析为字符串拼接
用 foreach 循环生成 $cfg['Servers'] 最稳
官方示例（config.manyhosts.inc.php）和生产环境验证过的做法，是先定义一个干净的主机数组，再用 foreach 统一填充 $cfg['Servers']。这样索引由循环自动保证连续，且每项结构一致，不易漏键。
示例片段（可直接粘贴进 config.inc.php）：
$hosts = [
[
'host' => '192.168.1.10',
'port' => 3306,
'verbose' => 'Production MySQL',
],
[
'host' => '192.168.1.11',
'port' => 3307,
'verbose' => 'Staging MariaDB',
],
];
$i = 0;
foreach ($hosts as $host) {
$i++;
$cfg['Servers'][$i]['host'] = $host['host'];
$cfg['Servers'][$i]['port'] = $host['port'] ?? 3306;
$cfg['Servers'][$i]['verbose'] = $host['verbose'] ?? "Server {$i}";
$cfg['Servers'][$i]['auth_type'] = 'cookie';
$cfg['Servers'][$i]['extension'] = 'mysqli';
}
-
$i初始化为0，每次循环开头$i++，确保从1开始 - 每个
$host数组字段用??提供默认值，避免因缺字段导致undefined index - 不依赖外部变量或条件判断，所有服务器配置路径完全一致
索引连续性被破坏的典型现象
一旦 $cfg['Servers'] 索引不连续（比如只有 [1] 和 [3]），phpMyAdmin 的行为是：遍历到第一个空值（$cfg['Servers'][2] === null）就停止，后续所有项全部忽略。你不会看到错误提示，只会发现登录页下拉列表只剩第一个服务器，或者干脆空白。
立即学习“PHP免费学习笔记（深入）”；
常见诱因：
- 复制配置块后忘记改
$i，导致两个块都写进$cfg['Servers'][1] - 用
array_merge()合并多个配置数组，但没重置键名，结果索引变成0,1,2而非1,2,3 - 某台服务器配置里漏了
'host'或'auth_type'，phpMyAdmin 认为该项无效，跳过但不报错 - 配置文件末尾多了一个分号或少了一个引号，整个 PHP 文件 parse error，
$cfg['Servers']根本没定义
必须设 $cfg['ServerDefault'] = 0 才显示下拉菜单
即使 $cfg['Servers'][1] 到 $cfg['Servers'][5] 全部正确，如果没设 $cfg['ServerDefault'] = 0，phpMyAdmin 默认只显示单服务器登录页，下拉列表压根不出现。
注意：$cfg['ServerDefault'] = 0 是开关，不是索引——它告诉 phpMyAdmin “允许用户从多个服务器里选”，而不是“默认连第 0 号服务器”（0 没意义）。设成 1 或 2 反而会禁用下拉菜单，强制默认连指定服务器。
- 这个配置必须放在所有
$cfg['Servers']赋值之后，否则可能被覆盖 - 如果用了
auth_type = 'config'的服务器，它不会出现在下拉列表里（只自动连接），但不影响其他'cookie'服务器显示 - 别混淆
$cfg['ServerDefault']和$cfg['Servers'][$i]['host']——前者控制 UI，后者才是实际连接参数
$cfg['ServerDefault'] = 0，多服务器菜单基本不会失灵。真正容易被忽略的，是 MySQL 服务端权限——光配对 phpMyAdmin，远程 MySQL 不放行，照样卡在 #2002 Cannot log in to the MySQL server。 
