phpMyAdmin 不支持直接对接 LDAP，必须由 Apache 通过 mod_authnz_ldap 完成前置认证并将 REMOTE_USER 传入；需正确配置 AuthLDAPURL、BindDN，phpMyAdmin 设为 cookie 认证且禁用空密码。
phpmyadmin 本身不支持直接对接 ldap，必须由 web 服务器（如 apache）完成前置认证，并将已验证的用户名通过 remote_user 传入；跳过这层、只改 config.inc.php 是无效的。
Apache 必须启用 mod_authnz_ldap 并正确加载
老教程常写 mod_authz_ldap，但这是过时模块名；实际需启用的是 mod_authnz_ldap（注意是 authnz，不是 authz）。模块未加载会导致整个 <Directory> 配置块被忽略，phpMyAdmin 完全无感知。
- 安装命令：
yum install -y mod_authnz_ldap（CentOS 7+）或dnf install -y mod_authnz_ldap（CentOS 8+/AlmaLinux） - 确认是否生效：
httpd -M | grep authnz应输出authnz_ldap_module (shared) - 若使用 systemd，可能还需
systemctl restart httpd才能生效
AuthLDAPURL 和 BindDN 必须严格匹配 LDAP 目录结构
AuthLDAPURL 中的 Base DN、属性名、过滤条件必须与真实 LDAP 目录一致，否则搜索失败，用户无法匹配。明文 ldap://（端口 389）在现代环境基本不可用，推荐用 ldaps://（端口 636）或 ldap:// + StartTLS 配置。
- 常见错误：把
uid写成sAMAccountName（AD 场景下应为后者），或 Base DN 漏掉dc=层级 -
AuthLDAPBindDN必须是具有读权限的服务账号，不能是普通用户 DN -
AuthLDAPBindPassword不建议明文写在配置里，可改用外部凭证文件（如AuthLDAPBindPasswordFile）
phpMyAdmin 必须设为 cookie 认证并禁用空密码登录
phpMyAdmin 不会自己连 LDAP，它只信任 Apache 设置的 $_SERVER['REMOTE_USER']。若该变量为空或未传入，就会回退到登录页或报错。
-
config.inc.php中必须包含：$cfg['Servers'][$i]['auth_type'] = 'cookie'; $cfg['Servers'][$i]['user'] = ''; $cfg['Servers'][$i]['password'] = ''; $cfg['Servers'][$i]['AllowNoPassword'] = false;
- 漏掉
AllowNoPassword = false会导致绕过 LDAP 鉴权，允许空密码直连 MySQL - 不要设置
host为localhost后再开AllowNoPassword，这等于暴露 MySQL root 账号
调试时优先检查 REMOTE_USER 是否到达 PHP 环境
最容易被忽略的环节是 Apache 到 PHP 的变量透传——即使 LDAP 绑定成功，若 REMOTE_USER 没进 PHP，phpMyAdmin 就永远看不到用户。
立即学习“PHP免费学习笔记（深入）”；
- 在 phpMyAdmin 根目录放一个
test.php，内容为<?php var_dump($_SERVER['REMOTE_USER'] ?? 'not set'); ?>，直接访问测试 - 若输出
not set，说明 Apache 没传值，检查<Directory>块是否作用于正确路径，或是否被其他Location/Proxy规则覆盖 - 某些 Apache 版本需显式添加
SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1才能透传认证头
