如何在phpMyAdmin中设置Verbose名称以直观辨别多服务器？-phpMyAdmin-PHP中文网

phpMyAdmin 的 Verbose 名称是服务器连接列表中显示的友好名称，需在 config.inc.php 中为每个 $cfg['Servers'][$i] 显式配置 'verbose' 键，如 $cfg'Servers'['verbose'] = '生产 MySQL 8.0'；它仅用于 UI 展示，不参与认证或连接逻辑，且明文暴露于 HTML 源码。

什么是 phpMyAdmin 的 Verbose 名称？

verbose 名称是 phpmyadmin 中服务器连接列表里显示的“友好名称”，它不等于实际的主机名或 ip，而是你在 config.inc.php 里手动指定的描述性标签。默认情况下，如果没配置，它会直接显示 localhost 或 ip 地址，多个服务器时根本分不清哪个是测试库、哪个是生产库。

在 config.inc.php 中为每个 $cfg['Servers'] 设置 verbose_name

phpMyAdmin 不读取数据库或界面配置来生成这个名称，必须硬编码在配置文件里。关键点是：每台服务器对应一个 $cfg['Servers'][$i] 数组项，你要给它加 'verbose' 键。

常见错误是写成 $cfg['Servers']['verbose']（顶层）或漏掉索引 $i，结果所有服务器都显示同一个名字，甚至报错。

确保你编辑的是 phpMyAdmin 根目录下的 config.inc.php（不是 config.sample.inc.php）
找到类似 $cfg['Servers'][$i]['host'] = '192.168.1.10'; 的段落
在它后面加上一行：$cfg['Servers'][$i]['verbose'] = '生产 MySQL 8.0';
不同服务器用不同 $i 索引（通常是 1、2、3…），别重复用同一个数字

示例片段：

$cfg['Servers'][1]['host'] = '10.0.1.5';
$cfg['Servers'][1]['verbose'] = '线上主库';
$cfg['Servers'][2]['host'] = '10.0.1.6';
$cfg['Servers'][2]['verbose'] = '灾备从库';
$cfg['Servers'][3]['host'] = 'localhost';
$cfg['Servers'][3]['verbose'] = '本地开发';

verbose 名称不生效？检查这三件事

改完保存，刷新页面还是显示原始 host，大概率是以下原因：

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

phpMyAdmin 没读到你改的 config.inc.php —— 确认你编辑的是被实际加载的那个文件（可通过 phpMyAdmin 首页底部「版本信息」旁的「显示 PHP 信息」链接，查 include_path 和实际加载的配置路径）
语法错误导致配置加载失败 —— 用 php -l config.inc.php 检查 PHP 语法，尤其注意末尾是否多了逗号、引号不配对
用了缓存代理或浏览器缓存 —— 强制刷新（Ctrl+Shift+R），或临时禁用浏览器缓存调试

verbose 名称和 authentication type 的关系

如果你用的是 'auth_type' => 'cookie' 或 'http'，verbose 名称只影响左侧服务器选择下拉菜单；但如果是 'auth_type' => 'config'（即自动登录），phpMyAdmin 会尝试按顺序连接，此时 verbose 名称不会影响连接行为，仅作 UI 提示。

注意：不要把敏感信息（如环境类型、负责人）写进 verbose，它会明文出现在 HTML 源码里，任何能访问 phpMyAdmin 页面的人都能看到。

真正容易被忽略的是：verbose 名称不参与权限控制，也不影响连接逻辑——它只是个标签，改错了顶多让你点错服务器，不会导致连不上或权限异常。