ldap_connect()返回false或超时主因是环境配置问题：需确保php_ldap.dll及依赖的libeay32.dll、ssleay32.dll、libsasl.dll正确放置，启用php_ldap.dll和php_openssl.dll扩展，设置ldap_opt_protocol_version为3，ldaps连接需证书信任且端口匹配（636），ad环境还需注意dns解析、防火墙放行及starttls调用。
PHP 的 ldap_connect() 返回 false 或超时，不是代码写错了，而是环境没配通——先解决 DLL 依赖和协议版本，再碰代码逻辑。
Apache 启动失败或 PHP 报 “Unable to load dynamic library 'php_ldap.dll'”
这不是 extension 没开，是底层 DLL 找不到。XAMPP 的 php_ldap.dll 强依赖三个文件：
-
libeay32.dll和ssleay32.dll：必须复制到C:\Windows\System32（64 位系统也放这里，别放SysWOW64） -
libsasl.dll：XAMPP 自带，但默认不在 Apache 的 DLL 搜索路径里，需手动复制到xampp\apache\bin\
确认 php.ini 中已取消注释：extension=php_ldap.dll 和 extension=php_openssl.dll（LDAPS 必须）；改完必须重启整个 XAMPP 控制面板，只点“Restart Apache”无效。
连接 AD 域控时 ldap_connect() 成功但 ldap_bind() 失败
Windows Server 2012+ 默认拒绝 LDAP v2，且多数企业域控强制 LDAPS（636 端口）或要求 StartTLS。常见错误配置：
- 没设协议版本：
ldap_set_option($ds, LDAP_OPT_PROTOCOL_VERSION, 3)必须在ldap_bind()前调用 - 用了
ldap://却连 636 端口，或用了ldaps://却没启用php_openssl.dll - 防火墙/组策略封了出站 389 或 636，临时关本地防火墙测试；若公司统一管控，得确认来源 IP 是否白名单
若用 StartTLS（389 端口），代码中需显式调用：ldap_start_tls($ds)，且服务端证书必须被 PHP 信任（可通过 ldap_set_option(LDAP_OPT_X_TLS_CACERTFILE, '/path/to/cacert.pem') 指定 CA）。
禅道、Drupal 等系统集成 LDAP 登录失败
这类系统常自带密码预处理逻辑，和 LDAP 明文认证冲突：
- 禅道默认对密码做两次 MD5：
md5(md5(password) + rand)，必须关闭——在config/my.php加$config->notMd5Pwd = true;，并注释掉zbox/app/zentao/module/user/js/login.js中的 MD5 行 - Drupal 报 “no ldap php extension loaded”，即使
phpinfo()显示已加载，也要检查是否启用了mod_php而非php-fpm；XAMPP 默认用 mod_php，但若改过 Apache 配置，可能实际走的是 CGI 模式，此时php.ini设置不生效
改完 JS 后务必清浏览器缓存（Ctrl+F5 不够），否则旧加密逻辑仍在执行。
ldap_search() 返回空、getUserDn() 查不到结果
LDAP 协议对 baseDN 和 filter 大小写、空格、括号闭合极其敏感，静默失败不报错：
- baseDN 示例应为：
DC=example,DC=com，不是dc=example,dc=com（AD 通常不区分，但某些配置下会失败） - filter 若写成
(sAMAccountName=%s)，确保传入的用户名不含多余空格；中文 OU 名要用 UTF-8 编码，否则搜索无结果 - 用
ldap_errno($ds)和ldap_error($ds)检查真实错误码，比如 34（invalid DN syntax）或 49（invalid credentials）比空数组更有诊断价值
最易忽略的一点：AD 默认不返回用户密码哈希或某些属性，ldap_search() 的 attributes 参数若包含 userPassword，会导致整个结果集为空——删掉它再试。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
