PHP 7.2 LDAP扩展安全连接必须使用ldaps:// URI、禁用START_TLS、设协议版本为3、关闭Referrals并正确配置证书校验；漏任一环节将导致明文通信或静默失败。
PHP 7.2 的 LDAP 扩展能安全连接目录服务，但必须显式启用 LDAPS 协议、禁用 START_TLS、设置协议版本为 3，并正确处理证书校验——漏掉任一环节都可能降级为明文通信或静默失败。
ldaps:// URI 是强制前提，不是可选项
PHP 7.2 的 ldap_connect() 对协议类型极其敏感。传入 "dc.example.com", 636 这种主机+端口形式，底层仍走明文 LDAP 协议，Windows 域控会直接拒绝，ldap_bind() 报 Can't contact LDAP server，而非证书错误。
必须使用完整 URI 格式：
-
ldap_connect("ldaps://dc.example.com:636")✅ 正确，触发 TLS 握手 -
ldap_connect("ldaps://dc.example.com")✅ 可行（默认端口 636），但显式写出更可靠 -
ldap_connect("dc.example.com", 636)❌ 错误，等价于ldap://，不加密 -
ldap_connect("ldaps://dc.example.com:636,DC=example,DC=com")❌ 错误，Base DN 不该出现在连接参数里，触发Bad parameter to an ldap routine
LDAP_OPT_START_TLS 必须设为 0
LDAPS 和 START_TLS 是互斥机制。如果在 ldaps:// 连接后还调用 ldap_set_option($conn, LDAP_OPT_START_TLS, 1)，PHP 会尝试在已加密通道上再启一次 TLS，导致连接中断或绑定失败。
立即学习“PHP免费学习笔记（深入）”；
务必显式关闭：
-
ldap_set_option($conn, LDAP_OPT_START_TLS, 0)—— LDAPS 场景下必须加 - 同时必须设
LDAP_OPT_PROTOCOL_VERSION为 3（AD 强制要求） - 必须设
LDAP_OPT_REFERRALS为 0，否则跨域查询会跳转失败
证书校验不能跳过，但方式要匹配环境
PHP 7.2 默认行为是 LDAP_OPT_X_TLS_REQUIRE_CERT = LDAP_OPT_X_TLS_DEMAND（即严格校验），但实际运行常因证书路径缺失而报错。关键不是关校验，而是明确控制它：
- 生产环境：用
ldap_set_option($conn, LDAP_OPT_X_TLS_REQUIRE_CERT, LDAP_OPT_X_TLS_HARD)+ 指定 CA 证书路径：ldap_set_option($conn, LDAP_OPT_X_TLS_CACERTFILE, "/etc/ssl/certs/ca-bundle.crt") - 测试环境（仅限内网）：若用自签名证书，设
LDAP_OPT_X_TLS_REQUIRE_CERT = LDAP_OPT_X_TLS_NEVER，但绝不可用于生产 - 注意：Windows 下需确保
libsasl.dll和ssleay32.dll在 PHP 目录中，否则扩展加载失败
绑定前先确认连接和选项是否生效
ldap_bind() 返回 false 不等于密码错。常见真实原因包括连接未建立、协议版本不对、Referrals 未关、证书校验失败。不能只靠布尔值判断。
调试时应分步验证：
- 检查
ldap_connect()返回资源句柄，不是false - 调用
ldap_errno($conn)看错误码：0 表示连接成功；非 0 需查日志（如 81 = Can't contact LDAP server） - 绑定失败后立即用
ldap_error($conn)和ldap_errno($conn)获取具体信息，比如 49 = Invalid credentials，82 = Strong(er) authentication required - Web 环境下务必用
phpinfo()确认 “LDAP Support” 已 enabled，且extension_dir路径下存在php_ldap.dll（Windows）或ldap.so（Linux）
最易被忽略的是：Web 服务器（如 Apache 或 PHP-FPM）使用的 php.ini 和 CLI 下的不是同一份，扩展启用后 Web 层仍可能报 Call to undefined function ldap_connect。务必在页面中运行 phpinfo() 确认生效位置。
