ldap_error

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

ldap_error — Liefert 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

Improve This Page

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 2 notes

down

Michael Newton ¶

6 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

down

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() );
?>

＋add a note