Tu aplicación Laravel salió limpia hace cuatro años. Hoy cualquier funcionalidad toca tres archivos que no deberían tener nada que ver, la suite de tests tarda nueve minutos y la actualización de la versión 9 a la 11 lleva dos trimestres parada como pull request en borrador. El framework no te traicionó. El equipo escribió una app de Laravel - no una aplicación que usa Laravel.Este libro te enseña a escribir la segunda.PHP Desacoplado en la Práctica combina la arquitectura hexagonal (los Ports and Adapters de Cockburn) con la Clean Architecture (los cuatro anillos de Martin) en una sola síntesis pragmática, pensada para PHP 8.3+. Sin patrones de Java calcados a PHP. Sin guerras de religión sobre cuál de las dos gana. Las dos arquitecturas, las dos honestas sobre lo que hacen bien, y las dos aplicadas a bases de código reales de Laravel 11 y Symfony 7.A lo largo de 30 capítulos vas a: Modelar un Domain en PHP puro, sin imports del framework y sin heredar de Eloquent.Definir Ports en el lenguaje del negocio, no en el de la base de datos.Ejecutar el mismo Use Case detrás de tres Inbound Adapters (HTTP, CLI, worker de cola) y tres Outbound Adapters (Doctrine, Guzzle, AMQP).Imponer la Dependency Rule con Deptrac, para que la arquitectura la vigile CI y no el cansancio del code review.Resolver transacciones, errores, Domain Events, observabilidad y autorización a través de Ports, para que el framework pueda moverse sin que la aplicación se entere.Migrar un servicio legacy de Laravel y otro de Symfony a esa misma forma, en producción, un endpoint cada vez. Sin semana de congelación.Para quién esSabes PHP y ya has puesto un servicio en producción con Laravel o con Symfony, y lo has visto pudrirse. Con lo que peleas no es con la sintaxis: es con dónde va cada cosa, con cómo testear un controller sin levantar medio mundo y con por qué una funcionalidad pequeña acaba tocando quince archivos. Aquí no se enseña PHP: se enseña a colocarlo.El repositorio complementario público trae una aplicación de referencia completa y dockerizada que ejercita de punta a punta todos los patrones del libro: github.com/gabrielanhaia/php-clean-hexagonal-examples. Clónala, ejecútala y léela junto al texto.La arquitectura es un medio, no un fin. El objetivo no es un hexágono perfecto: es una aplicación que dentro de seis meses todavía puedas entender y cambiar sin miedo - y que sobreviva a la próxima versión mayor del framework.Del autor de Arquitectura Hexagonal en Go: Ports, Adapters y Servicios que Perduran.
