Adldap2 非“开箱即用”，需确保PHP启用ldap扩展、协议端口匹配（ldap://389/ldaps://636）、DNS解析正常；配置中account_suffix、domain_controllers、base_dn三项最易填错；绑定须用完整DN并显式设LDAPv3；查询时注意filter转义及属性名大小写。
Adldap2 不是“开箱即用”的魔法库，它能简化 LDAP 操作，但前提是连接通、配置对、权限够。很多 PHP 开发者卡在第一步——连上 AD 或 OpenLDAP 之后查不到用户，或 bind() 报错却找不到原因。
ldap_connect() 返回 false？先别改 PHP 代码
这个函数不抛异常，只返回 false，90% 的情况跟 PHP 代码无关：
- 检查 PHP 是否启用了
ldap扩展：运行php -m | grep ldap，没输出就说明扩展未启用 - 确认协议与端口匹配：
ldap://对应 389，ldaps://对应 636；AD 全局编录要用 3268，不能硬写死 -
ldaps://必须有 OpenSSL 支持，且系统信任证书链；用openssl s_client -connect dc01.example.com:636 -showcerts直接测试 TLS 握手 - DNS 解析必须通：PHP 进程所在机器要能通过主机名解析出域控制器 IP，
ldap_connect("dc01.example.com")比ldap_connect("192.168.1.10")更可靠（尤其启用 SRV 记录时）
Adldap2 配置里最常填错的三项
Adldap2 的 $config 数组看着简单，但三项填错就会静默失败：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
account_suffix：AD 环境下必须是完整后缀，如@example.com；若用 UPN 登录，这个值参与拼接绑定 DN，填错直接Invalid credentials -
domain_controllers：必须是数组，哪怕只有一个服务器也要写成['dc01.example.com']；字符串会触发类型错误，但不会立刻报错，而是后续查询失败 -
base_dn：不是“用户在哪”，而是“从哪开始搜”；查全公司用户就得用DC=example,DC=com，而不是某个 OU；填窄了就搜不到人，ldap_search()还返回成功（ldap_errno()是 0）
bind() 失败但账号密码没错？检查绑定身份格式
AD 和 OpenLDAP 对绑定 DN 的要求完全不同，同一套 Adldap2 配置切环境就崩：
- AD 强制使用完整 DN 绑定，例如
CN=Admin,CN=Users,DC=example,DC=com；用sAMAccountName（如admin）直接 bind 会失败 - OpenLDAP 常用
uid=admin,ou=people,dc=example,dc=com；但若服务端启用了authz-regexp，可能允许简单用户名，PHP 层无法预判 - 必须显式设置协议版本：
ldap_set_option($conn, LDAP_OPT_PROTOCOL_VERSION, 3)；AD 已废弃 v2，不设就静默失败，Adldap2内部不会帮你补
Adldap2 查询不到用户？filter 和属性大小写是隐形杀手
Adldap2 的查询构建器很顺滑，但底层仍是原生 LDAP 协议，逃不开两个老问题：
- 过滤器中的特殊字符未转义：用户名含
\、*、(时，必须用ldap_escape()（PHP 7.4+）处理，否则 filter 被截断，搜索结果为空 - 属性名严格大小写敏感：AD 返回的是
sAMAccountName、mail、displayName，写成samaccountname或email就取不到值 -
Adldap2默认只返回部分属性，查邮箱或手机号要显式指定：->select(['sAMAccountName', 'mail', 'telephoneNumber'])
真正麻烦的从来不是“怎么写”，而是“为什么写的看起来对，却没结果”。LDAP 是目录协议，不是数据库，它的行为高度依赖服务端配置和网络上下文，本地测通不等于生产可用。
