error_log
定義されたエラー処理ルーチンにエラーメッセージを送信する
&reftitle.description;
boolerror_log
stringmessage
intmessage_type0
stringnulldestination&null;
stringnulladditional_headers&null;
エラーメッセージを Web サーバーのエラーログあるいはファイルに送ります。
&reftitle.parameters;
message
ログに記録されるエラーメッセージ。
message_type
メッセージをどこに送るのかを指定します。以下の中から指定できます。
error_log ログタイプ
0
message は PHP のシステムロガーに送られ、
設定ディレクティブ error_log
の値に応じて、
オペレーティングシステムのシステムログ機構を使って保存されるか、
ファイルに保存されるかが決まります。
これがデフォルトのオプションです。
1
message は、destination
パラメータで指定されたアドレスに、電子メール
により送られます。このメッセージタイプの場合にのみ、
4 番目のパラメータである additional_headers
が使われます。
2
このオプションは存在しません。
3
message は destination
で指定されたファイルに追加されます。
明示的に指定しない限り、message の
最後には改行文字は追加されません。
4
message は、直接 SAPI
のログ出力ハンドラに送信されます。
destination
メッセージの送信先。その設定は、上で説明している
message_type パラメータの値によります。
additional_headers
追加のヘッダ。message_type パラメータが
1 に設定される場合に利用されます。
このメッセージタイプは、mail と同様に
内部関数を利用します。
&reftitle.returnvalues;
&return.success;
message_type が0の場合、
エラーがロギング出来たかそうでないかに関わらず、この関数は常に &true; を返します。
&reftitle.changelog;
&Version;
&Description;
8.0.0
destination と
additional_headers は、nullable になりました。
&reftitle.examples;
error_log の例
]]>
&reftitle.notes;
error_log はバイナリセーフではありません。
message に null 文字があれば、そこで切り詰められます。
message に null 文字を含めてはいけません。
message の送り先はファイルやメール、そして syslog などになることもあります。
base64_encode や rawurlencode、addslashes
などの関数で適切に変換してから error_log に渡す必要があります。