ldap_parse_result

Extract information from result

&reftitle.description; `bool` `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;

Parses an LDAP search result.

&reftitle.parameters;

`ldap`

- &ldap.parameter.ldap;

`result`

- &ldap.parameter.result;

`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_message`

- A reference to a variable that will be set to the LDAP error message in the result, or an empty string if no error occurred.

`referrals`

- A 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.

`controls`

- An `array` of LDAP Controls which have been sent with the response.

&reftitle.returnvalues;

&return.success;

&reftitle.changelog;

&Version; | &Description;
&ldap.changelog.ldap-object; &ldap.changelog.result-object;
7.3.0 | Support for `controls` added

&reftitle.examples;

### `ldap_parse_result` example

    <?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)) {
        // do something with $errcode, $dn, $errmsg and $refs
    }
    ?>