应使用IP或localhost而非域名配置phpMyAdmin的host，因MySQL授权基于精确的user@host匹配，域名不自动解析为IP且可能触发DNS失败、反向解析限制或云服务禁用；localhost走socket而127.0.0.1走TCP，权限记录相互独立。
host 写域名会导致连接失败或权限拒绝
phpmyadmin 本身不禁止 host 填域名，但 mysql 服务端的用户授权是按 user@host 粒度控制的。如果你在配置里写 $cfg['servers'][1]['host'] = 'db.example.com'，phpmyadmin 就会以该域名发起连接请求，而 mysql 只认你授权时指定的 exact host —— 比如 'root'@'127.0.0.1' 或 'app'@'192.168.1.%'，但不会自动匹配 'app'@'db.example.com'，哪怕它 dns 解析到同一个 ip。
常见错误现象：#1045 - Access denied for user 'root'@'db.example.com'，注意错误里显示的是域名而非 IP，说明连接已发出，但 MySQL 拒绝了该 host 组合。
- MySQL 用户表中没有对应
user@'db.example.com'的记录 - 即使有，DNS 反向解析（reverse DNS）未启用或失败，MySQL 会退回到 IP 匹配逻辑，但仍可能因 host 不符被拒
- 某些托管环境（如阿里云 RDS、腾讯云 CDB）直接禁用域名连接，只允许白名单 IP
为什么 localhost 和 127.0.0.1 在 MySQL 中不是一回事
MySQL 把 'localhost' 当作特殊关键字，强制走 Unix socket 连接（忽略 port），而 '127.0.0.1' 是标准 TCP 连接目标。两者在权限系统中完全独立：'root'@'localhost' 和 'root'@'127.0.0.1' 是两条不同记录，密码、权限都可不同。
当你在 phpMyAdmin 配置里写 host = 'localhost'，它默认尝试 socket；若 MySQL 没启用 socket（比如 Docker 容器里没挂载 /var/run/mysqld/mysqld.sock），就会静默失败，错误却显示为 #2002 Cannot log in to the MySQL server，让人误以为是网络问题。
- 想走 TCP？必须用
'127.0.0.1'或具体 IP，且显式设connect_type = 'tcp' - 想走 socket？确保
host = 'localhost'，且socket参数指向正确路径（如/var/run/mysqld/mysqld.sock），同时删掉port字段 - 别混用：写
'localhost:3306'会让 phpMyAdmin 忽略port字段，还可能触发双冒号解析错误
真实部署中更推荐用 IP 而非域名的三个原因
除非你明确需要基于 DNS 的负载均衡或故障转移（极少见），否则域名在 phpMyAdmin 多服务器场景中纯属增加故障面。
立即学习“PHP免费学习笔记（深入）”；
- DNS 查询失败或超时会拖慢登录页加载，甚至卡在“正在连接…”状态
- 容器或 CI 环境中 /etc/hosts 不可控，
db.example.com可能根本无法解析 - phpMyAdmin 启动时会预连接每个服务器做健康检查（取决于配置），一个域名解析失败可能导致整个
$cfg['Servers']数组加载中断，后续服务器不显示
config.inc.php 里怎么安全地用变量替代硬编码 host
你可以用 PHP 变量动态赋值，但变量值仍应是 IP 或 'localhost'，而不是域名。例如：
$db_hosts = [
['ip' => '127.0.0.1', 'port' => 3306, 'label' => 'Local Dev'],
['ip' => '192.168.5.10', 'port' => 3307, 'label' => 'Staging DB'],
];
$i = 1;
foreach ($db_hosts as $h) {
$cfg['Servers'][$i]['host'] = $h['ip'];
$cfg['Servers'][$i]['port'] = $h['port'];
$cfg['Servers'][$i]['connect_type'] = 'tcp';
$cfg['Servers'][$i]['auth_type'] = 'cookie';
$cfg['Servers'][$i]['verbose'] = $h['label'];
$i++;
}
这种写法既避免手写索引出错，又绕开了域名解析风险。真正容易被忽略的是：所有服务器的 $cfg['Servers'][$i] 必须从 1 开始连续编号，中间不能跳号、不能重复，否则 phpMyAdmin 解析到第一个空或语法错就停，后面全丢弃。
