Esta edición se basa en Laravel 13 y PHP 8.4, y refleja la estructura moderna de aplicación introducida en las versiones recientes. Los ejemplos y convenciones se alinean con la base de código de la Webplo License API, incluidos los Response Wrappers, los FormRequests, los DTOs y la arquitectura basada en middlewares. El objetivo es una base estable que las ediciones futuras puedan ampliar sin cambiar el enfoque de fondo.
Este libro es una filosofía, no un catálogo de patrones
Aquí no encontrarás cuarenta diagramas de arquitectura. No encontrarás una abstracción a medida que «prepare tu código para el futuro».
Encontrarás:
- Una estructura de API simple y repetible
- Reglas claras para controladores, facades y validación
- Un enfoque pragmático de autenticación, autorización y versionado
- Una preferencia por borrar antes que por inventar
Este es el enfoque que uso cuando el objetivo no es impresionar a otros desarrolladores, sino publicar cada semana, incorporar gente rápido y mantener la complejidad bajo control.
Si buscas construir «la arquitectura perfecta», no la encontrarás aquí.
Pero si quieres publicar APIs que sobrevivan a la presión, a los plazos, a los giros de producto, a desarrolladores junior y a restricciones heredadas, estás en el sitio correcto.
La filosofía es esta: no esperes a que llegue la complejidad para introducir estructura, y no añadas complejidad que aún no ha llegado. Empieza con patrones simples y consistentes desde el primer día. Usa DTOs para tipar tus datos, Resources para transformarlos, Response Wrappers para que las respuestas sean predecibles, Facades para abstraer la lógica de los proveedores y FormRequests para validar. Son valores por defecto ligeros y sensatos que mantienen la estructura estable mientras la lógica de negocio evoluciona.
Qué vas a sacar de este libro
-
Reducir los debates de arquitectura en un 80 %. Decide una vez, aplica en todas partes. Se acabó el «¿deberíamos usar un repositorio aquí?» en cada endpoint.
-
Incorporar desarrolladores en días en lugar de semanas. Lee un endpoint y entiende todos. Ese es el objetivo.
-
Menos errores causados por la inconsistencia. Los patrones consistentes reducen la superficie donde se pueden esconder los fallos.
-
Añadir endpoints sin tocar cinco capas. Sigues un patrón, escribes la lógica de negocio y publicas.
Principios
Este libro sigue cuatro principios. No son opiniones: son lecciones de sistemas en producción que atienden miles de millones de peticiones, de equipos que publican a diario y de APIs que sobreviven al caos sin heroicidades.
-
La consistencia gana al ingenio. Cada endpoint sigue el mismo patrón: validación, estructura de respuesta y manejo de errores. Al principio parece aburrido, pero en realidad es libertad. Cuando la estructura es predecible, tu equipo puede centrarse en los problemas de negocio.
-
La disciplina es velocidad. Las restricciones no son cadenas, son aceleradores. Cuando acuerdas la estructura por adelantado, eliminas la fatiga de decisión y publicáis más rápido juntos.
-
Simple y consistente hoy escala mejor que ingenioso y a medida hoy. No empieces con microservicios, CQRS, event sourcing ni abstracciones pesadas salvo que de verdad las necesites. Empieza con patrones aburridos y predecibles. Cuando aparezcan restricciones reales, sabrás exactamente dónde añadir sofisticación.
-
Construye para publicar, no para impresionar. El objetivo es valor, no trofeos de arquitectura. Publica, mide el impacto, itera. Una API publicada va muy por delante de una API impecable atascada en preproducción.