Встановлення
Установка
Вимоги до сервера
Фреймворк 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-адреси будуть автоматично налаштовані.