$cfg['Servers'][$i]['verbose']是服务器在登录页下拉列表中显示的别名,非连接必需项;必须与host、auth_type同属一个从1开始连续索引的配置块,且config.inc.php需保存为UTF-8无BOM编码,否则不生效。
什么是 $cfg['Servers'][$i]['verbose']?
它不是连接必需项,而是登录页下拉列表里显示的服务器别名。不设的话,默认显示 host:port(比如 192.168.1.10:3306),可读性差,尤其当多个服务器 ip 相近或端口差异小的时候,极易选错。
怎么设才生效?
必须和 host、auth_type 一起出现在同一个服务器配置块里,且索引从 1 开始连续。单独加或漏在某个 $cfg['Servers'][2] 里但 $cfg['Servers'][1] 缺失,整个数组解析会中断,verbose 就不会出现。
$cfg['Servers'][1]['verbose'] = '生产库-主';$cfg['Servers'][2]['verbose'] = '测试库-分片A';$cfg['Servers'][3]['verbose'] = '备份库-只读';
常见错误:中文乱码或显示为空
原因通常是 PHP 文件编码不是 UTF-8(无 BOM)。phpMyAdmin 读取 config.inc.php 时按字节解析,非 UTF-8 编码会导致字符串截断或解析失败,verbose 值被忽略。
- 用 VS Code / Notepad++ 确认文件保存为 UTF-8 无 BOM
- 避免在
verbose值里混用 HTML 实体(如&),直接写纯文本 - 别在
verbose后面加注释,例如:$cfg['Servers'][1]['verbose'] = '生产库'; // 主库—— 这行末尾的//会被 PHP 当作字符串一部分,导致语法错误
和 $cfg['Servers'][$i]['host'] 的关系
verbose 完全独立于 host,改了 host 不影响已设的 verbose,反之亦然。但若 host 写错(比如拼错 IP),服务器虽在下拉列表里显示正常,点击后会连不上——verbose 只管“叫什么”,不管“能不能连”。
真正容易被忽略的是:哪怕所有 verbose 都设对了,只要任意一个 $cfg['Servers'][$i] 缺少 host 或 auth_type,后续所有服务器(包括 verbose 正确的那些)都不会出现在登录页。索引连续性和必需键缺一不可。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











