Версія фреймворка: 8.x

Встановлення

Установка

Вимоги до сервера

Фреймворк Laravel має кілька системних вимог. Всі ці вимоги задовольняються Homestead Laravelвіртуальної машини, тому настійно рекомендується використовувати Homestead як місцеве середовище розробки Laravel.

Однак, якщо ви не використовуєте Homestead, вам потрібно переконатися, що ваш сервер відповідає таким вимогам:

  • PHP >= 7.3
  • BCMath PHP Extension
  • Ctype PHP Extension
  • Fileinfo PHP Extension
  • JSON PHP Extension
  • Mbstring PHP Extension
  • OpenSSL PHP Extension
  • PDO PHP Extension
  • Tokenizer PHP Extension
  • XML PHP Extension

Встановлення Laravel

Laravel використовуєComposerдля управління його залежностями. Отже, перед використанням Laravel переконайтеся, що на вашому комп'ютері встановлено Composer.

Через інсталятор Laravel

Спочатку завантажте інсталятор Laravel за допомогою Composer:

composer global require laravel/installer

Переконайтеся, що ви помістили каталог Composer у свій$PATHтак що виконуваний файл laravel може знаходитись у вашій системі. Цей каталог існує в різних місцях залежно від вашої операційної системи; Найчастіше в таких місцях:

  • macOS: $HOME/.composer/vendor/bin
  • Windows: %USERPROFILE%\AppData\Roaming\Composer\vendor\bin
  • GNU / Linux Distributions: $HOME/.config/composer/vendor/bin or $HOME/.composer/vendor/bin

Ви також можете знайти глобальний шлях встановлення composer, запустившиcomposer global about.

Після встановленняlaravel newкоманда створить нову інсталяцію Laravel у вказаному каталозі. Наприклад,laravel new blogстворить каталог з іменемblogщо містить свіжу інсталяцію Laravel з усіма вже встановленими залежностями Laravel:

laravel new blog
Хочете створити проект Laravel із входом, реєстрацією та іншими функціями, він вже створеними для вас? ПогляньтеLaravel Jetstream.

Через проект Composer Create

Ви також можете встановити Laravel, за допомогою Composercreate-projectкоманди у терміналі:

composer create-project --prefer-dist laravel/laravel blog

Локальний сервер розробки

Якщо у вас PHP встановлений локально, і ви хочете використовувати вбудований сервер розробки PHP для обслуговування своєї програми, ви можете використовуватиserve artisan командування. Ця команда запустить сервер розробки вhttp://localhost:8000:

php artisan serve

Більш надійні варіанти локальної розробки доступні через Homestead іКамердинер.

Конфігурація

Публічний каталог

Після встановлення Laravel вам слід налаштувати документ / веб-корінь веб-сервера наpublicкаталог.index.phpу цьому каталозі виконує функції контролера для всіх HTTP-запитів, що надходять у вашу програму.

Файли конфігурації

Всі файли конфігурації фреймворку Laravel зберігаються вconfigкаталозі. Кожена опція задокументована, тож сміливо переглядайте файли та знайомтесь із доступними вам параметрами.

Дозволи каталогу

Після встановлення Laravel вам може знадобитися налаштувати деякі дозволи. Папки всерединіstorageтаbootstrap/cacheкаталоги повинні бути записані на вашому веб-сервері, інакше Laravel не працюватиме. Якщо ви використовуєте Homestead віртуальної машини, ці дозволи вже мають бути встановлені.

Ключ програми

Наступним, що вам слід зробити після встановлення Laravel, є встановлення ключа програми на випадковий рядок. Якщо ви встановили Laravel через Composer або інсталятор Laravel, цей ключ для вас уже встановивphp artisan key:generateкоманди.

Зазвичай цей рядок повинен мати довжину 32 символи. Клавішу можна встановити в.envфайл середовища. Якщо ви не скопіювали файл.env.exampleфайл у новий файл з іменем.env, ви повинні це зробити зараз.Якщо ключ програми не встановлений, ваші сеанси користувача та інші зашифровані дані не будуть захищені!

Додаткова конфігурація

Laravel майже не потребує жодної іншої конфігурації. Ви можете розпочати розробку! Однак, можливо, ви захочете переглянутиconfig/app.phpфайл та його документація. Він містить кілька варіантів, таких якtimezoneіlocaleякі ви можете змінити відповідно до вашої заявки.

Ви також можете налаштувати кілька додаткових компонентів Laravel, таких як:

Конфігурація веб-сервера

Конфігурація каталогу

Laravel завжди повинен подаватися з кореня "веб-каталогу", налаштованого для вашого веб-сервера. Не слід намагатися обслуговувати додаток Laravel із підкаталогу "веб-каталогу". Спроба зробити це може відкрити конфіденційні файли, що знаходяться у вашій програмі.

Гарні URL-адреси

Апачі

Laravel включає apublic/.htaccessфайл, який використовується для надання URL-адрес безindex.phpпередній контролер на шляху. Перш ніж подавати Laravel разом з Apache, не забудьте включитиmod_rewriteмодуль так.htaccessфайл буде виконаний сервером.

Якщо.htaccessфайл, який постачається з Laravel, не працює з вашою установкою Apache, спробуйте наступну альтернативу:

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 абоКамердинер, гарні URL-адреси будуть автоматично налаштовані.