2024 PHP 开发者大会 日本站

ldap_parse_result

(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)

ldap_parse_result提取结果信息

描述

ldap_parse_result(
    LDAP\Connection $ldap,
    LDAP\Result $result,
    int &$error_code,
    string &$matched_dn = null,
    string &$error_message = null,
    array &$referrals = null,
    array &$controls = null
): bool

解析 LDAP 搜索结果。

参数

ldap

一个 LDAP\Connection 实例,由 ldap_connect() 返回。

result

一个 LDAP\Result 实例,由 ldap_list()ldap_search() 返回。

error_code

一个引用,将被设置为结果中的 LDAP 错误代码,如果未发生错误则为 0

matched_dn

一个引用,如果在请求中识别出一个匹配的 DN,则将其设置为匹配的 DN,否则将其设置为 null

error_message

一个引用,将被设置为结果中的 LDAP 错误消息,如果未发生错误则为空字符串。

referrals

一个引用,将被设置为一个 array,包含结果中的所有引用字符串,如果没有返回引用则为空数组。

controls

已随响应一起发送的 LDAP 控制的 array

返回值

成功时返回 true,失败时返回 false

变更日志

版本 描述
8.1.0 ldap 参数现在需要一个 LDAP\Connection 实例;以前需要一个有效的 ldap link resource
8.1.0 result 参数现在需要一个 LDAP\Result 实例;以前需要一个有效的 ldap result resource
7.3.0 添加了对 controls 的支持

范例

示例 #1 ldap_parse_result() 示例

<?php
$result
= ldap_search($ldap, "cn=userref,dc=my-domain,dc=com", "(cn=user*)");
$errcode = $dn = $errmsg = $refs = null;
if (
ldap_parse_result($ldap, $result, $errcode, $dn, $errmsg, $refs)) {
// 使用 $errcode, $dn, $errmsg 和 $refs 做一些事情
}
?>

添加注释

用户贡献的注释

此页面没有用户贡献的注释。
To Top