نسخه:

پیکربندی

معرفی

تمام فایل های پیکربندی چارچوب لاراول در config دایرکتوری ذخیره می شوند. هر گزینه مستند است، بنابراین به راحتی می توانید فایل ها را بررسی کنید و با گزینه های موجود در دسترس خود آشنا شوید.

بعد از نصب

نامگذاری برنامه شما

پس از نصب لاراول، ممکن است بخواهید برنامه خود را "نام" کنید. به طور پیش‌فرض، app دایرکتوری در فضای نام قرار می‌گیرد App و توسط Composer با استفاده از استاندارد بارگیری خودکار PSR-4 بارگیری می‌شود . با این حال، می توانید فضای نام را مطابق با نام برنامه خود تغییر دهید که به راحتی می توانید از طریق app:name دستور Artisan این کار را انجام دهید.

به عنوان مثال، اگر برنامه شما "Horsefly" نام دارد، می توانید دستور زیر را از ریشه نصب خود اجرا کنید: 

php artisan app:name Horsefly

App تغییر نام برنامه شما کاملا اختیاری است و در صورت تمایل می توانید فضای نام را حفظ کنید .

پیکربندی دیگر

لاراول نیاز به پیکربندی بسیار کمی دارد. شما برای شروع توسعه آزاد هستید! با این حال، ممکن است بخواهید config/app.php پرونده و مستندات آن را بررسی کنید. این شامل چندین گزینه است مانند timezone و locale اینکه ممکن است بخواهید با توجه به موقعیت مکانی خود تغییر دهید.

پس از نصب لاراول، باید محیط محلی خود را نیز پیکربندی کنید .

توجه: هرگز نباید app.debug گزینه پیکربندی را true برای یک برنامه تولیدی تنظیم کنید.

مجوزها

لاراول ممکن است نیاز به یک مجموعه از مجوزها برای پیکربندی داشته باشد: پوشه‌ها در داخل storage و vendor نیاز به دسترسی نوشتن توسط وب سرور.

دسترسی به مقادیر پیکربندی

با استفاده از نما می توانید به راحتی به مقادیر پیکربندی خود دسترسی پیدا کنید Config : 

$value = Config::get('app.timezone');
 
Config::set('app.timezone', 'America/Chicago');

همچنین می توانید از config تابع کمکی استفاده کنید: 

$value = config('app.timezone');

پیکربندی محیط

معمولاً داشتن مقادیر پیکربندی متفاوت بر اساس محیطی که برنامه در آن اجرا می‌شود مفید است. برای مثال، ممکن است بخواهید از یک درایور حافظه پنهان محلی متفاوتی نسبت به سرور تولیدی خود استفاده کنید. استفاده از پیکربندی مبتنی بر محیط آسان است.

لاراول برای این کار از کتابخانه PHP DotEnv توسط ونس لوکاس استفاده می کند. در یک نصب جدید لاراول، دایرکتوری ریشه برنامه شما حاوی یک .env.example فایل خواهد بود. اگر لاراول را از طریق Composer نصب کنید، این فایل به طور خودکار به .env . در غیر این صورت باید نام فایل را به صورت دستی تغییر دهید.

همه متغیرهای لیست شده در این فایل $_ENV زمانی که برنامه شما درخواستی دریافت می کند در PHP super-global بارگذاری می شود. می توانید از env کمک کننده برای بازیابی مقادیر از این متغیرها استفاده کنید. در واقع، اگر فایل های پیکربندی لاراول را بررسی کنید، متوجه چندین گزینه در حال حاضر از این کمک خواهید شد!

به راحتی می توانید متغیرهای محیط خود را در صورت نیاز برای سرور محلی خود و همچنین محیط تولید خود تغییر دهید. با این حال، فایل شما .env نباید به کنترل منبع برنامه شما متعهد باشد، زیرا هر توسعه دهنده / سروری که از برنامه شما استفاده می کند ممکن است به پیکربندی محیط متفاوتی نیاز داشته باشد.

اگر در حال توسعه با یک تیم هستید، ممکن است بخواهید به اضافه کردن یک .env.example فایل با برنامه خود ادامه دهید. با قرار دادن مقادیر مکان نگهدار در فایل پیکربندی مثال، توسعه دهندگان دیگر تیم شما می توانند به وضوح ببینند که کدام متغیرهای محیطی برای اجرای برنامه شما مورد نیاز است.

دسترسی به محیط برنامه فعلی

environment شما می توانید از طریق روش موجود به محیط برنامه فعلی دسترسی پیدا کنید Application : 

$environment = $app->environment();

همچنین می‌توانید آرگومان‌هایی را به environment متد ارسال کنید تا بررسی کنید که آیا محیط با مقدار مشخصی مطابقت دارد یا خیر: 

if ($app->environment('local'))
{
    // The environment is local
}
 
if ($app->environment('local', 'staging'))
{
    // The environment is either local OR staging...
}

برای به دست آوردن نمونه ای از برنامه، Illuminate\Contracts\Foundation\Application قرارداد را از طریق کانتینر سرویس حل کنید . البته، اگر در یک ارائه دهنده خدمات هستید ، نمونه برنامه از طریق $this->app متغیر نمونه در دسترس است.

یک نمونه برنامه همچنین ممکن است از طریق app کمک یا App نما قابل دسترسی باشد: 

$environment = app()->environment();
 
$environment = App::environment();

ذخیره سازی پیکربندی

برای افزایش سرعت برنامه خود، می توانید با استفاده از config:cache دستور Artisan، تمام فایل های پیکربندی خود را در یک فایل واحد ذخیره کنید. این همه گزینه های پیکربندی برنامه شما را در یک فایل واحد ترکیب می کند که می تواند به سرعت توسط فریمورک بارگذاری شود.

شما معمولاً باید config:cache دستور را به عنوان بخشی از روال استقرار خود اجرا کنید.

حالت تعمیر و نگهداری

هنگامی که برنامه شما در حالت تعمیر و نگهداری است، یک نمای سفارشی برای همه درخواست ها در برنامه شما نمایش داده می شود. این کار باعث می‌شود تا برنامه خود را در حین به‌روزرسانی یا زمانی که در حال تعمیر و نگهداری هستید، «غیرفعال» کنید. بررسی حالت تعمیر و نگهداری در پشته میان‌افزار پیش‌فرض برای برنامه شما گنجانده شده است. اگر برنامه در حالت تعمیر و نگهداری باشد، یک کد HttpException با کد وضعیت 503 پرتاب می شود.

برای فعال کردن حالت نگهداری، به سادگی down دستور Artisan را اجرا کنید: 

php artisan down

برای غیرفعال کردن حالت نگهداری، از up دستور زیر استفاده کنید: 

php artisan up

الگوی پاسخگویی حالت نگهداری

الگوی پیش‌فرض برای پاسخ‌های حالت تعمیر و نگهداری در قرار دارد resources/views/errors/503.blade.php .

حالت نگهداری و صف

در حالی که برنامه شما در حالت تعمیر و نگهداری است، هیچ کار در صف رسیدگی نمی شود. هنگامی که برنامه از حالت تعمیر و نگهداری خارج شد، کارها به صورت عادی انجام می شوند.

URL های زیبا

آپاچی

فریم ورک با public/.htaccess فایلی ارسال می شود که برای اجازه دادن به URL های بدون استفاده می شود index.php . اگر از آپاچی برای سرویس برنامه لاراول خود استفاده می کنید، حتما mod_rewrite ماژول را فعال کنید.

اگر .htaccess فایلی که با لاراول ارسال می شود با نصب آپاچی شما کار نمی کند، این یکی را امتحان کنید: 

Options +FollowSymLinks
RewriteEngine On
 
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]

اگر میزبان وب شما این گزینه را اجازه نمی دهد FollowSymlinks ، سعی کنید آن را با Options +SymLinksIfOwnerMatch .

Nginx

در Nginx، دستورالعمل زیر در پیکربندی سایت شما URL های "زیبا" را مجاز می کند: 

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

البته، هنگام استفاده از Homestead ، URL های زیبا به طور خودکار پیکربندی می شوند.