Guía

Configuración y entorno

Manifest YAML, definiciones tipadas de configuración, valores de entorno y config cache de producción.

Manifest de configuración

Empieza en app/Config/Config.yaml. Define los módulos compartidos, HTTP y CLI. YAML es la capa de entrada de configuración y el framework la mapea a definiciones config tipadas.

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

Providers y módulos de configuración

Mantén el registro de providers en Providers.yaml y la configuración de cada feature en módulos YAML separados, como Api.yaml, View.yaml o Upload.yaml.

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

Valores de entorno y config cache

Lee los valores de entorno mediante directivas YAML $env. En producción, el framework compila la configuración resuelta en storage/cache/framework/config, pero los archivos YAML y el entorno siguen siendo la fuente de verdad.

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