(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
ldap_parse_result — Extrahiert Informationen aus einem Ergebnis
$ldap
,$result
,&$error_code
,&$matched_dn
= null
,&$error_message
= null
,&$referrals
= null
,&$controls
= null
Parst ein LDAP-Suchergebnis.
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.
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. |
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
}
?>