Установка Laravel

Published November 29, 2020 • 2 mins read

  1. Вимоги до сервера
  2. Встановлення Laravel
  3. Конфігурація
  1. Красиві URL-и

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

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

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

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

- PHP >= 7.0.0 - OpenSSL PHP Extension - PDO PHP Extension - Mbstring PHP Extension - Tokenizer PHP Extension - XML PHP Extension

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

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


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

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

composer global require "laravel/installer"

Перевірте, щоб директорія composer/vendor/bin була в вашому $PATH. Цей каталог існує в різних місцях на основі вашої операційної системи; однак деякі загальні місця включають в себе:

- MacOS: `$HOME/.composer/vendor/bin` - GNU / Linux Distributions: `$HOME/.config/composer/vendor/bin`

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

laravel new blog


Через Composer Create-Project

Крім того, ви також можете встановити Laravel, виконавши команду Composer create-project у своєму терміналі:

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


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

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

php artisan serve

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

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


Публічна директорія

Після встановлення Laravel, ви повинні налаштувати document / web root вашого веб-сервера до 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 needs almost no other configuration out of the box. You are free to get started developing! However, you may wish to review the config/app.php file and its documentation. It contains several options such as timezone and locale that you may wish to change according to your application.

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

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

- [Cache](/docs/{{version}}/cache#configuration) - [Database](/docs/{{version}}/database#configuration) - [Session](/docs/{{version}}/session#configuration)

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

Красиві URL-и

Apache

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

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

Options +FollowSymLinks
RewriteEngine On

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-и будуть автоматично зконфігуровані.

Подпишись на рассылку