فعال کردن حالت Debug در لاراول

laravel debug mode activation
20 آبان 1403

چگونه حالت Debug در لاراول فعال یا غیرفعال می‌شود؟

لاراول یکی از محبوب‌ترین فریم‌ورک‌های PHP است که توسط توسعه‌دهندگان برای ساخت اپلیکیشن‌های وب سریع و کارآمد استفاده می‌شود. یکی از ویژگی‌های مفید لاراول، حالت Debug آن است. این حالت مخصوص زمانی است که شما در حال توسعه اپلیکیشن خود هستید و می‌خواهید اطلاعات بیشتری از خطاها یا مشکلاتی که در کد رخ می‌دهد مشاهده کنید.

حالت Debug به توسعه‌دهندگان کمک می‌کند تا نتایج خطاها را با جزئیات بیشتری دریافت کنند. فعال‌سازی حالت Debug در لاراول به شدت توصیه می‌شود زمانی که شما در حال کار بر روی محیط توسعه (development) هستید. در این حالت، بیشتر خطاهای PHP نمایش داده می‌شود که می‌تواند در پیدا کردن مشکل کمک کند.

برای فعال‌سازی حالت Debug باید فایل پیکربندی.env پروژه لاراول خود را ویرایش کنید. این فایل در ریشه پروژه شما قرار دارد و شامل تنظیمات مختلفی مانند دیتابیس، حالت اپلیکیشن، و حالت Debug می‌شود.

به یاد داشته باشید که حالت Debug را در محیط تولید (production) خاموش نگه دارید زیرا ممکن است خطاهای حساس نمایش داده شوند که برای امنیت اپلیکیشن خطرساز هستند. در ادامه می‌توانید کدهای مربوط به فعال یا غیرفعال کردن حالت Debug در لاراول را مشاهده کنید.


APP_NAME=Laravel
APP_ENV=local
APP_KEY=base64:...
APP_DEBUG=true
APP_URL=http://localhost

LOG_CHANNEL=stack
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=

خط‌به‌خط به توضیحات کد می‌پردازیم:

APP_NAME=Laravel
این خط نام برنامه را تنظیم می‌کند. معمولاً این به عنوان نام پروژه شما تنظیم می‌شود.
APP_ENV=local
این مشخص می‌کند که برنامه در کدام محیط اجرا می‌شود. مقادیر معمول شامل local, testing و production می‌باشد.
APP_KEY=base64:...
این کلید به طور خودکار توسط لاراول برای رمزنگاری استفاده می‌شود. تغییر ندهید مگر با دستور laravel key:generate استفاده نمایید.
APP_DEBUG=true
این خط کنترل می‌کند آیا حالت Debug روشن است یا خیر. اگر true تنظیم شده باشد، در حالت Debug هستید.
APP_URL=http://localhost
این URL پایه‌ی برنامه شما را مشخص می‌کند که در هنگام ارسال ایمیل یا جنبه‌های دیگر می‌تواند مفید باشد.
LOG_CHANNEL=stack
این پیکربندی کانال log را تنظیم می‌کند که لاراول برای ثبت گزارش‌ها استفاده می‌کند.
DB_CONNECTION=mysql
این نوع اتصال دیتابیس را مشخص می‌کند که در اینجا MySQL است.
DB_HOST=127.0.0.1
این خط آدرس میزبان دیتابیس شما را تنظیم می‌کند که معمولاً localhost است.
DB_PORT=3306
این پورت اتصال به دیتابیس را تعریف می‌کند که پیش‌فرض MySQL 3306 است.
DB_DATABASE=laravel
این نام دیتابیسی است که برنامه به آن متصل خواهد شد.
DB_USERNAME=root
این نام کاربری‌ای است که برای اتصال به دیتابیس استفاده می‌شود.
DB_PASSWORD=
این رمز عبوری است که برای اتصال به دیتابیس استفاده می‌شود.

سوالات متداول

؟

چرا باید حالت Debug را در محیط تولید غیرفعال کنم؟

؟

چگونه می‌توانم متوجه شوم که حالت Debug فعال است؟

؟

آیا تغییر فایل .env در اجرای برنامه تأثیر فوری دارد؟