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 伺服器的地址、繫結資訊和搜尋條件。