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
ldap_error
(PHP 4, PHP 5, PHP 7, PHP 8)
ldap_error — Liefert die LDAP-Fehlermeldung des letzten LDAP-Kommandos
Beschreibung
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.
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
Michael Newton ¶
7 years ago
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() );
?>
