مدیریت لاگ‌ها در لاراول یکی از جنبه‌های مهم توسعه است که به شما کمک می‌کند تا عملکرد برنامه را پیگیری کنید، مشکلات را شناسایی نمایید و بهبودهای لازم را اعمال کنید. لاراول از پکیج قدرتمند Monolog برای مدیریت لاگ‌ها استفاده می‌کند که امکان ثبت و ذخیره انواع مختلف لاگ‌ها را فراهم می‌کند.

در این مقاله، به نحوه مدیریت لاگ‌ها در لاراول، پیکربندی آن و نحوه استفاده از قابلیت‌های مختلف لاگ‌برداری خواهیم پرداخت.

1. 🛠 پیکربندی لاگ‌ها در لاراول

لاراول پیکربندی پیش‌فرضی برای لاگ‌ها دارد که در فایل config/logging.php قرار دارد. این فایل به شما امکان می‌دهد تا نحوه ذخیره و مدیریت لاگ‌ها را تنظیم کنید.

1.1. ساختار فایل logging.php

در این فایل می‌توانید پیکربندی‌های مختلفی مانند نوع کانال‌ها، سطح لاگ و محل ذخیره لاگ‌ها را تعیین کنید.

php
CopyEdit
return [
    'default' => env('LOG_CHANNEL', 'stack'),

    'channels' => [
        'stack' => [
            'driver' => 'stack',
            'channels' => ['single'],
        ],

        'single' => [
            'driver' => 'single',
            'path' => storage_path('logs/laravel.log'),
            'level' => 'debug',
        ],

        'daily' => [
            'driver' => 'daily',
            'path' => storage_path('logs/laravel.log'),
            'level' => 'debug',
            'days' => 14,
        ],

        'slack' => [
            'driver' => 'slack',
            'url' => env('LOG_SLACK_WEBHOOK_URL'),
            'username' => 'Laravel Log',
            'level' => 'critical',
        ],

        'syslog' => [
            'driver' => 'syslog',
            'level' => 'debug',
        ],

        'errorlog' => [
            'driver' => 'errorlog',
            'level' => 'debug',
        ],
    ],
];

توضیحات بخش‌های مختلف:

• default: کانال پیش‌فرض که لاگ‌ها به آن ارسال می‌شوند. می‌توانید با تغییر این تنظیم، کانال دلخواه خود را انتخاب کنید.

• channels: تعریف کانال‌های مختلف که می‌توانند از درایورهای مختلف مانند single, daily, slack و غیره استفاده کنند.

2. ⚙️ انواع کانال‌ها در لاراول

لاراول به‌طور پیش‌فرض چندین کانال مختلف برای لاگ‌ها فراهم می‌کند که می‌توانید بر اساس نیاز خود از آن‌ها استفاده کنید.

2.1. کانال Single

این کانال تمامی لاگ‌ها را در یک فایل ذخیره می‌کند. معمولاً برای برنامه‌های کوچک یا توسعه استفاده می‌شود.

php
CopyEdit
'single' => [
    'driver' => 'single',
    'path' => storage_path('logs/laravel.log'),
    'level' => 'debug',
],

2.2. کانال Daily

در این کانال، لاگ‌ها به صورت روزانه ذخیره می‌شوند و در نهایت فایل‌های قدیمی‌تر حذف می‌شوند. این روش معمولاً برای پروژه‌های بزرگ‌تر که حجم بالای لاگ دارند، مفید است.

php
CopyEdit
'daily' => [
    'driver' => 'daily',
    'path' => storage_path('logs/laravel.log'),
    'level' => 'debug',
    'days' => 14,  // نگهداری لاگ‌ها برای 14 روز
],

2.3. کانال Slack

لاگ‌ها به‌طور خاص به کانال Slack ارسال می‌شوند. این کانال به‌ویژه برای گزارش مشکلات بحرانی یا هشدارها مفید است.

php
CopyEdit
'slack' => [
    'driver' => 'slack',
    'url' => env('LOG_SLACK_WEBHOOK_URL'),
    'username' => 'Laravel Log',
    'level' => 'critical',
],

2.4. کانال Syslog

این کانال برای ارسال لاگ‌ها به سیستم لاگ‌های Syslog استفاده می‌شود.

php
CopyEdit
'syslog' => [
    'driver' => 'syslog',
    'level' => 'debug',
],

2.5. کانال Errorlog

در این کانال، لاگ‌ها به سیستم لاگ‌های error_log ارسال می‌شوند.

php
CopyEdit
'errorlog' => [
    'driver' => 'errorlog',
    'level' => 'debug',
],

3. 🔧 ثبت لاگ‌ها در لاراول

برای ثبت لاگ‌ها در لاراول، می‌توانید از هاب لاگ Log استفاده کنید که دسترسی به تمام کانال‌ها را فراهم می‌کند. لاراول این قابلیت را از طریق فاساد Log در اختیار شما قرار می‌دهد.

3.1. ثبت لاگ‌های ساده

برای ثبت لاگ در لاراول، می‌توانید از متدهای مختلفی مانند info(), warning(), error() و غیره استفاده کنید. این متدها به شما کمک می‌کنند تا انواع مختلفی از لاگ‌ها را ثبت کنید.

مثال:

php
CopyEdit
use Illuminate\Support\Facades\Log;

Log::info('This is an informational message');
Log::warning('This is a warning message');
Log::error('This is an error message');

3.2. ثبت لاگ با جزئیات بیشتر

شما می‌توانید داده‌های اضافی مانند آرایه‌ها یا اشیاء را در لاگ‌ها وارد کنید.

مثال:

php
CopyEdit
Log::debug('User details', ['user' => $user]);

این لاگ اطلاعات کاربر را به همراه پیام ثبت می‌کند.

3.3. ثبت لاگ در کانال خاص

برای ثبت لاگ‌ها در کانال خاصی که در پیکربندی تعریف کرده‌اید، می‌توانید از متد channel استفاده کنید:

مثال:

php
CopyEdit
Log::channel('slack')->critical('Critical error occurred!');

این دستور لاگ را به کانال Slack ارسال می‌کند.

4. 🧑‍💻 آزمایش و مشاهده لاگ‌ها

لاگ‌ها به‌طور پیش‌فرض در دایرکتوری storage/logs ذخیره می‌شوند. شما می‌توانید فایل‌های لاگ را از طریق این مسیر مشاهده کنید. به‌طور مثال، برای مشاهده لاگ‌های روزانه می‌توانید از دستور زیر استفاده کنید:

bash
CopyEdit
tail -f storage/logs/laravel.log

این دستور آخرین لاگ‌های ثبت‌شده را به صورت زنده نمایش می‌دهد.

5. 🛡 مدیریت سطح لاگ‌ها

در لاراول، می‌توانید سطح لاگ‌ها را تنظیم کنید تا فقط لاگ‌هایی با اولویت‌های خاص ذخیره شوند. سطح‌های لاگ می‌توانند شامل موارد زیر باشند:

• debug

• info

• notice

• warning

• error

• critical

• alert

• emergency

شما می‌توانید سطح لاگ‌ها را در پیکربندی کانال‌ها در فایل config/logging.php مشخص کنید. به‌عنوان مثال، می‌توانید سطح لاگ را برای کانال daily به error تغییر دهید تا فقط خطاها و مشکلات بحرانی ذخیره شوند:

php
CopyEdit
'daily' => [
    'driver' => 'daily',
    'path' => storage_path('logs/laravel.log'),
    'level' => 'error',  // فقط خطاها ثبت می‌شوند
    'days' => 14,
],

6. 🔄 تنظیمات پیشرفته و بهینه‌سازی

6.1. فیلتر کردن لاگ‌ها با استفاده از Middleware

شما می‌توانید از Middleware برای فیلتر کردن یا ثبت لاگ‌های خاص در طول درخواست‌ها استفاده کنید.

6.2. ارسال لاگ‌ها به سیستم‌های خارجی

اگر نیاز دارید که لاگ‌ها را به سیستم‌های خارجی مانند Loggly, Papertrail, Sentry و غیره ارسال کنید، می‌توانید پیکربندی مناسبی در فایل logging.php انجام دهید تا این خدمات را پشتیبانی کنید.

نتیجه‌گیری

مدیریت لاگ‌ها در لاراول با استفاده از پیکربندی‌های پیشرفته و قابلیت‌های مختلف فاساد Log به راحتی امکان‌پذیر است. با استفاده از این ابزارها می‌توانید لاگ‌ها را برای پیگیری مشکلات، امنیت و بهینه‌سازی برنامه‌های خود به‌طور مؤثر مدیریت کنید.