PHP Logの基本と運用方法を解説

<?php
// エラーログの出力先を設定
ini_set('error_log', '/var/log/php_error.log');
// 現在のタイムスタンプと共にログ出力
$message = "ログ出力テスト: " . date('Y-m-d H:i:s');
error_log($message);
// ※ 出力先のファイルに$messageが追記されます
?>

ログ出力テスト: 2023-10-XX XX:XX:XX

<?php
// ログファイルのパス
$logFile = '/path/to/app.log';
// ログに記載するメッセージ(タイムスタンプ付き)
$logMessage = "[" . date('Y-m-d H:i:s') . "] " . "ファイルログメッセージ";
// ファイルに追記(ファイルが存在しなければ新規作成)
file_put_contents($logFile, $logMessage . PHP_EOL, FILE_APPEND);
// ※ app.logにログ情報が追加されます
?>

[2023-10-XX XX:XX:XX] ファイルログメッセージ

<?php
// 標準出力へのログ書き出し
$message = "[" . date('Y-m-d H:i:s') . "] 標準出力のログメッセージ";
echo $message . PHP_EOL;
?>

[2023-10-XX XX:XX:XX] 標準出力のログメッセージ

<?php
// エラーログの出力先設定(php.iniで定義していない場合の動的設定)
ini_set('error_log', '/var/log/php_exception.log');
try {
    // サンプルの処理(例外を発生させる)
    throw new Exception("サンプル例外が発生");
} catch (Exception $ex) {
    // 例外発生時にエラーログへ詳細情報を記録
    error_log("例外キャッチ: " . $ex->getMessage() . " in " . $ex->getFile() . " on line " . $ex->getLine());
}
?>

例外キャッチ: サンプル例外が発生 in /path/to/file.php on line XX

<?php
// 環境変数から実行環境をチェック(例：'development' or 'production')
$environment = getenv('APP_ENV');
if ($environment === 'development') {
    // 開発環境：詳細なログを指定したファイルに書き出す
    ini_set('error_log', '/var/log/dev_app.log');
    error_reporting(E_ALL);
} else {
    // 本番環境：エラーのみを標準出力もしくはシステムログに出力
    ini_set('error_log', '/var/log/prod_app.log');
    error_reporting(E_ERROR);
}
?>

/var/log/php_error.log {
    size 10M
    rotate 5
    daily
    compress
    missingok
    notifempty
}

<?php
// ログディレクトリのパス
$logDir = '/path/to/logs';
// ログファイルの保存期間(日数)
$retentionDays = 30;
// 現在のタイムスタンプから保存期間を計算
$threshold = time() - ($retentionDays * 24 * 60 * 60);
// 指定ディレクトリ内のログファイルを取得
$logFiles = glob($logDir . '/*.log');
foreach ($logFiles as $file) {
    // ファイルの最終更新日時が閾値より古い場合、削除対象とする
    if (filemtime($file) < $threshold) {
        unlink($file);
    }
}
?>

// 実行結果は削除が完了した場合、特に出力されません

<?php
// ログメッセージをキューに追加する関数(疑似コード)
function enqueueLogMessage($message) {
    // ここではファイルに蓄積する簡易キューを使用
    $queueFile = '/path/to/log_queue.txt';
    file_put_contents($queueFile, $message . PHP_EOL, FILE_APPEND);
}
// アプリケーション処理内でログを非同期にキューへ追加
$logMessage = "[" . date('Y-m-d H:i:s') . "] 非同期ログメッセージ";
enqueueLogMessage($logMessage);
// 別プロセスがキューの内容を定期的に読み取り、ログファイルに書き込み
?>

// キューにログメッセージ追加

<?php
class CustomLogger {
    private $logFile;
    // コンストラクタでログファイルのパスを初期化
    public function __construct($filePath) {
        $this->logFile = $filePath;
    }
    // ログレベルを指定してメッセージをログ出力
    public function logMessage($level, $message) {
        $formattedMessage = "[" . date('Y-m-d H:i:s') . "] " . strtoupper($level) . ": " . $message;
        file_put_contents($this->logFile, $formattedMessage . PHP_EOL, FILE_APPEND);
    }
}
// カスタムログクラスの利用例
$logger = new CustomLogger('/path/to/custom.log');
$logger->logMessage('info', 'カスタムログのメッセージ');
?>

[2023-10-XX XX:XX:XX] INFO: カスタムログのメッセージ

<?php
// 設定ファイルのパス
$configFile = '/path/to/logger.ini';
// 設定ファイルの読み込み(配列形式に変換)
$config = parse_ini_file($configFile);
// カスタムログクラスの初期化
$logger = new CustomLogger($config['log_file']);
$logger->logMessage($config['default_level'], '設定ファイルから初期化されたログメッセージ');
?>

[2023-10-XX XX:XX:XX] NOTICE: 設定ファイルから初期化されたログメッセージ

<?php
// Composerのオートローダーを読み込む
require 'vendor/autoload.php';
use Monolog\Logger;
use Monolog\Handler\StreamHandler;
// ロガーを生成、チャンネル名は任意の英語文字列で指定
$monolog = new Logger('app_channel');
// ログハンドラーを追加(ログファイルパスとログレベルを指定)
$monolog->pushHandler(new StreamHandler('/path/to/monolog.log', Logger::WARNING));
// 警告レベルのログを出力
$monolog->warning('Monologを利用した警告ログメッセージ');
?>

// monolog.logに[warning]レベルのメッセージが追記されます

<?php
use Monolog\Processor\ProcessorInterface;
class CustomProcessor implements ProcessorInterface {
    // ログデータにユーザ情報などを追加
    public function __invoke(array $record) {
        $record['extra']['user'] = 'anonymous';
        return $record;
    }
}
// カスタムプロセッサの追加例
$monolog->pushProcessor(new CustomProcessor());
$monolog->error('拡張プロセッサを利用したエラーログメッセージ');
?>

// monolog.logに、ユーザ情報を含むエラーログが出力されます