Lemonade Framework

Application framework modular para PHP 8.1+.

Arquitectura explícita para sitios web, sistemas de administración, proyectos CMS y aplicaciones de integración. Lemonade se basa en runtime PSR, container DI, providers, routing y CLI. Añade infraestructura para bases de datos, migraciones, caché, localización, validación, colas, API y seguridad.

Runtime basado en PSRBootstrap compartido para web y CLIBase de componentes
bootstrap/app.php
$router->getNamed('home.index', '/', HomeController::class . '@index');
Flujo de ejecución
SolicitudKernelProveedoresRouterControladorRespuesta
Presentación del framework

Lo que incluye Lemonade

Capacidades principales

Para aplicaciones PHP que necesitan estructura sin complejidad innecesaria

Runtime basado en PSR

HTTP messages, middleware, factories, logging, integración del cliente HTTP y DI container respetan los contratos PSR donde tiene sentido.

Bootstrap compartido para web y CLI

Web requests y comandos CLI comparten la misma configuración, modelo provider y container, con entrypoints separados Kernel y CliKernel.

Base de componentes

Routing, views, capa de base de datos, sessions, validación, uploads, security, events, queues y documentación están organizados como componentes explícitos del framework.

Documentación

Explora Lemonade

Elige el área en la que estás trabajando y accede directamente a la guía o referencia técnica correspondiente.

Guía

Primeros pasos

De la configuración y la primera ruta a una página funcional.

Documentación
Guía

Controllers y respuestas

Qué ofrece `AbstractController` y cuándo conviene añadir una capa común de aplicación.

Documentación
Guía

Routing

Rutas con nombre, parámetros y localización solo donde la estrategia de URL realmente los necesita.

Documentación
Guía

Middleware

Usa middleware para reglas HTTP compartidas, asígnalo a rutas o grupos y mantén fuera la lógica de negocio.

Documentación
Guía

Views y layouts

Cómo encajan el layout, el page view, los datos compartidos y los partials.

Documentación
Guía

Servicios y providers

Registro de servicios, bindings de interfaces y composición explícita de la aplicación.

Documentación
Guía

Configuración y entorno

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

Documentación
Guía

Producción y despliegue

Prepara los valores de entorno, deja que Lemonade use su config cache de producción y despliega solo los artefactos que el runtime necesita.

Documentación
Guía

Formularios y flujo POST

El flujo habitual desde un formulario GET, pasando por POST, CSRF y validación, hasta el redirect y el GET posterior.

Documentación
Guía

Validación

Esquema de validación, comprobación única de la entrada y lógica reutilizable en un servicio dedicado.

Documentación
Guía

Migraciones de base de datos

Mantén los cambios del esquema de la base de datos claros, ordenados y registrados con el sistema de migraciones integrado.

Documentación
Guía

API

Endpoints mediante providers de API, un contrato JSON claro y reglas de acceso en `Api.yaml`.

Documentación
Guía

CLI

Comandos, registro en YAML y transferencia de trabajos largos a la cola.

Documentación
Guía

Infraestructura

Cache, sesiones, uploads, filesystem y cliente HTTP sin acoplar la aplicación a internals del framework.

Documentación
Guía

Errores y depuración

Páginas de error, tests del kernel y diagnóstico mediante logs y comandos QA.

Documentación
Guía

Eventos y cola

Eventos dentro de un proceso, mensajes en cola y workers CLI.

Documentación
Guía

Discovery

Activa `robots.txt` y `sitemap.xml` solo cuando la aplicación realmente los necesite.

Documentación
Guía

Componentes

Registry de componentes para metadata, breadcrumbs, pagination y componentes propios.

Documentación
Referencia

Referencia

Notas de más bajo nivel sobre el ciclo de vida de la aplicación y el container.

Documentación