error_logSendet eine Fehlermeldung an die definierten Fehlerbehandlungsroutinen
&reftitle.description;
boolerror_logstringmessageintmessage_type0stringnulldestination&null;stringnulladditional_headers&null;
Sendet eine Fehlermeldung an das Fehlerprotokoll (Errorlog) des Webservers,
oder an eine Datei.
&reftitle.parameters;
message
Die Fehlermeldung, die protokolliert werden soll.
message_type
Sagt, wohin der Fehler gehen soll. Folgende Meldungstypen sind möglich:
error_log-Protokolltypen0message 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.
1message wird via E-Mail an die Adresse
gesendet, die im Parameter destination
angegeben wurde. Dies ist der einzige Meldungstyp, bei dem der
vierte Parameter additional_headers
verwendet wird.
2
Diese Option ist nicht mehr verfügbar.
3message wird an die Datei
destination angefügt. Ein Zeilenumbruch wird
nicht automatisch an das Ende des message-Strings
angehängt.
4message wird direkt zum SAPI-Logging-Handler
gesendet.
destination
Das Ziel. Die jeweilige Bedeutung hängt wie oben beschrieben vom Parameter
message_type ab.
additional_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.
&reftitle.returnvalues;
&return.success;
Wenn message_type null ist, gibt diese Funktion immer &true; zurück,
unabhängig davon, ob der Fehler protokolliert werden konnte oder nicht.
&reftitle.changelog;
&Version;&Description;8.0.0destination und
additional_headers sind jetzt nullbar.
&reftitle.examples;
error_log-Beispiele
]]>
&reftitle.notes;
error_log ist nicht binär-sicher.
message wird durch ein Null-Zeichen abgeschnitten.
message sollte keine Null-Zeichen enthalten. Es ist
zu beachten, dass message an eine Datei, das Syslog,
per Mail usw. gesendet werden kann. Geeignete Konvertierungs/Maskierungs-Funktionen,
base64_encode, rawurlencode oder
addslashes, sind anzuwenden bevor
error_log aufgerufen wird.