phpMyAdmin 4.9 不可用于 PHP 8.1+ 环境，因其依赖的 mysql_connect() 函数已被彻底移除，调用即触发 Fatal error；它仅支持 PHP 5.5–7.4，且必须启用 mysqli、mbstring、json 和 openssl 扩展，同时需为 MySQL 5.5–5.7 单独配置 controluser 并严格匹配 host 权限与 socket 路径。
phpmyadmin 4.9 无法安全用于 php 8.1+ 环境，且对 mysql 8.0+ 的 caching_sha2_password 认证插件原生不支持；若你仍需用它管理旧版 mysql（如 5.5–5.7），必须确保底层 php 环境、扩展和连接参数三者严格匹配，否则会静默失败或报 #2002 错误。
确认 PHP 版本与扩展是否满足最低要求
phpMyAdmin 4.9 要求 PHP ≥ 5.5 且 ≤ 7.4，同时必须启用 mysqli（不是已废弃的 mysql 扩展）、mbstring、json 和 openssl。它不兼容 PHP 8.0+，因为 mysql_connect() 等函数已被彻底移除，调用即触发 Fatal error: Call to undefined function mysql_connect()，error_reporting 设置完全无效。
- 运行
php -v和php -m | grep -E 'mysqli|mbstring|json|openssl'验证 CLI 环境 - Web 服务（Apache/Nginx）实际使用的 PHP SAPI 可能与 CLI 不同，务必通过
phpinfo()页面核对Server API和Loaded Configuration File - 若发现
mysqli未启用，需在 php.ini 中取消注释extension=mysqli并重启 Web 服务
配置 $cfg['Servers'] 时避免索引断裂与语法错误
新添加的旧版 MySQL 实例不显示在登录下拉列表，根本原因只有两个：PHP 解析失败（如中文引号、未闭合字符串、隐藏 Unicode 字符），或 $cfg['Servers'] 数组索引未从 1 开始连续编号。phpMyAdmin 遍历该数组时，遇到第一个空值、跳号（如只有 [1] 和 [3]）、[0] 或语法错误，就中止加载后续所有项，整个多服务器功能失效。
- 每个实例必须使用
$cfg['Servers'][1]、$cfg['Servers'][2]… 严格递增，不能用[0]或中间留空 - 避免在配置块之间插入注释行，尤其不要在
]前换行后加注释，易导致数组截断 - 本地 socket 连接优先填
$cfg['Servers'][1]['socket'] = '/var/run/mysqld/mysqld.sock'，而非host = 'localhost'+port，否则可能因 MySQL 默认绑定行为错连到其他实例
MySQL 5.5–5.7 连接失败常见诱因与验证步骤
报错 #2002 Cannot log in to the MySQL server 多数不是 phpMyAdmin 配置问题，而是底层连接不通。MySQL 旧版本虽兼容性好，但权限、网络、SSL 设置稍有偏差就会中断。
解析 MySQL 8.0 的 DDL 脚本，并将表结构导出为 Excel 格式。适用于用户需将 MySQL 的 `CREATE TABLE` 语句转换为结构化的 Excel 文件场景，导出内容包含字段名、数据类型、长度及精度等信息。支持多张表的批量处理，每张表对应 Excel 中的一个独立工作表。适用于数据库文档编写、数据字典生成及模式分析等任务。
-
$cfg['Servers'][$i]['host']若填127.0.0.1，对应用户权限必须是'user'@'127.0.0.1'；若填localhost，则必须是'user'@'localhost'—— 二者在 MySQL 权限系统中完全独立 - 确保该用户在目标 MySQL 实例上有至少
SELECT权限，并执行FLUSH PRIVILEGES; - 若 MySQL 启用了
require_secure_transport=ON，必须在对应配置块显式加$cfg['Servers'][$i]['ssl'] = true;，否则连接直接拒绝 - 快速验证：用命令行
mysql -h 127.0.0.1 -P 3306 -u your_user -p测试能否连通，排除 phpMyAdmin 干扰
别忽略 controluser 和字符集对功能完整性的影响
即使登录成功、数据库列表可见，高级功能（如“关系视图”“用户账户管理”）仍可能报错，根源常在于 controluser 配置缺失或字符集不一致。
立即学习“PHP免费学习笔记（深入）”；
- 为每个 MySQL 实例单独创建
controluser，例如CREATE USER 'pma56'@'localhost' IDENTIFIED BY 'xxx'; GRANT SELECT, INSERT, UPDATE, DELETE ON `phpmyadmin`.* TO 'pma56'@'localhost';，切勿复用同一账号跨版本 - 旧版备份导入时若含
utf8mb4_0900_ai_ci排序规则，phpMyAdmin 4.9 会解析失败；需手动替换为utf8mb4_unicode_ci，并删掉所有GENERATED COLUMN或JSON_OBJECT()语法 - 导入前在 phpMyAdmin 的 SQL 页面执行
SET NAMES utf8mb4;，避免客户端连接层编码不一致导致中文乱码或字段截断
真正容易被忽略的是：phpMyAdmin 4.9 不校验 MySQL 版本，但它极度依赖 mysqli 扩展的行为一致性——如果你混用老旧 PHP（如 5.6）和打了补丁的 MySQL 5.7（比如启用了 OpenSSL 1.1.1+），mysqli_real_connect() 可能因 SSL 握手失败而卡住，日志里只显示超时，没有明确错误提示。
