Prefacio
Laravel se ha ido puliendo durante años de producción. Se ocupa del enrutado, la validación, el acceso a datos, la autenticación, las colas y las pruebas con un vocabulario coherente.
La trampa es pelearse con esas convenciones: envolver Eloquent en repositorios «por si acaso», sustituir los FormRequests por validación propia, abstraer el framework fuera del framework.
Este libro toma el camino opuesto: apóyate en los patrones de Laravel porque están probados. Controladores, FormRequests, DTOs, Resources, Facades —existen porque previenen errores, permiten pruebas y escalan de forma fiable.
Comprométete con las convenciones de Laravel y dejarás de discutir sobre los cimientos. Empezarás a publicar.
Lo aburrido escala. Lo ingenioso se descompone.
De qué trata este libro
Este libro muestra una forma práctica y repetible de construir APIs con Laravel que sean fáciles de extender, fáciles de probar y predecibles para quien las consume. Usa una API real en producción como ejemplo conductor y aplica una estructura consistente a la validación, la transformación, las respuestas y las capas de integración. El foco no está en abstracciones ingeniosas, sino en patrones fiables que escalan con los equipos y con los plazos.
Cómo está estructurado
El libro va de los cimientos a la implementación. Los primeros capítulos establecen la arquitectura central y los patrones de respuesta. Los capítulos centrales desarrollan la autenticación, los middlewares y las fronteras de integración. Los últimos cubren la fiabilidad: registro, manejo de errores, rendimiento y operación. Cada capítulo incluye código concreto que refleja el proyecto real, para que puedas mapear los conceptos a ficheros que funcionan.
Convenciones
Los ejemplos de código siguen las mismas convenciones que el repositorio: tipado estricto, tipos de retorno explícitos, FormRequests para la validación, Response Wrappers para la estructura del JSON y DTOs para el flujo de datos tipado. El término «Response Wrapper» se refiere a las clases de respuesta Responsable como ModelResponse, CollectionResponse, MessageResponse y ErrorResponse. Los ejemplos favorecen las facades de Laravel y los patrones de configuración de Laravel 13.
Algunos términos se quedan en inglés a propósito, porque es como se dicen en el oficio: endpoint, job, worker, middleware, token. Traducirlos haría el texto más difícil de leer, no más fácil.
Para quién es este libro
Está escrito para desarrolladores de Laravel que se manejan con HTTP, REST y programación orientada a objetos. No necesitas ser experto en Laravel, pero sí trabajar con el framework habitualmente.
Puedes seguirlo con un portátil, PHP 8.4, una base de datos y un editor. Los ejemplos vienen de APIs reales en producción, así que el enfoque es práctico de principio a fin.
Si has heredado APIs inconsistentes o has visto cómo se acumulaba la complejidad, este libro ofrece un camino claro y repetible. No promete perfección, pero aspira a la cordura.
Si trabajas en equipo, este enfoque mantiene los endpoints legibles, ayuda a que la gente nueva se incorpore rápido y evita que el conocimiento se marche por la puerta.
Si quieres publicar funcionalidades ya, este libro es para ti. Se centra en patrones que puedes repetir del primer endpoint al número cien sin repensar la arquitectura.