(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
ldap_parse_result — 從結果中提取資訊
$ldap
,$result
,&$error_code
,&$matched_dn
= null
,&$error_message
= null
,&$referrals
= null
,&$controls
= null
解析 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
一個變數的參考,將被設定為一個包含結果中所有參考字串的 陣列,如果沒有返回參考,則為空陣列。
controls
一個包含與回應一起發送的 LDAP 控制項的 陣列。
版本 | 說明 |
---|---|
8.1.0 | ldap 參數現在需要一個 LDAP\Connection 實例;以前需要一個有效的 ldap link 資源。 |
8.1.0 | result 參數現在需要一個 LDAP\Result 實例;以前需要一個有效的 ldap result 資源。 |
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 進行操作
}
?>