PHP 8.2 无内置 LDAP 导入命令，需手动用 ldap_connect/ldap_search 拉取、PDO/mysqli 写入；ldap_connect 报错“undefined function”是因 ldap 扩展未启用；字段读取需注意大小写、ACL 限制、二进制数据用 ldap_get_values_len()；写入 MySQL 应用 ON DUPLICATE KEY UPDATE 防冲突，并处理空值、时间戳转换与幂等同步逻辑。
PHP 8.2 本身不提供“导入 LDAP 数据”的内置命令或一键同步机制；所谓“导入”，本质是用 ldap_connect + ldap_search 拉取条目，再用 PDO 或 mysqli 写入本地数据库——中间需自己控制字段映射、去重、增量判断和错误恢复。
PHP 8.2 环境里 ldap_connect 报错“undefined function”
这不是代码问题，是扩展根本没加载成功：
- 运行
php -m | grep ldap，如果无输出，说明扩展未编译或未启用 - Windows 下检查
php.ini是否写了extension=php_ldap.dll（不是ldap.so），且php_ldap.dll文件确实在ext/目录下 - Linux/macOS 下确认
extension=ldap已启用，并检查ldd $(php-config --extension-dir)/ldap.so是否报 OpenSSL 依赖缺失 - phpEnv 用户注意：每个 PHP 版本独立配置，
php --ini和phpinfo()显示的Loaded Configuration File路径必须一致
用 ldap_search 拉数据时常见字段读取失败
LDAP 返回的属性名区分大小写，且部分属性默认不返回（如 userPassword 受 ACL 限制）：
- 不要假设
cn或mail一定存在，先用ldap_get_attributes($conn, $entry)查看实际返回了哪些键 - 搜索时显式指定需要的字段，避免用
['*']：例如ldap_search($conn, $base_dn, $filter, ['cn', 'mail', 'uid', 'displayName']) - AD 域环境下，
sAMAccountName对应用户名，userPrincipalName是完整 UPN（如user@domain.com），别混用 - 二进制字段（如
thumbnailPhoto）需用ldap_get_values_len()读取，否则会截断或乱码
把 LDAP 条目写入 MySQL 时主键冲突和空值陷阱
直接 INSERT INTO ... VALUES 很容易因重复 DN 或缺失字段崩掉：
立即学习“PHP免费学习笔记（深入）”；
- 用
ON DUPLICATE KEY UPDATE替代单纯 INSERT，以 DN 或sAMAccountName为唯一键做 Upsert - LDAP 属性可能为空数组（
['count' => 0]），取值前必须判空：!empty($entry['mail'][0]) ? $entry['mail'][0] : null - 时间字段（如
whenCreated）在 AD 中是 LDAP 时间戳（18位整数），需转成 Unix 时间：($timestamp / 10000000) - 11644473600 - 别把整个
$entry数组 json_encode 后存进一个字段——看似省事，但丧失索引能力，后期查用户邮箱就只能全表扫描
真正难的不是连上 LDAP 或写进数据库，而是处理“同一个用户在 LDAP 里改了邮箱，但本地数据库里旧记录还在，又没做软删除”的状态不一致。这类逻辑没法靠函数自动解决，得靠你设计好同步标识（比如加 ldap_update_timestamp 字段）、定期校验、以及失败后可重入的幂等写入逻辑。
