Werbung
error_log
(PHP 4, PHP 5)
error_log — Sendet eine Fehlermeldung irgendwo hin
Beschreibung
Sendet eine Fehlermeldung an das Fehlerprotokoll (Errorlog) des Webservers, an einen TCP-Port oder an eine Datei.
Parameter-Liste
- message
-
Die Fehlermeldung, die protokolliert werden soll.
- message_type
-
Sagt, wohin der Fehler gehen soll. Folgende Meldungstypen sind möglich:
error_log()-Protokolltypen 0 message wird an das Log-Subsystem von PHP gesendet, das abhängig von der Einstellung in der Konfigurationsdirektive error_log das Errorlogging des Betriebssystems verwendet oder in eine Datei schreibt. Dies ist die Standardeinstellung. 1 message wird via E-Mail an die Adresse gesendet, die im Parameter destination angegeben wurde. Dies ist der einzige Meldungstyp, bei dem der vierte Parameter extra_headers verwendet wird. 2 Diese Option ist nicht mehr verfügbar. 3 message wird an die Datei destination angefügt. Ein Zeilenumbruch wird nicht automatisch an das Ende des message -Strings angehängt. 4 message wird direkt zum SAPI-Logging-Handler gesendet. - destination
-
Das Ziel. Die jeweilige Bedeutung hängt wie oben beschrieben vom Parameter message_type ab.
- extra_headers
-
Die zusätzlichen Kopfzeilen. Dieser Parameter wird verwendet, wenn der Parameter message_type auf 1 gesetzt ist. Dieser Meldungstyp verwendet dieselbe interne Funktion wie mail().
Rückgabewerte
Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben.
Changelog
| Version | Beschreibung |
|---|---|
| 5.2.7 | Der mögliche Wert 4 wurde zum Parameter message_type hinzugefügt. |
Beispiele
2
3
4
5
6
7
8
9
10
11
12
13
// Sende eine Nachricht an das Serverlog, falls
// keine Verbindung zur Datenbank herstellbar ist.
if (!Ora_Logon($benutzername, $passwort)) {
error_log("Die Oracle-Datenbank ist nicht erreichbar!", 0);
}
// Benachrichtige den Administrator per E-Mail, falls kein FOO mehr verfügbar ist.
if (!($foo = allocate_new_foo())) {
error_log("Wir haben ein Problem: FOO ist alle!", 1,
"operator@example.com");
}
// Eine weitere Möglichkeit, error_log() aufzurufen:
error_log("Du hast Mist gebaut!", 3, "/var/tmp/meine-fehler.log");