Конфигурация Laravel (5.7)

Вступление

Все файлы, отвечающие за настройку в Laravel, хранятся в каталоге config. Скриншот виден ниже.

Различные перечисленные файлы отвечают за различные конфигурации.

Конфигурация среды

В зависимости от среды, в которой запущено приложение laravel, значения конфигурации в этих средах будут другими. Например, вы хотите использовать другую конфигурацию в локальной разработке, чем когда приложение находится в производстве. Laravel использует PHP-библиотеку DotEnv, которая поставляется с файлом .env.example. Это файл, в котором указана конфигурация для приложения.

При использовании платформы управления версиями, такой как Github, вы должны быть осторожны, чтобы не фиксировать свой файл .env, поскольку другому разработчику, использующему ваше приложение, может потребоваться другая конфигурация в зависимости от среды. Кроме того, это будет представлять угрозу безопасности в случае, если злоумышленник получит доступ к вашему репозиторию управления источниками, поскольку будут раскрыты любые конфиденциальные учетные данные.

Типы переменных среды

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

Если вам нужно определить переменную среды со значением, содержащим пробелы, вы можете сделать это, заключив значение в двойные кавычки.

APP_NAME = "Моя заявка"

Получение конфигурации среды

все переменные, перечисленные в этом файле, будут загружены в суперглобальный $ _ENV PHP, когда ваше приложение получит запрос. Тем не менее, вы можете использовать env helper для получения значений из этих переменных в ваших конфигурационных файлах

'debug' => env('APP_DEBUG', false),

Определение текущей среды

текущая прикладная среда определяется переменной APP_ENV из вашего файла .env .

К этому значению можно получить доступ через метод среды на фасаде приложения.

$environment = App::environment();

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

if (App::environment('local')) 
{
    // The environment is local.
}

if (App::environment('local', 'staging')) 
{
    // The environment is either local OR staging.
}

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

Доступ к значениям конфигурации можно получить с помощью синтаксиса «точка», который включает имя файла и параметр, к которому вы хотите получить доступ. Значение по умолчанию также может быть указано и будет возвращено, если опция конфигурации не существует.

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

Чтобы установить значение конфигурации во время выполнения, передайте массив помощнику конфигурации.

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

Кэширование конфигурации

Чтобы ускорить работу вашего приложения, вы должны кэшировать все ваши файлы конфигурации в один файл с помощью команды config: cache Artisan. Это объединит все параметры конфигурации вашего приложения в один файл, который будет быстро загружен платформой.

Обычно вы должны запускать команду php artisan config: cache как часть вашей производственной процедуры развертывания.

Режим технического обслуживания

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

Чтобы включить режим обслуживания, просто выполните команду down Artisan:

php artisan down

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

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

Даже в режиме обслуживания конкретным IP-адресам или сетям может быть разрешен доступ к приложению с помощью параметра команды allow:

php artisan down --allow=127.0.0.1 --allow=192.168.0.0/16

Чтобы отключить режим обслуживания, используйте команду up.

php artisan up

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

Шаблон по умолчанию для ответов в режиме обслуживания находится в resources / views / errors / 503.blade.php .

Вы можете изменить это представление по мере необходимости для вашего приложения.

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

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

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

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

Предыдущая: Laravel (5.7) Учебник
Следующая: Laravel (5.7) Структура каталогов