PHP 7.1 中 ldap_connect() 仅返回句柄，真实连接和认证在 ldap_bind() 阶段发生；超时需通过 set_time_limit() 和 ldap_set_option($conn, LDAP_OPT_NETWORK_TIMEOUT, [...]) 主动控制，失败后须显式 ldap_unbind() 并推荐用 try/finally 保障资源释放。
LDAP 连接超时与 PHP7.1 的默认行为
PHP 7.1 中 ldap_connect() 默认不建立实际连接，只返回资源句柄；真实 TCP 连接和认证发生在 ldap_bind() 阶段。此时若网络中断、LDAP 服务不可达或响应缓慢，ldap_bind() 会阻塞直到超时（默认由系统 socket 超时决定，通常较长，如 30 秒以上），导致 Web 请求卡住。
主动控制超时：set_time_limit + ldap_set_option
PHP 本身不提供 LDAP 协议层超时参数，但可通过组合方式约束：
-
设置脚本最大执行时间：在调用前用
set_time_limit(5)限制整个认证流程不超过 5 秒（注意避免影响其他逻辑） -
启用协议版本并设置超时选项：
ldap_set_option($conn, LDAP_OPT_PROTOCOL_VERSION, LDAP_VERSION_3); ldap_set_option($conn, LDAP_OPT_NETWORK_TIMEOUT, ['tv_sec' => 3, 'tv_usec' => 0]);
注意：PHP 7.1 对LDAP_OPT_NETWORK_TIMEOUT的支持依赖底层 OpenLDAP 版本（≥ 2.4.39）且需编译时启用；若无效，该选项会被忽略，仍走系统 socket 超时。
断线重连的实用实现结构
不依赖自动重连（LDAP 扩展无内置重试），而是封装可重试的绑定函数：
- 用
ldap_connect()获取连接资源后，立即用ldap_set_option()设置超时和协议版本 - 用
ldap_bind()尝试认证；失败时检查ldap_errno($conn)，对常见临时错误（如LDAP_SERVER_DOWN (81)、LDAP_TIMEOUT (85)）触发重试 - 最多重试 2 次，每次间隔 200ms（用
usleep(200000)），避免雪崩请求 - 每次重试都新建连接（
ldap_connect+ldap_set_option），不复用可能已损坏的句柄
异常清理与资源释放
PHP 不会自动释放 LDAP 连接资源，尤其在超时或 bind 失败后容易泄漏：
立即学习“PHP免费学习笔记（深入）”；
- 无论成功或失败，都要显式调用
ldap_unbind($conn)（如果$conn有效） - 建议用
try / finally结构包裹关键操作，确保资源回收 - 避免在循环或高频接口中频繁 connect/bind/unbind，可考虑连接池（需自行管理生命周期），但对多数认证场景，简单重试+及时释放更稳妥
