phpMyAdmin 5.2 多服务器配置必须从 $cfg['Servers'][1] 开始连续索引，禁用跳号或 $cfg'Servers'；localhost 强制 Unix socket 而 127.0.0.1 强制 TCP，推荐后者确保跨网络连接稳定；auth_type='config' 需配文件权限600或改用 cookie 认证。
phpMyAdmin 5.2 多服务器配置必须用 $cfg['Servers'][1] 起始索引
phpmyadmin 5.2 不再容忍 $cfg['servers'][0] 或跳号索引，否则登录页直接不显示服务器下拉框。它严格按数组键值顺序加载，从 1 开始连续递增才是唯一可靠方式。
- 错误写法：
$cfg['Servers'][0]、$cfg['Servers'][2]（跳过 1）、或在 if 块里局部递增$i - 正确做法：统一用
$i = 0初始化，每个服务器前执行$i++，确保$cfg['Servers'][$i]键值为 1、2、3… 连续整数 - 若用循环配置（推荐），必须保证
foreach中的索引从 1 开始映射，例如：foreach ($hosts as $idx => $h) { $i = $idx + 1; ... }
localhost 和 127.0.0.1 在 phpMyAdmin 5.2 中行为完全不同
写 localhost 会让 phpMyAdmin 尝试走 Unix socket，而多数远程或容器化 MySQL/MariaDB 并未启用本地 socket；写 127.0.0.1 强制走 TCP，这才是跨网络连接的稳定选择。
- SSH 隧道场景下，必须填
'host' => '127.0.0.1'，哪怕端口是 33061/33062 —— 否则可能连上本机 MySQL 而非隧道后端 - Docker 环境中，宿主机访问容器 MySQL 时，
host不能填localhost（那指向容器自身），应填宿主机 IP 或host.docker.internal（Docker Desktop） - MySQL 8.0+ 默认禁用
localhost的 socket 连接，phpMyAdmin 5.2 会静默 fallback 到 TCP，但不可依赖——显式写127.0.0.1更可控
auth_type = 'config' 在 phpMyAdmin 5.2 中默认禁用明文密码
新版默认开启 $cfg['CheckConfigurationPermissions'] = true，如果 config.inc.php 权限是 644 或更宽松，phpMyAdmin 5.2 会拒绝加载含明文密码的 auth_type = 'config' 配置，并报错 “Server configuration not secure”。
- 临时解决：设
$cfg['CheckConfigurationPermissions'] = false（仅限内网调试） - 生产推荐：改用
auth_type = 'cookie'，用户每次输入凭据；或结合 LDAP/HTTP auth 等外部认证 - 若坚持用
config模式，需将config.inc.php权限改为600（仅属主可读写），并确认 Web 用户（如 www-data）是文件属主
phpMyAdmin 5.2 不支持自动识别 MySQL 与 MariaDB 差异
它只认 mysqli 扩展，不区分后端是 MySQL 还是 MariaDB。但两者在系统表、权限语法、默认字符集上有差异，会导致界面显示异常或操作失败。
- MariaDB 10.11+ 默认关闭
information_schema中部分视图，phpMyAdmin 可能报#1142 SELECT command denied—— 需显式授权：GRANT SELECT ON information_schema.* TO 'pma_user'@'%'; - MySQL 8.0 的
caching_sha2_password插件不被旧版 mysqli 支持，phpMyAdmin 5.2 需确保用户用mysql_native_password认证：ALTER USER 'pma_user'@'%' IDENTIFIED WITH mysql_native_password BY 'xxx'; - 连接 MariaDB 时若报
#2002 Cannot log in to the MySQL server，先检查bind-address = 0.0.0.0和skip-networking = OFF，而非怀疑 phpMyAdmin 配置
实际配置中最容易被忽略的是：phpMyAdmin 5.2 的错误提示极简，不告诉你具体哪一行配置出错，只在登录页空白或报 500。必须打开 PHP 错误日志（error_log）或临时设 ini_set('display_errors', 1) 才能看到真实报错。
立即学习“PHP免费学习笔记（深入）”；
