(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
ldap_parse_result — Extract information from result
$ldap
, LDAP\Result $result
, int &$error_code
, string &$matched_dn = null
, string &$error_message = null
, array &$referrals = null
, array &$controls = null
) : boolParses an LDAP search result.
ldapAn LDAP\Connection instance, returned by ldap_connect().
resultAn LDAP\Result instance, returned by ldap_list() or ldap_search().
error_code
A reference to a variable that will be set to the LDAP error code in
the result, or 0 if no error occurred.
matched_dn
A reference to a variable that will be set to a matched DN if one was
recognised within the request, otherwise it will be set to null.
error_messageA reference to a variable that will be set to the LDAP error message in the result, or an empty string if no error occurred.
referralsA reference to a variable that will be set to an array set to all of the referral strings in the result, or an empty array if no referrals were returned.
controlsAn array of LDAP Controls which have been sent with the response.
成功时返回 true， 或者在失败时返回 false。
| 版本 | 说明 |
|---|---|
| 8.1.0 |
The ldap parameter expects an LDAP\Connection
instance now; previously, a 资源(resource) was expected.
|
| 8.1.0 |
The result parameter expects an LDAP\Result
instance now; previously, a 资源(resource) was expected.
|
| 7.3 |
Support for controls added
|
Example #1 ldap_parse_result() example
<?php
$result = ldap_search($link, "cn=userref,dc=my-domain,dc=com", "(cn=user*)");
$errcode = $dn = $errmsg = $refs = null;
if (ldap_parse_result($link, $result, $errcode, $dn, $errmsg, $refs)) {
// do something with $errcode, $dn, $errmsg and $refs
}
?>