[函数]ldap_parse_result()函数—用法及示例

函数名称：ldap_parse_result()

适用版本：PHP 4 >= 4.0.2, PHP 5, PHP 7

用法：ldap_parse_result(resource $link, resource $result, int &$errcode [, string &$matcheddn [, string &$errmsg [, array &$referrals]]]) : bool

函数说明：ldap_parse_result() 函数用于解析由 ldap_search() 或 ldap_list() 返回的结果。它会将错误代码、匹配的 DN、错误消息和引荐信息从结果中提取出来，并分配给相应的变量。

参数：

• $link: LDAP 连接标识符，通过 ldap_connect() 函数获得。
• $result: LDAP 搜索结果标识符，通过 ldap_search() 或 ldap_list() 函数获得。
• &$errcode: 一个引用变量，用于存储错误代码。如果解析成功，该变量将被赋值为 0。
• &$matcheddn: 一个可选的引用变量，用于存储匹配的 DN。如果解析成功，该变量将被赋值为匹配的 DN。
• &$errmsg: 一个可选的引用变量，用于存储错误消息。如果解析成功，该变量将被赋值为错误消息。
• &$referrals: 一个可选的引用变量，用于存储引荐信息。如果解析成功，该变量将被赋值为引荐信息，以数组形式返回。

返回值：如果解析成功，则返回 TRUE，否则返回 FALSE。

示例：

<?php
// 连接到 LDAP 服务器
$ldapconn = ldap_connect("ldap.example.com");

// 绑定到 LDAP 服务器
$ldapbind = ldap_bind($ldapconn, "cn=admin,dc=example,dc=com", "password");

// 执行搜索操作
$ldapsearch = ldap_search($ldapconn, "dc=example,dc=com", "uid=johndoe");

// 解析搜索结果
$errcode = 0;
$matcheddn = "";
$errmsg = "";
$referrals = [];
$result = ldap_parse_result($ldapconn, $ldapsearch, $errcode, $matcheddn, $errmsg, $referrals);

// 检查解析结果
if ($result) {
    echo "解析成功！\n";
    echo "错误代码: " . $errcode . "\n";
    echo "匹配的 DN: " . $matcheddn . "\n";
    echo "错误消息: " . $errmsg . "\n";
    echo "引荐信息: " . implode(", ", $referrals) . "\n";
} else {
    echo "解析失败！\n";
}

// 关闭 LDAP 连接
ldap_close($ldapconn);
?>

以上示例演示了如何使用 ldap_parse_result() 函数解析 LDAP 搜索结果，并输出相应的错误代码、匹配的 DN、错误消息和引荐信息。请根据实际情况修改 LDAP 服务器的地址、绑定信息和搜索条件。