pma_hosts仅控制登录页下拉项，不生成实际服务器连接逻辑；所有服务器必须在config.inc.php中显式定义$cfg['servers'][$i]数组，且索引从1开始连续递增。
不能通过环境变量动态加载多服务器配置——PMA_HOSTS 只控制登录页下拉项，不生成实际连接逻辑，所有服务器仍需在 config.inc.php 中显式定义或由循环结构生成。
为什么 PMA_HOSTS 不等于“自动多实例”
PMA_HOSTS 是 Docker 镜像启动时读取的环境变量，它只做一件事：把逗号分隔的主机名（如 db-dev,db-prod,db-test）渲染成登录页的下拉列表。phpMyAdmin 启动后并不会为每个 host 自动构造 $cfg['Servers'][$i] 条目，也不会尝试连接或校验它们是否可达。
常见误判现象：
- 填了
PMA_HOSTS=db1,db2，但登录页只显示一个选项 → 实际是config.inc.php里没定义任何$cfg['Servers']，phpMyAdmin 默认 fallback 到单服务器模式 - 选中 db2 后卡在 “Connecting…” → 容器 DNS 解析失败、MySQL 未开远程访问、或认证插件不兼容（如 MySQL 8.0 用
caching_sha2_password，而 phpMyAdmin 镜像太旧）
config.inc.php 仍是唯一可信的配置源
所有可选服务器的连接参数（host、port、auth_type、user、password、extension）必须最终落在 $cfg['Servers'][$i] 数组里，且 $i 必须从 1 开始连续递增。PMA_HOSTS 无法替代这个过程。
实操建议：
- 若用 Docker，挂载自定义
config.user.inc.php到/etc/phpmyadmin/config.user.inc.php，并在其中用循环生成服务器配置（参考官方examples/config.manyhosts.inc.php） - 不要注释掉
$i = 0;后直接写$i++—— 必须确保每次新服务器前都执行$i++，且不在条件块内调用，否则索引中断 - 每个
$cfg['Servers'][$i]块里必须显式设$cfg['Servers'][$i]['auth_type'] = 'cookie'；auth_type = 'http'在 Nginx 代理下必然失败 - 删掉所有残留的
$cfg['Servers'][$i]['socket']行，否则 phpMyAdmin 会忽略host+port，直连本地 socket
PMA_HOSTS + PMA_PORTS 的坑：顺序强绑定，容错极低
PMA_HOSTS 和 PMA_PORTS 是按位置一一对应的字符串数组，不是键值映射。比如：
PMA_HOSTS=db-dev,db-prod<br>PMA_PORTS=3306,3307
→ 第一个 host db-dev 用 3306，第二个 db-prod 用 3307。
但如果只写 PMA_PORTS=3306（少一个），第二个连接就会默认走 3306 —— 很可能连错端口，尤其当生产库监听 3307 而开发库监听 3306 时。
更隐蔽的问题：
- 域名带空格：
PMA_HOSTS=db-dev, db-prod→db-prod解析失败（逗号后不能有空格） - Docker 内网域名（如
mysql-staging）在容器里能解析，但公网域名（如db-prod.example.com）需要额外加--dns 8.8.8.8，否则 nslookup 失败 -
PMA_VERBOSES仅控制下拉菜单文字，不参与连接；若漏配，菜单项会显示空白或默认名
真正动态的部分只有「用户在登录页选哪个」，后续所有连接行为都由 config.inc.php 中预设的 $cfg['Servers'][$i] 决定。想加新服务器？改配置、重载 PHP、清浏览器 session —— 没有捷径。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
