Руководство

Конфигурация и окружение

YAML-манифест, типизированные определения конфигурации, значения окружения и production config cache.

Манифест конфигурации

Начните с app/Config/Config.yaml. Он определяет общие, HTTP- и CLI-модули. YAML — входной слой конфигурации, который фреймворк отображает в типизированные config-определения.

example.php
shared:
  - App
  - Providers
  - View
http:
  - Error
cli:
  - Commands

Провайдеры и config-модули

Регистрацию провайдеров храните в Providers.yaml, а настройки отдельных feature — в самостоятельных YAML-модулях, например Api.yaml, View.yaml или Upload.yaml.

example.php
module: providers
config:
  providers:
    - App\Providers\AppServiceProvider

Значения окружения и config cache

Читайте значения окружения через YAML-директивы $env. В production фреймворк компилирует разрешённую конфигурацию в storage/cache/framework/config, но источником истины остаются YAML-файлы и окружение.

example.php
module: app
config:
  base_url:
    $env: APP_BASE_URL
    type: string
    default: http://localhost