phpMyAdmin服务器配置失效的主因是$cfg['Servers']索引不连续或从0开始，导致遍历中止；auth_type设为'http'会禁用下拉选择；语法错误、关键字段缺失、host/socket混用及未重启Web服务亦会导致配置不生效。
config.inc.php 里 $cfg['Servers'] 索引不连续或从 0 开始
phpmyadmin 启动时会遍历 $cfg['servers'] 数组，从索引 1 开始逐个加载，遇到第一个空值、语法错误或非数字键就中止——后续所有配置全被忽略。常见写法错误包括：
- 手写
$cfg['Servers'][0]（必须从1起） - 跳号：写了
[1]和[3]，漏掉[2] - 在 if 块里递增
$i，导致外部循环未执行，$cfg['Servers'][2]根本没定义 - 复制粘贴后忘记改索引，两个块都写成
[1]，后者覆盖前者
配置块内关键参数缺失或冲突
哪怕索引正确，只要某个 $cfg['Servers'][2] 缺少必要字段，该条目就会静默失效。最常漏的是：
-
host或socket：留空或写错（比如填了localhost:3307却没设port，而 MySQL 实际监听 socket） -
auth_type设为'config'，但没配user和password→ 连接直接失败，服务器不显示 -
auth_type是'cookie'，却复用了前一个实例的verbose名称，导致登录页下拉菜单渲染异常（名称重复可能触发前端去重） - 混用
host+port和socket：二者互斥，同时存在时 phpMyAdmin 可能忽略整个块
PHP 解析失败导致配置中断
config.inc.php 是 PHP 文件，任何语法错误都会让整个文件加载失败，$cfg['Servers'] 数组根本不会被初始化。典型问题：
- 中文标点混入：把英文单引号
'写成中文‘’，或冒号写成： - 末尾多逗号：PHP 7.3+ 虽支持数组尾逗号，但某些旧版 PHP 或 Apache 模块仍会报
Parse error - 注释符号错位：用
//注释某行时，不小心把下一行的;也注释掉了 - 未关闭引号：字符串中间有单引号却没转义，如
'user' => 'o'reilly'
验证方法：命令行执行 php -l /etc/phpmyadmin/config.inc.php，看是否提示 Errors parsing。
auth_type = 'http' 导致服务器列表“存在但不可选”
设 auth_type = 'http' 后，phpMyAdmin 不再渲染服务器选择下拉框——它把认证完全交给 Web 服务器（Apache/Nginx），登录页变成纯 HTTP 弹窗，且无法区分用户想连哪台 MySQL。结果就是：
立即学习“PHP免费学习笔记（深入）”；
- config.inc.php 里明明写了 3 个
$cfg['Servers'][*]，登录页却只显示一个空白或默认连接项 - 用户输完 HTTP 凭据后，phpMyAdmin 随机选一个服务器尝试连接（实际行为取决于内部实现），失败即报
#2002 -
$cfg['Servers'][$i]['user']和$cfg['Servers'][$i]['password']全部被忽略，SSL 参数也无法透传
真正要多服务器可选，auth_type 必须是 'cookie' 或 'config'，且每个块独立完整。
最易被忽略的一点：改完 config.inc.php 后必须重启 Web 服务（systemctl restart apache2 或 nginx），否则 PHP 进程缓存旧配置，你看到的永远是上一次生效的状态。
