phpMyAdmin 5.2 不支持内置双因素认证，$cfg['TwoFactorAuth'] = 'application' 配置无效；唯一可行路径是通过 Apache/Nginx 外部认证（如 OIDC 或 Authelia）完成双因子后透传 REMOTE_USER，并将 phpMyAdmin 设为 HTTP 认证模式。
phpMyAdmin 5.2 本身不支持内置双因素认证
直接说结论：$cfg['TwoFactorAuth'] = 'application' 这类配置在 phpMyAdmin 5.2 中**不会生效**。它只在 5.3+（2023 年后）版本中才被正式支持并集成 TOTP/WebAuthn 逻辑。5.2 的代码里没有对应的验证流程、前端输入框或后端校验钩子，设了也白设。
你看到的文档或教程若声称“5.2 启用双因素”，实际是把认证责任推给了外部——要么是 Web 服务器层（如 Apache 的 mod_auth_mellon 或 mod_auth_openidc），要么是反向代理（如 Nginx + Authelia），phpMyAdmin 只被动接收已通过二次验证的 REMOTE_USER。
想在 5.2 实现等效双因子，必须走 HTTP Basic + 外部认证链
这是唯一可行路径：让 Apache/Nginx 先完成双因子验证，再把干净的用户名透传给 phpMyAdmin。
- Apache 场景：启用
mod_auth_openidc或mod_auth_mellon，配置 OIDC 提供方（如 Keycloak、Auth0），并在<directory></directory>块中强制要求认证成功后设置Require valid-user和AuthType openid-connect - Nginx 场景：用
auth_request指向一个独立的认证服务（如 Authelia），该服务完成 TOTP/推送验证后返回 200，Nginx 才放行并透传$remote_user - phpMyAdmin 配置必须同步改：设
$cfg['Servers'][$i]['auth_type'] = 'http'，删掉所有$cfg['Servers'][$i]['user']和$cfg['Servers'][$i]['password']，否则它会忽略外部传来的用户，自己弹登录框
常见失败点：你以为启用了，其实只是障眼法
很多用户以为加了 $cfg['TwoFactorAuth'] = 'application' 就万事大吉，结果上线后发现：
立即学习“PHP免费学习笔记（深入）”；
- 登录页根本没出现六位码输入框 → 因为 5.2 前端模板里压根没这个 DOM 元素
- Apache 日志显示认证成功，但 phpMyAdmin 仍报
#1045 Cannot log in to the MySQL server→ 很可能是 MySQL 里没有与REMOTE_USER同名的账号，或没授权，或认证插件不匹配（比如 LDAP 用户默认用caching_sha2_password，但 MySQL 8.0+ 客户端未适配） - 改完配置没重启 Apache/Nginx → 外部认证模块根本没加载，
REMOTE_USER为空，phpMyAdmin 退化成 config 模式，又去读配置文件里的密码（如果还留着的话）
最隐蔽的坑是：5.2 的 config.inc.php 校验极弱，错写字母、多加空格、漏分号都不会报错，只会静默失效。务必用 php -l config.inc.php 检查语法，再用 curl -I http://your-pma/ 看响应头是否含 WWW-Authenticate。
