Monolog

استاندارد لاگ‌گیری در PHP با ده‌ها handler

۴.۸۸ از ۵ PHP

این کتابخانه چیست و چه می‌کند؟

Monolog کتابخانه استاندارد لاگ PHP است: پیام‌ها با سطح (debug تا emergency) و context ساخت‌یافته ثبت می‌شوند و با handlerها به فایل، Syslog، دیتابیس، Slack یا سرویس‌های مانیتورینگ می‌روند. Laravel هم در هسته خود از Monolog استفاده می‌کند و PSR-3 را کامل پیاده می‌کند.

قابلیت‌های کلیدی

  • سطوح استاندارد لاگ PSR-3
  • handlerهای فایل، Slack، Syslog و…
  • Processor و Formatter قابل سفارشی‌سازی
  • ارسال هم‌زمان به چند مقصد

مثال کاربردی واقعی

قابل اجرا
use Monolog\Logger;
use Monolog\Handler\StreamHandler;

$log = new Logger('app');
$log->pushHandler(new StreamHandler(__DIR__ . '/app.log', Logger::WARNING));

$log->warning('حافظه مصرفی بالا است');
$log->error('اتصال دیتابیس قطع شد', ['host' => 'db-1']);

توضیح مثال: هر لاگر چند handler می‌پذیرد؛ مثلاً خطاها به Slack و همه چیز به فایل. سطح لاگ را بر اساس محیط (توسعه یا تولید) از تنظیمات بخوانید.

نکات حرفه‌ای

  • context ساخت‌یافته بدهید تا لاگ‌ها قابل جستجو بمانند.
  • در محیط تولید سطح را ERROR بگذارید تا حجم لاگ منفجر نشود.