🐞 Laravel Debugbar

یک نوار ابزار (Debug Toolbar) برای نمایش اطلاعات مهم هنگام توسعه مثل کوئری‌ها، session، viewها، درخواست‌ها و...

🧰 نصب Debugbar

bash
composer require barryvdh/laravel-debugbar --dev

چون مخصوص توسعه هست، با --dev نصبش می‌کنیم تا تو محیط production فعال نشه.

⚙️ فعال‌سازی (در صورت نیاز)

بعد از نصب معمولاً خودش فعال میشه. ولی اگر خاموش بود:

php
\Debugbar::enable();

یا تو فایل config/debugbar.php مقدار 'enabled' => true رو بزن.

🔧 منتشر کردن تنظیمات (اختیاری)

bash
php artisan vendor:publish --provider="Barryvdh\Debugbar\ServiceProvider"

این دستور فایل config/debugbar.php رو ایجاد می‌کنه که قابل شخصی‌سازی هست.

🔍 چه چیزهایی رو نشون میده؟

✅ درخواست‌های HTTP
✅ کوئری‌های SQL اجرا شده
✅ Viewهای بارگذاری‌شده
✅ Session / Auth اطلاعات
✅ Route و کنترلر فعلی
✅ مدت زمان اجرای برنامه
✅ درخواست‌های AJAX
✅ و کلی ابزار مفید دیگه!

💬 استفاده دستی

تو هر جایی از کدت می‌تونی اطلاعات دلخواه رو به Debugbar اضافه کنی:

php
\Debugbar::info($user);
\Debugbar::warning('هشدار!');
\Debugbar::error('خطا!');
\Debugbar::addMessage('پیامی دلخواه', 'label');

✅ فیلتر کردن نمایش

در config/debugbar.php می‌تونی بعضی قسمت‌ها رو فعال/غیرفعال کنی. مثلاً:

php
'collectors' => [
    'db' => true,         // نمایش کوئری‌های SQL
    'views' => true,      // نمایش viewها
    'route' => true,      // نمایش route فعلی
    // ...
]

🚫 غیرفعال کردن در production

با استفاده از فایل .env:

env
APP_DEBUG=false

یا دستی غیرفعالش کن:

php
\Debugbar::disable();

📷 نمای ظاهری

بعد از نصب و فعالسازی، یک نوار ابزار شناور در پایین صفحه ظاهر میشه که شامل تب‌هایی مثل:

Messages
Request
Timeline
Views
Route
Queries
Models
Auth
Session
Exceptions
Logs

🔒 امنیت

حتماً مطمئن شو که Debugbar فقط در محیط development فعاله.
نباید اطلاعات حساس در production نمایش داده بشه.

🧪 جمع‌بندی

ابزار	عملکرد
`\Debugbar::info($data)`	نمایش داده در تب Messages
`\Debugbar::addMessage()`	اضافه‌کردن پیام سفارشی
`debugbar.php`	تنظیمات پکیج
`.env`	غیرفعال کردن با `APP_DEBUG=false`