phpMyAdmin 不会自动将 $cfg['Servers'][$i]['port'] 附加到 host 后用于连接，必须显式在 host 中拼接端口（如 'localhost:3306'），或确保 connect_type = 'tcp' 且 host 为纯地址、port 单独有效；否则会出现连接失败或端口重复（如 localhost:3306:3306）等问题。
phpmyadmin 不会自动将 `$cfg['servers'][$i]['port']` 附加到 `host` 后用于连接，必须显式在 `host` 中拼接端口（如 `'localhost:3306'`），或确保 `connect_type = 'tcp'` 且 `host` 为纯地址、`port` 单独有效；否则会出现连接失败或端口重复（如 `localhost:3306:3306`）等问题。
在 Docker 环境中使用 phpMyAdmin 时，常遇到「登录页无法连接 MySQL，即使 port 已在配置中明确设置」的问题——这并非 Bug，而是 phpMyAdmin 连接机制的设计特性所致。
? 核心原理：host 与 port 的协作逻辑
phpMyAdmin 不会 自动将 $cfg['Servers'][$i]['port'] 值追加到 $cfg['Servers'][$i]['host'] 后构造连接地址。它的底层连接行为由以下两个关键字段共同决定：
- ✅ host：决定连接目标（可为域名、IP 或 localhost）；
- ✅ connect_type：决定通信协议（tcp 或 socket）；
- ✅ port：仅当 connect_type = 'tcp' 且 host 不含冒号(:)时才生效；
- ❌ 若 host 已包含端口（如 'localhost:3306'），phpMyAdmin 会直接使用该字符串建立 TCP 连接，完全忽略 port 字段 —— 此时若仍保留 port = 3306，后续界面显示或日志中就可能出现 localhost:3306:3306 的重复端口现象。
? 简单记忆：host 是“完整地址”，port 是“备用端口”——二者互斥，不可共存。
✅ 正确配置方案（推荐两种）
方案一：纯 host + 显式 connect_type + port（推荐用于多环境统一管理）
$cfg['Servers'][$i]['host'] = 'localhost'; // 不带端口！ $cfg['Servers'][$i]['connect_type'] = 'tcp'; // 强制走 TCP $cfg['Servers'][$i]['port'] = 3306; // 此时 port 生效 $cfg['Servers'][$i]['extension'] = 'mysqli';
✅ 优势：配置语义清晰、便于变量化（如 $dbport 注入）、避免字符串拼接错误；
⚠️ 注意：host 值不能含 :，否则 port 被静默忽略。
方案二：host 直接携带端口（适合简单部署）
$cfg['Servers'][$i]['host'] = 'localhost:3306'; // 完整地址，port 字段废弃 // $cfg['Servers'][$i]['port'] = 3306; // ← 必须注释或删除！ $cfg['Servers'][$i]['connect_type'] = 'tcp'; // 仍建议显式声明
✅ 优势：直觉性强、兼容性高；
⚠️ 注意：若 config-db.php 中已定义 $dbport，切勿再用 "{$dbserver}:{$dbport}" 拼接后又保留 $cfg['Servers'][$i]['port'] = $dbport，否则必然导致端口重复。
? Docker 场景特别提醒
你当前的 init.sh 创建了 'admin'@'localhost' 用户，并使用 mysql_native_password 插件（正确！），但需额外确认：
立即学习“PHP免费学习笔记（深入）”；
- MySQL 8.0+ 默认认证插件为 caching_sha2_password，而 phpMyAdmin 4.9.5 不支持该插件；
- 即使连接地址正确，也会静默失败（无明确报错，仅提示“无法登录”）。
请在初始化脚本末尾追加验证与修复：
# 确保 admin 用户使用兼容认证方式 mysql -u root -e " ALTER USER 'admin'@'localhost' IDENTIFIED WITH mysql_native_password BY 'admin'; FLUSH PRIVILEGES; "
同时，在 config.inc.php 中确保启用 mysqli 扩展（你已配置），并禁用可能干扰的 AllowNoPassword（除非明确需要）。
? 常见陷阱总结
| 错误操作 | 后果 | 修正方式 |
|---|---|---|
| host = 'localhost:3306' + port = 3306 | 界面显示 localhost:3306:3306，连接失败 | 删除或注释 port 行 |
| host = '127.0.0.1' 且 MySQL 绑定 127.0.0.1 | 可能因 DNS 解析延迟或权限 Host 不匹配失败 | 改用 localhost（触发 socket）或确认 MySQL user 表中存在 'user'@'127.0.0.1' |
| 使用 phpMyAdmin 4.x 连接 MySQL 8.0+ | 用户管理页空白、权限加载异常 | 升级至 phpMyAdmin ≥ 5.0（MySQL 8.0 官方最低要求） |
| config-db.php 与 config.inc.php 中 $dbport 未同步 | 配置割裂，调试困难 | 统一在 config-db.php 定义 $dbport，并在 config.inc.php 中严格按「方案一」引用 |
✅ 最终验证步骤
- 修改 config.inc.php，采用方案一配置；
- 重启容器：docker restart <container>；
- 访问 http://localhost/phpmyadmin，在登录页输入 admin / admin；
- 登录成功后，点击右上角 » → 服务器：localhost:3306 —— 应显示单一、正确的端口；
- 进入「用户账户」页，确认可正常查看/管理用户（验证 mysql.user 表可读，排除 #1146 错误）。
遵循以上结构化配置，即可彻底解决 phpMyAdmin “port 被忽略” 的表象问题，让 Docker 中的数据库管理稳定可靠。
