Установка

shcomposer create-project --prefer-dist laravel/laravel blog "5.3.*"

shcomposer create-project laravel/laravel blog "5.1.*"

shcomposer create-project laravel/laravel {directory} "~5.0.0" --prefer-dist

После установки необходимо обновить пакеты до последних версий. Сначала удалите файл {directory}/vendor/compiled.php, затем смените текущий каталог на {directory} и выполните команду shcomposer update.

Laravel устанавливается с готовыми преднастройками для регистрации и авторизации пользователей. Если хотите удалить их, используйте Artisan-команду shfresh:

shphp artisan fresh

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

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

shphp artisan serve

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

Папка public

После установки Laravel необходимо настроить документ/веб корень вашего веб-сервера на папку public. Файл index.php в этой папке служит в качестве фронт-контроллера для всех HTTP-запросов, входящих в ваше приложение.

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

Красивые URL

Apache

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

Если стандартный .htaccess не работает для вашего Apache, попробуйте следующий:

confOptions +FollowSymLinks
RewriteEngine On

RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]

Nginx

При использовании Nginx следующая директива в настройках вашего сайта позволит перенаправлять все запросы в фронт-контроллер shindex.php:

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

Само собой, при использовании Homestead или Valet красивые URL будут настроены автоматически.

Настройки окружения

Часто бывает полезно иметь разные значения настроек в зависимости от окружения, в котором работает приложение. Например, если вы используете разные драйверы кэша при локальной разработке и на сервере. Для этого можно просто использовать настройки на основе окружения.

Для удобства в Laravel используется PHP-библиотека DotEnv от Ванса Лукаса. В свежеустановленном Laravel в корневом каталоге вашего приложения находится файл .env.example. Если вы установили Laravel при помощи Composer, этот файл автоматически переименован в .env. В другом случае вам придётся переименовать его вручную.

Все находящиеся в этом файле переменные будут загружены в супер-глобальную переменную PHP $_ENV, когда ваше приложение получит запрос. Вы можете использовать функцию PHPenv() для получения значений из этой переменной. На самом деле, если вы посмотрите в файлы настроек Laravel, то обнаружите, что некоторые параметры уже используют эту функцию!

Вы можете изменять переменные среды по своему желанию для своего локального сервера, и для «продакшн»-сервера. Но вам не надо помещать файл .env в вашу систему контроля версий, так как каждому разработчику / серверу могут быть необходимы собственные настройки окружения для использования вашего приложения.

Если вы работаете в команде, вы можете продолжать включать файл .env.example в ваше приложение. Поместив примеры значений в пример файла настроек, вы поможете другим разработчикам легко разобраться, какие переменные среды необходимы для запуска вашего приложения.

Получение текущего окружения приложения
Текущее окружение приложения определяется с помощью переменной APP_ENV в файле .env. Вы можете получить это значение методом PHPenvironment() фасада App:

$environment = App::environment();

Также вы можете передать аргумент в метод PHPenvironment(), чтобы проверить совпадение с указанным значением. При необходимости вы можете передать даже несколько значений:

if (App::environment('local')) {
    // Локальное окружение
}

if (App::environment('local', 'staging')) {
    // Окружение либо локальное, либо тестовое...
}

Экземпляр приложения также можно получить при помощи вспомогательного метода PHPapp():

$environment = app()->environment();

Настройки кэширования

Для ускорения вашего приложения вы можете кэшировать все файлы настроек в единый файл при помощи Artisan-команды shconfig:cache. Эта команда соберёт все параметры вашего приложения в единый файл, который может быть быстро загружен фреймворком.

Вам стоит всегда выполнять команду shphp artisan config:cache, как часть процедуры развёртывания в «продакшн». При локальной разработке не стоит выполнять эту команду, так как параметры необходимо часто изменять при разработке приложения.

Доступ к значениям настроек

Вы легко можете обратиться к значениям настроек при помощи глобальной вспомогательной функции PHPconfig(). К значениям настроек можно обращаться с помощью «точечного» синтаксиса, который включает в себя имя файла и необходимый параметр. Также можно указать значение по умолчанию, которое будет возвращено, если запрашиваемый параметр не существует:

$value = config('app.timezone');

Чтобы задать значения настроек во время выполнения, передайте массив в функцию PHPconfig():

config(['app.timezone' => 'America/Chicago']);

Название для приложения

После установки Laravel вы можете дать «имя» вашему приложению. По умолчанию папка app входит в пространство имён App, и загружается с помощью Composer по стандарту автозагрузки PSR-4. Но вы можете изменить пространство имён в соответствии с названием вашего приложения, это делается простой Artisan-командой shapp:name.

Например, если ваше приложение называется «Horsefly», вы можете выполнить такую команду в корневом каталоге приложения:

shphp artisan app:name Horsefly

Переименование приложения вовсе не обязательно, при желании вы можете оставить пространство имён App.

Режим обслуживания

Когда ваше приложение находится в режиме обслуживания, для всех запросов в ваше приложение будет отображаться специальное представление. Это позволяет легко «отключить» приложение при его обновлении или выполнении обслуживания. Проверка режима обслуживания включена в стандартный набор посредников для вашего приложения. Если приложение находится в режиме обслуживания, будет выброшено исключение HttpException с кодом состояния 503.

Для включения режима обслуживания просто выполните Artisan-команду shdown:

shphp artisan down

Для отключения режима обслуживания используйте команду shup:

shphp artisan up

Шаблон отклика режима обслуживания

Стандартный шаблон отклика режима обслуживания расположен в resources/views/errors/503.blade.php.

Режим обслуживания и очереди

Когда ваше приложение находится в режиме обслуживания, не будут обрабатываться задачи в очереди. После выключения режима обслуживания задачи продолжат обрабатываться в обычном режиме.