نصب و راه اندازی

سرور مورد نیاز

فریمورک لاراول چندین نیاز مندی داره.

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

اما اگر از Homestead استفاده نمی کنید ، مطمئن بشید که سرور شما شرایط زیر را داراست:
  • PHP >= 7.2.0
  • BCMath PHP Extension
  • Ctype PHP Extension
  • JSON PHP Extension
  • Mbstring PHP Extension
  • OpenSSL PHP Extension
  • PDO PHP Extension
  • Tokenizer PHP Extension
  • XML PHP Extension

نصب لاراول

لاراول برای مدیریت وابستگی های از Composer استفاده میکند.

پس قبل از استفاده از لاراول مطمئن باشید که Composer روی ماشینتون نصب هست .

نصب با Laravel Installer

ابتدا نصب کننده لاراول رو با کامپوزر نصب میکنیم:

از محل فولدر vendor\bin در $PATH  خودتون مطمئن باشید.

بنابراین لاراول روی سیستم شما قابل اجراست.

این فولدر در آدرس های مختلفی وابسته به سیستم عاملتون وجود داره ;

بهرحال ، برخی از مکانهای مشترک شامل موارد زیر هست:

 

  • macOS  و GNU / نسخه های لینوکس : $HOME/.composer/vendor/bin
  • ویندوز : %USERPROFILE%\AppData\Roaming\Composer\vendor\bin

 

پس از نصب  ،دستور laravel new یک لاراول جدید در فولدرکه مشخص کردید ایجاد میکنه.

برای مثال ، laravel new blog  یک فولدر به نام blog که شامل یک لاراول جدید با تمامی وابستگی های لاراول که قبلا نصب شده ایجاد میشه:

 

نصب با Composer Create-Project

ممکنه شما لاراول رو با اجرای دستور Composer create-project در terminal سیستم نصب کنید.

 

سرور توسعه محلی

اگر شما php رو روی سیستم لوکال خودتون نصب کردید و میخواهید که برنامه رو توی سیستم لوکال اجرا کنید ، شما میتونید از دستور serve artisan استفاده کنید.

دستور اجرای برنامه :

شما میتونید با آدرس localhost:8000 به هاستتون دسترسی داشته باشید.

 

گزینه های  Homestead و Valet  نیز برای توسعه قوی تر در دسترس هستند.

 

پیکربندی

فولدر public

پس از نصب لاراول شما باید فایل های وب سرور خودتون رو در ریشه اصلی  و در فولدر public پیکربندی کنید.

index.php تمام درخواست های http رو پاسخ میده.

پیکر بندی فایل ها

همه فایل های مربوط به پیکربندی فریمورک لاراول در فولدر config ذخیره میشن.

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

مجوز فولدر ها

بعد از نصب لاراول ممکن است که شما بعضی از دسترسی ها رو پیکربندی کنید.

فولدر های داخل storage و فولدر های bootstrap/cache باید توسط وب سرور قابل نوشتن باشند و گر نه لاراول اجرا نمیشه.

اگه از ماشنی مجازی Homestead استفاده میکنید این دسترسی ها باید تنظیم شده باشند.

 

کلید برنامه

مورد بعدی که شما بعد نصب لاراول باید انجام بدید تنظیم کلید برنامه هست.

کلید برنامه یک رشته تصادفی هست که اگه شما .لاراول رو با composer یا نصب کننده لاراول نصب کیده باشید میتونید با دستور زیر اونو تولید کنید :

php artisan key:generate

عموما طول رشته باید ۳۲ کاراکتر باشه .

کلید میتونه در فایل .env تنظیم بشه.

اگه شما هنوز فایل .env.example را در فایل جدید با نام .env کپی نکردید پس بهتره همین الان این کار رو انجام بدید.

اگه کلید رو تنظیم نکرده باشید session های کاربران و دیتا های دیگه برنامه تون امن نخواهد بود.

 

سایر پیکربندی ها

تقریبا لاراول به پیکربندی دیگه ای نیاز ندارد.

شما میتونید کارتون رو شروع کنید.

با این حال ممکنه شما بخواهید فایل پیکربندی config/app.php رو یه بار دیگه بررسی کنید.

که شامل گزینه های مختلفی از جمله timezone  و locale است که ممکنه طبق برنامه تون تغییرش بدید.

 

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

چند تا از کامپوننت ها :

پیکربندی وب سرور

پیکربندی فولدر

لاراول همیشه باید از مسیر “web directory” تنظیم شده برای وب سرورتون خدمات ارائه بده.

شما نباید تلاش کنید که از زیر شاخه “web directory” چیزی رو ارائه بدید.

این کار میتونه فایل های حساس حاضر شما رو در معرض بذاره.

 

pretty URLs

لاراول شامل به فایل ها که که url های غیر index.php رو رائه میده.

قبل تر مطمئن بشید که ماژول mod_rewrite  در آپاچی فعال باشد.

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

 

Nginx

اگه شما از Nginx استفاده میکنید ، دستور زیر در پیکربندی سایتتون همه درخواست های رو به index.php ارسال میکند:

 

وقتی که شما از Homestead or Valet استفاده میکنیم به صورت پیشفرض pretty URLs برای شما فعال شده است.

 

منبع : laravel.com

دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *