如何在phpMyAdmin中配置用户以支持外部LDAP统一认证？-phpMyAdmin-PHP中文网

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></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 配置。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

常见错误：把 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 就永远看不到用户。

在 phpMyAdmin 根目录放一个 test.php，内容为 <?php var_dump($_SERVER['REMOTE_USER'] ?? 'not set'); ?>，直接访问测试
若输出 not set，说明 Apache 没传值，检查 <directory></directory> 块是否作用于正确路径，或是否被其他 Location/Proxy 规则覆盖
某些 Apache 版本需显式添加 SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1 才能透传认证头

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！