Установка

Установка

Предпочитаете визуальное обучение? На Laracasts вы можете найти бесплатное и подробное введение в Laravel для новичков. Это отличная отправная точка вашего путешествия.

Требования к серверу

Фреймворк Laravel предъявляет некоторые системные требования. Конечно же, виртуальная машина Laravel Homestead соответствует всем этим требованиям, поэтому настоятельно рекомендуется использовать Homestead в качестве основной локальной среды разработки с Laravel.

Однако, если вы не используете Homestead, вам необходимо убедиться, что ваш сервер соответствует следующим требованиям:

Установка Laravel

Laravel использует Composer для управления своими зависимостями, поэтому убедитесь в том, что Composer установлен на вашей машине.

С помощью установщика Laravel

Сначала скачайте установщик Laravel с помощью Composer:

composer global require "laravel/installer"

Проверьте, чтобы директория $HOME/.composer/vendor/bin (или аналогичная в зависимости от вашей ОС) находилась в переменной $PATH, что позволит вашей системе найти и выполнить команду laravel.

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

laravel new blog

С помощью Composer Create-Project

В качестве альтернативы вы можете использовать Composer для установки Laravel с помощью команды create-project:

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

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

Если локально у вас уже установлен PHP и вы хотели бы использовать встроенный сервер для работы вашего приложения, то вы можете использовать команду Artisan serve. Эта команда запустит сервер разработки по адресу http://localhost:8000:

php artisan serve

Конечно же, Homestead и Valet предоставляют наиболее надежные способы локальной разработки.

Настройка

Общедоступная директория

После установки 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, такие как:

Настройка веб-сервера

"Красивые" URL

Apache

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

Если поставляемый с Laravel файл .htaccess не работает с вашим сервером 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 будет работать без дополнительных настроек.