(PHP 4, PHP 5)
error_log — Sendet eine Fehlermeldung irgendwo hin
$message
[, int $message_type = 0
[, string $destination
[, string $extra_headers
]]] )Sendet eine Fehlermeldung an das Fehlerprotokoll (Errorlog) des Webservers, an einen TCP-Port oder an eine Datei.
message
Die Fehlermeldung, die protokolliert werden soll.
message_type
Sagt, wohin der Fehler gehen soll. Folgende Meldungstypen sind möglich:
| 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().
Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben.
| Version | Beschreibung |
|---|---|
| 5.2.7 |
Der mögliche Wert 4 wurde zum Parameter message_type
hinzugefügt.
|
Beispiel #1 error_log()-Beispiele
<?php
// 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,
"[email protected]");
}
// Eine weitere Möglichkeit, error_log() aufzurufen:
error_log("Du hast Mist gebaut!", 3, "/var/tmp/meine-fehler.log");
?>