$cfg['servers'][$i]['verbose']是登录页下拉列表中显示的服务器别名，非连接必需项；必须与host、auth_type同属一个从1开始连续索引的配置块，且config.inc.php需保存为utf-8无bom编码，否则不生效。
phpMyAdmin 配置文件中如何定义多服务器别名
phpMyAdmin 本身不支持在 Web 界面里直接为连接的 MySQL 服务器设置显示别名，所有服务器标识都来自 $cfg['Servers'] 数组的配置项。你需要手动编辑 config.inc.php，并在每个服务器配置中显式设置 $cfg['Servers'][$i]['verbose'] —— 这个值就是登录后左上角下拉菜单里显示的名称。
-
$cfg['Servers'][$i]['host']和$cfg['Servers'][$i]['port']决定实际连接目标，和verbose完全无关 - 别名可以含空格、中文、符号（如
"生产库 (shard-02)"），但不要用单引号或反斜杠破坏 PHP 字符串语法 - 如果漏写
verbose，phpMyAdmin 会回退显示host:port，容易混淆多个内网 IP 相同但用途不同的实例
为什么改了 config.inc.php 后别名没生效
常见原因是配置未被加载或语法错误导致整个配置跳过。phpMyAdmin 启动时若发现 config.inc.php 有 parse error，会静默使用默认配置（此时所有服务器都叫 localhost）。
- 检查 PHP 错误日志，搜索
Parse error或unexpected关键字，尤其注意数组末尾多写的逗号（PHP 7.3+ 虽支持，但某些旧版 phpMyAdmin 的 autoloader 会失败） - 确认你修改的是 phpMyAdmin 实际加载的配置文件：通过 phpMyAdmin 首页底部的「版本信息」链接进入「PHP Information」页，查
Loaded Configuration File路径；或者直接访问/phpmyadmin/setup/（需开启 setup 模块）查看当前生效配置 - 修改后必须重启 Web 服务（如 Apache/Nginx）或至少清空 OPcache：
opcache_reset()，否则 PHP 可能缓存了旧配置
多个服务器共用同一 host 时怎么避免连接冲突
当多台 MySQL 实例部署在同一物理机（比如用 Docker 或 systemd socket 拉起多个 mysqld 进程），仅靠 host 和 port 不足以区分，verbose 是唯一能让用户直观识别的方式，但底层连接仍依赖 socket 或 port。
- 务必为每个服务器配置唯一的
$cfg['Servers'][$i]['port']或$cfg['Servers'][$i]['socket']，否则 phpMyAdmin 会连错实例 - 若使用 Unix socket，
host必须设为'localhost'（而非127.0.0.1），否则 MySQL 会走 TCP 而非 socket，导致连接失败 - 测试连接是否准确：登录后执行
SELECT @@hostname, @@port;，结果应与你为该别名配置的host/port一致
别名里包含特殊字符导致界面错位或截断
phpMyAdmin 的导航栏宽度固定，过长的 verbose 值会被 CSS 强制省略（text-overflow: ellipsis），中文或 emoji 可能触发渲染异常。
- 建议别名长度控制在 16 个英文字符或 8 个汉字以内（如
"主库-读写"、"深圳从库"） - 避免使用 emoji、零宽空格、ANSI 控制字符——这些可能被 HTML 输出转义或被浏览器忽略，反而让显示变成方框或空白
- 如果必须区分环境层级，优先用前缀：例如
"[prod] user_db"、"[staging] analytics"，比纯描述更节省空间且不易歧义
host/port/socket 决定，最容易出问题的是改了 verbose 却忘了同步校验实际连接目标是否正确。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
