タイトル: ログファイルにエラーを出力する方法
SEOタイトル: PHPログ出力完全ガイド（error_log/Monolog/PSR-3/Laravel/logrotate）
| この記事の要点 |
|
方法1: PHP 標準の error_log()
最も手軽な方法。php.ini の設定 or 直接ファイル指定でログを書きます。
// (1) php.ini の error_log 指定先へ出力
error_log("ユーザー登録失敗: id=$id");
// (2) ファイル指定（第2引数 3 = ファイル追記）
error_log("ユーザー登録失敗: id=$id\n", 3, "/var/log/app.log");
// (3) メール送信（運用ではほぼ使わない）
error_log("緊急", 1, "admin@example.com");
// 変数の中身を文字列化
error_log(print_r($data, true));
error_log(var_export($data, true));
error_log(json_encode($data, JSON_UNESCAPED_UNICODE));php.ini の設定
; php.ini
log_errors = On
error_log = /var/log/php/error.log
error_reporting = E_ALL
display_errors = Off ; 本番は必ず Off
display_startup_errors = Off
; date 関数のタイムゾーン（ログ時刻に影響）
date.timezone = Asia/Tokyo権限
# 書き込み権限を付与（Apache の場合）
sudo mkdir -p /var/log/php
sudo chown www-data:www-data /var/log/php
sudo chmod 750 /var/log/php
# nginx-php-fpm の場合
sudo chown www-data:www-data /var/log/php # ディストリ依存方法2: set_error_handler でカスタム処理
PHP のエラー・例外・致命的エラーをすべてフックして独自処理する基盤:
// すべての E_NOTICE / E_WARNING / E_DEPRECATED を捕捉
set_error_handler(function (int $errno, string $msg, string $file, int $line) {
error_log(sprintf("[ERROR %d] %s at %s:%d", $errno, $msg, $file, $line));
// false を返すと PHP 標準処理も継続
return false;
});
// 未捕捉の例外をフック
set_exception_handler(function (\Throwable $e) {
error_log(sprintf("[EXCEPTION] %s\n%s", $e->getMessage(), $e->getTraceAsString()));
http_response_code(500);
echo "Internal Server Error";
});
// 致命的エラー（パースエラー以外）も検知
register_shutdown_function(function () {
$err = error_get_last();
if ($err && in_array($err['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR])) {
error_log(sprintf("[FATAL] %s at %s:%d", $err['message'], $err['file'], $err['line']));
}
});方法3: Monolog（業界標準）
PSR-3 準拠の高機能ロガー。Symfony / Laravel が内部で使っているデファクト:
composer require monolog/monologuse Monolog\Logger;
use Monolog\Handler\StreamHandler;
use Monolog\Handler\RotatingFileHandler;
use Monolog\Handler\SlackWebhookHandler;
use Monolog\Formatter\JsonFormatter;
use Monolog\Processor\WebProcessor;
$log = new Logger('app');
// 通常ログ（日次ローテート、14 日保持）
$log->pushHandler(
(new RotatingFileHandler('/var/log/app.log', 14, Logger::INFO))
->setFormatter(new JsonFormatter())
);
// ERROR 以上だけ Slack 通知
$log->pushHandler(
new SlackWebhookHandler(
'https://hooks.slack.com/services/...',
'#alerts',
'AppBot',
true,
null,
false,
false,
Logger::ERROR
)
);
// リクエスト情報を自動付与
$log->pushProcessor(new WebProcessor());
// 利用
$log->info('ユーザー登録', ['user_id' => 123]);
$log->warning('API レート制限間近', ['remaining' => 5]);
$log->error('決済エラー', ['exception' => $e]);
$log->critical('DB 接続不可');PSR-3 ログレベル
| レベル | 意味 | 使い分け |
|---|---|---|
debug | デバッグ詳細 | 開発時のみ |
info | 通常情報 | 正常動作の記録（ログイン等） |
notice | 注目に値する | 異常ではないが記録すべき |
warning | 警告 | 異常だが処理は継続可能 |
error | エラー | 処理失敗、即対応不要 |
critical | 致命的 | サービス品質悪化、要調査 |
alert | 緊急 | 即対応必要 |
emergency | システム停止 | システム使用不可 |
Laravel での Log facade
use Illuminate\Support\Facades\Log;
Log::info('注文作成', ['order_id' => $order->id, 'user_id' => $user->id]);
Log::warning('在庫低下', ['product' => $product->sku, 'stock' => 3]);
Log::error('決済失敗', ['exception' => $e]);
// channel 指定
Log::channel('payments')->info('Stripe success', ['amount' => 1500]);
// 一時的にスタック
Log::stack(['single', 'slack'])->error('障害');config/logging.php
return [
'default' => env('LOG_CHANNEL', 'stack'),
'channels' => [
'stack' => [
'driver' => 'stack',
'channels' => ['daily', 'slack'],
],
'daily' => [
'driver' => 'daily',
'path' => storage_path('logs/laravel.log'),
'level' => env('LOG_LEVEL', 'debug'),
'days' => 14,
],
'slack' => [
'driver' => 'slack',
'url' => env('LOG_SLACK_WEBHOOK_URL'),
'username' => 'Laravel Log',
'emoji' => ':boom:',
'level' => 'error',
],
'payments' => [
'driver' => 'daily',
'path' => storage_path('logs/payments.log'),
'days' => 30,
],
],
];ログローテーション
logrotate（Linux 標準）
# /etc/logrotate.d/app
/var/log/app.log {
daily
rotate 14
compress
delaycompress
missingok
notifempty
create 0640 www-data www-data
sharedscripts
postrotate
# PHP-FPM のログ再オープン
systemctl reload php8.3-fpm > /dev/null 2>&1 || true
endscript
}Monolog の RotatingFileHandler
アプリ内でローテーション完結したい場合（コンテナ環境で便利）:
// 日次ローテート、過去 14 日保持
$handler = new RotatingFileHandler('/var/log/app.log', 14);
// ファイル名は app-YYYY-MM-DD.log で自動生成外部サービス連携
| サービス | 用途 | 連携方法 |
|---|---|---|
| Sentry | 例外/エラー追跡 | sentry/sentry-laravel / handler 追加 |
| Datadog | APM + ログ統合 | DD_LOGS_INJECTION=true + tail エージェント |
| CloudWatch Logs | AWS ログ集約 | FluentBit / CloudWatch Agent |
| Papertrail / Loggly | SaaS ログ管理 | syslog 転送 |
| Elasticsearch + Kibana | OSS ログ検索 | Filebeat → Elasticsearch |
// Sentry の例（Laravel）
// composer require sentry/sentry-laravel
// .env: SENTRY_LARAVEL_DSN=https://...@sentry.io/...
// config/logging.php に channel 追加
'sentry' => [
'driver' => 'sentry',
'level' => 'error',
],
// 利用は通常通り
Log::channel('sentry')->error('決済失敗', ['user' => $user->id]);本番運用のチェックリスト
- ✅
display_errors=Off/log_errors=On（ユーザに stack trace を見せない） - ✅ ログファイルは Web から見えない場所 (
/var/log/等) に - ✅ logrotate or RotatingFileHandler で無制限肥大化を防ぐ
- ✅ 個人情報 / トークン / クレカ番号をログに残さない（マスキング）
- ✅ Sentry / Datadog でアラート設定（CRITICAL ≧ 即 Slack 通知）
- ✅ ログレベルを環境で切替（dev=debug, prod=info）
- ✅ 構造化ログ（JSON）で機械検索しやすく
FAQ
Q: echo や print_r でデバッグするのは？
A: 開発時はOK、本番では絶対NG。HTMLに出力される or fastcgi バッファ汚染。必ず error_log / Logger を経由。
Q: ログが大量で重い
A: ① ログレベルを上げる（prod=warning 以上）② 非同期出力（Monolog の BufferHandler + キュー）③ 外部サービスへ送信。
Q: スタックトレースをログに残したい
A: $logger->error('msg', ['exception' => $e]) で Monolog が自動展開。または $e->getTraceAsString()。