PHP Conference Japan 2024

ldap_error

(PHP 4, PHP 5, PHP 7, PHP 8)

ldap_errorLiefert die LDAP-Fehlermeldung des letzten LDAP-Kommandos

Beschreibung

ldap_error(LDAP\Connection $ldap): string

Gibt den erklärenden Fehlertext für den Fehler zurück, der vom zuletzt ausgeführten LDAP-Kommando mit der angegebenen Verbindungskennung ldap erzeugt wurde. Während LDAP-Fehlernummern standardisiert sind, liefern unterschiedliche Bibliotheken unterschiedliche oder sogar lokalisierte Fehlermeldungen. Deshalb sollte nie auf eine spezielle Fehlermeldung geprüft, sondern immer eine Fehlernummer verwendet werden.

Solange Sie die Stufe der Fehlerwarnungen in Ihrer php.ini nicht herabsetzen oder vor Ihre LDAP-Kommandos ein @ (at) setzen, um die Ausgabe von Fehlermeldungen zu unterdrücken, werden die aufgetretenen Fehler auch in Ihrer HTML-Ausgabe zu sehen sein.

Parameter-Liste

ldap

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

Rückgabewerte

Gibt die Fehlermeldung als Zeichenkette zurück.

Changelog

Version Beschreibung
8.1.0 Der Parameter ldap erwartet nun eine LDAP\Connection-Instanz; vorher wurde eine gültige ldap link-Ressource erwartet.

Siehe auch

  • ldap_err2str() - Konvertiert eine LDAP-Fehlernummer in einen Fehlertext
  • ldap_errno() - Liefert die LDAP-Fehlernummer des letzten LDAP-Kommandos

add a note

User Contributed Notes 2 notes

up
15
Michael Newton
7 years ago
Note that you can sometimes get more detailed error messages by getting the value of the LDAP_OPT_DIAGNOSTIC_MESSAGE option.

For example, after a recent connection error the two gave very different info:

<?php
$conn
= ldap_connect($server);
ldap_search($conn, $dn, $query);

echo
"ldap_error: " . ldap_error($conn);
ldap_get_option($conn, LDAP_OPT_DIAGNOSTIC_MESSAGE, $err);
echo
"ldap_get_option: $err";
?>

This resulted in:

ldap_error: Can't contact LDAP server
ldap_get_option: TLS: hostname does not match CN in peer certificate
up
5
edA-qa at disemia dot com
16 years ago
For those wondering, this function appears to do the same thing as:
<?php
ldap_err2str
( ldap_errno() );
?>
To Top