Estado (State)
El objeto $state está disponible en todas las directivas. Es el punto de entrada para interactuar con el entorno de ejecución de Hefesto.
Desde $state puedes acceder a:
- $state->message() → Lee/escribe la request y la response: cabeceras, body, queryParams, pathParams, verbo, status. Más información en Message.
- $state->memory() → Almacena y recupera valores temporales durante el flujo de la petición. Más información en Memory.
- $state->map('nombre') → Lee los maps de configuración por entorno. Métodos:
get('propiedad')yread(). - $state->groups() → Habilita/deshabilita groups en tiempo de ejecución:
enable('NOMBRE'),disable('NOMBRE'),disableAll(). - $state->id() → Obtiene el identificador único de la petición actual (útil para jobs).
Variables globales en memory
El sistema inyecta automáticamente estas variables en memory al inicio de cada petición:
- hefesto-localhost: host local para llamadas entre APIs.
- hefesto-pathcode: ruta absoluta al código desplegado de la API.
- hefesto-pathstorage: ruta al espacio de almacenamiento en disco.
- hefesto-org: dominio del virtual-host.
- hefesto-env: entorno (dev, pro, etc.).
- hefesto-api: key de la API actual.