Extrahiert Informationen aus einem Ergebnis

# ldap_parse_result

(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)

ldap_parse_result — Extrahiert Informationen aus einem Ergebnis

### Beschreibung

function 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`
): bool

Parst ein LDAP-Suchergebnis.

### Parameter-Liste

`ldap`

  Eine LDAP\ConnectionInstanz, die von ldap_connect() zurückgegeben wurde.

`result`

  Eine LDAP\ConnectionInstanz, die von ldap_list() oder ldap_search() zurückgegeben wurde.

`error_code`

  Eine Referenz auf eine Variable, die auf den LDAP-Fehlercode des Ergebnisses gesetzt wird, oder `0`, wenn kein Fehler auftrat.

`matched_dn`

  Eine Referenz auf eine Variable, die auf den übereinstimmenden DN gesetzt wird, wenn einer in der Anfrage erkannt wurde; andernfalls wird sie auf `null` gesetzt.

`error_message`

  Eine Referenz auf eine Variable, die auf die LDAP-Fehlermeldung des Ergebnisses gesetzt wird, oder eine leere Zeichenkette, wenn kein Fehler auftrat.

`referrals`

  Eine Referenz auf eine Variable, die auf ein Array gesetzt wird, das alle Verweiszeichenketten im Ergebnis enthält, oder ein leeres Array, wenn keine Verweise zurückgegeben wurden.

`controls`

  Ein Array von LDAP-Steuerbefehlen, die mit der Antwort versendet wurden.

### Rückgabewerte

Gibt bei Erfolg `true` zurück. Bei einem Fehler wird `false` zurückgegeben.

### Changelog

Version | Beschreibung
--- | ---
8.1.0 | Der Parameter `ldap` erwartet nun eine LDAP\Connection-Instanz; vorher wurde eine gültige `ldap link`-Ressource erwartet.
8.1.0 | Der Parameter `result` erwartet nun eine LDAP\Result-Instanz; vorher wurde eine gültige `ldap result`-Ressource erwartet.
7.3.0 | Die Unterstützung für `controls` wurde hinzugefügt.

### Beispiele

Beispiel #1 ldap_parse_result()-Beispiel

    <?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)) {
        // mache etwas mit $errcode, $dn, $errmsg und $refs
    }
    ?>

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open