Настройка

После установки

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

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

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

shphp artisan app:name Horsefly

Задание имени для вашего приложения вовсе не обязательно, и вы можете оставить пространство имён PHPApp, если захотите.

Другие настройки

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

После установки Laravel вам также надо настроить вашу локальную среду.

Внимание: никогда не устанавливайте параметр app.debug в значение true для продакшна.

Права доступа

Для Laravel может потребоваться настроить один набор прав доступа: веб-серверу требуются права записи в папки, находящиеся в storage и vendor.

Также вы можете создать файл .env.testing. Этот файл переопределит значения файла .env при запуске тестов PHPUnit и при выполнении Artisan-команд с ключом sh--env=testing.

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

$environment = App::environment();

Также вы можете передавать аргументы в метод PHPenvironment(), чтобы проверить — совпадает ли имя среды с заданным значением. Метод вернёт PHPtrue, если среда совпадёт с любым из них:

if (App::environment('local')) {
  // Среда локальная (local)
}

if (App::environment('local', 'staging')) {
  // Среда локальная (local) ИЛИ отладочная (staging)...
}

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

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

Вы можете получить имя текущей среды приложения с помощью метода PHPenvironment для экземпляра PHPApplication:

$environment = $app->environment();

Также вы можете передавать аргументы в метод PHPenvironment(), чтобы проверить — совпадает ли имя среды с заданным значением. Метод вернёт PHPtrue, если среда совпадёт с любым из них:

if ($app->environment('local'))
{
  // Среда локальная (local)
}

if ($app->environment('local', 'staging'))
{
  // Среда локальная (local) ИЛИ отладочная (staging)...
}

Чтобы получить экземпляр приложения, выполните контракт Illuminate\Contracts\Foundation\Application с помощью сервис-контейнера. Конечно, когда вы находитесь внутри сервис-провайдера, экземпляр приложения доступен через переменную PHP$this->app.

Экземпляр приложения также доступен через функцию PHPapp() или фасад PHPApp:

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

$environment = App::environment();

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

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

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

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

Вы легко можете прочитать значения настроек, используя фасад PHPConfig:

$value = Config::get('app.timezone');

Config::set('app.timezone', 'America/Chicago');

Вы также можете использовать вспомогательную функцию PHPconfig:

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

Если вы выполняете команду shconfig:cache во время процесса развёртывания, вы должны быть уверены, что вызываете функцию PHPenv() только из ваших файлов настроек.

Также вы можете передать в команду down опции message и retry. Значение message можно использовать для вывода или записи в журнал необходимого сообщения, а значение retry будет задано в качестве значения HTTP-заголовка Retry-After:

shphp artisan down --message="Upgrading Database" --retry=60

Альтернативы режиму обслуживания

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

Красивые URL

Apache

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

Если поставляемый с Laravel файл .htaccess не работает с вашей инсталляцией Apache, попробуйте этот:

confOptions +FollowSymLinks
RewriteEngine On

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

Если ваш хостинг не разрешает опцию FollowSymlinks, попробуйте заменить её на Options +SymLinksIfOwnerMatch.

Nginx

В Nginx следующая директива в настройках вашего сайта позволит использовать «красивые» URL-адреса:

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

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