phpMyAdmin如何按环境分组显示MySQL服务器-phpMyAdmin-PHP中文网

phpmyadmin不支持服务器环境分组，$cfg['servers']仅接受连续整数索引，无法嵌套；只能通过verbose字段加前缀实现视觉区分，并配合服务端读取的环境横条（如/etc/phpmyadmin/env）提供防误操作的颜色提示。

phpmyadmin 本身不提供“按环境分组显示服务器”的功能，$cfg['servers'] 数组只支持扁平化列表，无法嵌套或分类。所谓“分组”，只能靠人工视觉区分——比如在 $cfg['servers'][$i]['verbose'] 里加前缀，或结合顶部环境横条强化语义。

为什么不能用数组键名或子数组做环境分组

phpMyAdmin 的服务器配置机制只认 $cfg['Servers'][1]、$cfg['Servers'][2] 这样的整数索引，且要求连续、从 1 开始。你不能写 $cfg['Servers']['prod'][1] 或 $cfg['Servers']['staging']——PHP 解析会失败，或被静默忽略。所有服务器最终都会展平为同一级列表，登录页下拉菜单只按索引顺序渲染，无层级结构。

用 `verbose` 字段加前缀实现视觉分组

这是最轻量、最兼容的做法：在每个服务器的 verbose 描述里手动加入环境标识，让下拉选项一眼可辨。

$cfg['Servers'][1]['verbose'] = '[PROD] MySQL 8.0 on 192.168.1.10';
$cfg['Servers'][2]['verbose'] = '[STAGING] MariaDB 10.11 on 192.168.1.11';
$cfg['Servers'][3]['verbose'] = '[DEV] Local socket';

注意：verbose 值会直接显示在登录页下拉框和顶部导航栏中，无需额外 JS 或 CSS。但仅靠文字前缀不够醒目，建议搭配顶部环境横条（见下一条）。

必须配合顶部环境横条才能防误操作

只改 verbose 不足以防止点错库——人眼可能扫漏括号。真正起作用的是与连接目标强绑定的视觉提示，即在 index.php 中插入的固定横条：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

在 index.php 开头读取部署时写入的环境文件（如 /etc/phpmyadmin/env），然后输出：

<div class="env-bar env-{$env}">{$env|strtoupper}</div>

再配 CSS 控制颜色：.env-bar.env-prod { background-color: #d32f2f; }、.env-bar.env-staging { background-color: #ff9800; }。这个横条颜色由服务器实际运行环境决定，不是由配置文件内容决定，不会因复制 config.inc.php 而漂移。

别碰主题切换或 JS 动态判断

$cfg['ThemeDefault'] 只控制 UI 皮肤，和数据库实例无关；JS 读 window.location.hostname 完全不可靠——phpMyAdmin 是 PHP 应用，不同环境可能共用同一个域名（如通过子路径 /phpmyadmin/prod 和 /phpmyadmin/staging 区分），JS 拿不到后端真实连接目标。唯一可信的是部署时写死的环境标识文件 + PHP 服务端逻辑。