نسخه:

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

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

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

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

با این حال، اگر از Homestead استفاده نمی کنید، باید مطمئن شوید که سرور شما شرایط زیر را برآورده می کند:

  • PHP >= 7.2.5
  • پسوند BCMath PHP
  • پسوند PHP Ctype
  • پسوند فایل اطلاعات PHP
  • پسوند JSON PHP
  • پسوند PHP Mbstring
  • پسوند OpenSSL PHP
  • پسوند PDO PHP
  • پسوند PHP Tokenizer
  • پسوند XML PHP

نصب لاراول

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

از طریق Laravel Installer

ابتدا نصب کننده لاراول را با استفاده از Composer دانلود کنید: 

composer global require laravel/installer

مطمئن شوید که پوشه vendor bin در سراسر سیستم Composer را در خود قرار دهید $PATH تا فایل اجرایی لاراول توسط سیستم شما قرار گیرد. این دایرکتوری بر اساس سیستم عامل شما در مکان های مختلف وجود دارد. با این حال، برخی از مکان های رایج عبارتند از:

  • سیستم عامل مک: $HOME/.composer/vendor/bin
  • پنجره ها: %USERPROFILE%\AppData\Roaming\Composer\vendor\bin
  • توزیع های گنو / لینوکس: $HOME/.config/composer/vendor/bin یا $HOME/.composer/vendor/bin

همچنین می توانید مسیر نصب جهانی Composer را با اجرا composer global about و جستجو از خط اول پیدا کنید.

پس از نصب، laravel new دستور یک نصب جدید لاراول در دایرکتوری که شما مشخص کرده اید ایجاد می کند. به عنوان مثال، یک دایرکتوری به نام حاوی یک نصب جدید لاراول با تمام وابستگی های لاراول از قبل نصب شده laravel new blog ایجاد می کند : blog 

laravel new blog

از طریق Composer Create-Project

همچنین، می‌توانید لاراول را با صدور create-project فرمان Composer در ترمینال خود نصب کنید: 

composer create-project --prefer-dist laravel/laravel blog "6.*"

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

اگر PHP را به صورت محلی نصب کرده اید و می خواهید از سرور توسعه داخلی PHP برای ارائه برنامه خود استفاده کنید، می توانید از serve دستور Artisan استفاده کنید. این دستور سرور توسعه را در آدرس زیر راه اندازی می کند http://localhost:8000 : 

php artisan serve

گزینه های توسعه محلی قوی تر از طریق Homestead و Valet در دسترس هستند .

پیکربندی

دایرکتوری عمومی

پس از نصب لاراول، باید سند / ریشه وب سرور خود را به عنوان public دایرکتوری پیکربندی کنید. در index.php این دایرکتوری به عنوان کنترل کننده جلو برای تمام درخواست های HTTP که وارد برنامه شما می شوند عمل می کند.

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

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

مجوزهای دایرکتوری

پس از نصب لاراول، ممکن است لازم باشد برخی از مجوزها را پیکربندی کنید. دایرکتوری های داخل storage و bootstrap/cache دایرکتوری ها باید توسط وب سرور شما قابل نوشتن باشند وگرنه لاراول اجرا نمی شود. اگر از ماشین مجازی Homestead استفاده می کنید ، این مجوزها باید از قبل تنظیم شده باشند.

کلید برنامه

کاری که بعد از نصب لاراول باید انجام دهید این است که کلید برنامه خود را روی یک رشته تصادفی تنظیم کنید. اگر لاراول را از طریق Composer یا Laravel installer نصب کرده اید، این کلید قبلاً با php artisan key:generate دستور برای شما تنظیم شده است.

به طور معمول، این رشته باید 32 کاراکتر باشد. کلید را می توان در .env فایل محیطی تنظیم کرد. اگر .env.example فایل را در فایل جدیدی با نام کپی نکرده اید .env ، باید این کار را اکنون انجام دهید. اگر کلید برنامه تنظیم نشده باشد، جلسات کاربر و سایر داده های رمزگذاری شده شما ایمن نخواهند بود!

پیکربندی اضافی

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

همچنین ممکن است بخواهید چند مؤلفه اضافی لاراول را پیکربندی کنید، مانند:

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

پیکربندی دایرکتوری

لاراول باید همیشه خارج از ریشه «دایرکتوری وب» پیکربندی شده برای وب سرور شما ارائه شود. شما نباید سعی کنید یک برنامه لاراول را از زیر شاخه ای از "دایرکتوری وب" ارائه دهید. تلاش برای انجام این کار می‌تواند فایل‌های حساس موجود در برنامه شما را فاش کند.

URL های زیبا

آپاچی

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

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

Options +FollowSymLinks -Indexes
RewriteEngine On
 
RewriteCond %{HTTP:Authorization} .
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
 
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]

Nginx

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

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

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