不能靠改config.default.php,必须用config.inc.php中$cfg['Servers']数组配合从1开始的连续整数索引,否则登录页只显示一个服务器甚至空白;因phpMyAdmin仅加载config.inc.php,config.default.php是只读模板,修改无效。

直接说结论:不能靠改 config.default.php,必须用 config.inc.php 中的 $cfg['Servers'] 数组配合从 1 开始的连续整数索引,否则登录页只显示一个服务器,甚至空白。
为什么 config.default.php 改了没用?
phpMyAdmin 启动时只读取 config.inc.php(通常在 /etc/phpmyadmin/config.inc.php 或 /usr/share/phpmyadmin/config.inc.php),config.default.php 是只读模板,改它完全不生效。很多教程抄错路径,导致配了半天登录页还是单服务器。
- 检查实际加载的配置文件:打开 phpMyAdmin 页面后,点右下角「关于」→「版本信息」,看「配置文件」一行指向哪个路径
- CentOS 7 默认安装方式(yum)会把主配置放在
/etc/phpmyadmin/config.inc.php - 如果该文件不存在,说明你装的是源码版,配置文件在
/usr/share/phpmyadmin/config.inc.php,且很可能为空,需手动创建
如何正确配置三台内网 MySQL 服务器?
关键不是写三段配置,而是确保 $cfg['Servers'][1]、$cfg['Servers'][2]、$cfg['Servers'][3] 全部存在、索引连续、字段完整。缺一不可。
- 每台服务器必须有唯一数字索引,从 1 开始,不能跳(比如只有 [1] 和 [3],[2] 缺失 → 第二台不显示)
-
$cfg['Servers'][$i]['host']填内网 IP 或域名,如'192.168.10.10'、'db-prod.local';端口非默认 3306 时加冒号,如'192.168.10.20:3307' -
$cfg['Servers'][$i]['auth_type']推荐设为'cookie',避免密码硬编码;若必须直连,再设'config'并填user/password - 务必设置
$cfg['Servers'][$i]['verbose'],这是登录页下拉菜单里显示的名字,例如'开发库(192.168.10.10)' - 所有服务器共用一套全局配置(如
$cfg['blowfish_secret']),放在$cfg['Servers']数组定义之前
常见错误:登录页只显示一台或空白
根本原因几乎全是索引管理出错——不是语法错,是逻辑错。phpMyAdmin 解析时遇到第一个非法索引就停,后续全丢弃。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 手写配置时用了
$i = 0然后$i++,结果生成了[0]、[1]、[2]→ phpMyAdmin 要求从 1 开始,[0]被忽略,只剩后两个,但索引不连续,可能只剩一个显示 - 复制粘贴时漏掉某台的
$cfg['Servers'][2][...]块,只剩 [1] 和 [3] → 直接丢弃 [3] - 在
if条件块里写服务器配置,条件不满足导致某台配置未执行 → 对应索引缺失 - 配置末尾多了一个分号或少了一个括号,导致 PHP 解析失败,整个
config.inc.php加载中断 → 登录页白屏或报 500 错误
最小可用三服务器配置示例
把以下内容**完整覆盖**到你的 config.inc.php(先备份原文件),注意替换 IP、端口、别名:
<?php $cfg['blowfish_secret'] = 'a_32_char_random_string_here_1234567890ab'; /* 必须设,32位随机字符串 */ <p>$i = 0;<p>/<em> 服务器 1 </em>/ $i++; $cfg['Servers'][$i]['host'] = '192.168.10.10'; $cfg['Servers'][$i]['port'] = ''; $cfg['Servers'][$i]['verbose'] = '开发库(MySQL 5.7)'; $cfg['Servers'][$i]['auth_type'] = 'cookie';</p><p>/<em> 服务器 2 </em>/ $i++; $cfg['Servers'][$i]['host'] = '192.168.10.20'; $cfg['Servers'][$i]['port'] = '3307'; $cfg['Servers'][$i]['verbose'] = '测试库(MariaDB 10.3)'; $cfg['Servers'][$i]['auth_type'] = 'cookie';</p><p>/<em> 服务器 3 </em>/ $i++; $cfg['Servers'][$i]['host'] = '192.168.10.30'; $cfg['Servers'][$i]['port'] = ''; $cfg['Servers'][$i]['verbose'] = '预发库(MySQL 8.0)'; $cfg['Servers'][$i]['auth_type'] = 'cookie';</p><p>$cfg['UploadDir'] = ''; $cfg['SaveDir'] = ''; ?></p>
改完后重启 httpd:运行 systemctl restart httpd,再清浏览器缓存访问 /phpmyadmin —— 登录页顶部就会出现三选一的下拉菜单。
真正容易被忽略的点是:$i 初始化和递增的位置必须紧邻每个服务器块,且不能包裹在任何条件判断里;另外,CentOS 7 上 SELinux 若开启,可能拦截对远程 MySQL 的 socket 连接,此时要临时关掉验证:运行 setsebool -P httpd_can_network_connect_db 1。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










