PHP マニュアル: システムログのメッセージを生成する

説明

true syslog(int $priority, string $message)

syslog はシステムログが出力するログメッセージを生成します。

ユーザー定義のログハンドラの設定に関する情報については、Unix マニュアルの syslog.conf (5) を参照ください。 syslog の facility と option に関するより詳細な情報は、 Unix マシンの syslog (3) にあります。

パラメータ

priority

以下の定数のうち、ひとつを指定します。

LOG_EMERG
LOG_ALERT
LOG_CRIT
LOG_ERR
LOG_WARNING
LOG_NOTICE
LOG_INFO
LOG_DEBUG

message

送信するメッセージ

戻り値

常に true を返します。

例

例1 syslog の使用例

<?php
// syslogをオープンし、プロセスIDをインクルードし、標準エラー出力にも
// ログを出力します。そして、ユーザー定義のログ記録機構を使用します。
openlog("myScriptLog", LOG_PID | LOG_PERROR, LOG_LOCAL0);

// 何らかのコード

if (authorized_client()) {
    // 何かをする
} else {
    // クライアントは未認証!
    // ログを記録する
    $access = date("Y/m/d H:i:s");
    syslog(LOG_WARNING, "Unauthorized client: $access {$_SERVER['REMOTE_ADDR']} ({$_SERVER['HTTP_USER_AGENT']})");
}

closelog();
?>

注意

Windows では、syslog サービスはイベントログを使用してエミュレートされます。

注意:
Windows 環境では、openlog の facility パラメータに LOG_LOCAL0 から LOG_LOCAL7 までを使用することはできません。

参考

openlog
closelog
syslog.filter INI ディレクティブ(PHP 7.3 以降)