Por qué abandoné los Form Requests y API Resources de Laravel y abracé Data + Value Objects

Spoiler: no fue porque Laravel sea malo. Fue porque me volví exigente.
Durante muchos años fui 100% team Laravel nativo.
Usé Form Requests religiosamente para la validación. Usé API Resources para transformar respuestas. Defendí esas herramientas en proyectos, code reviews y discusiones técnicas. Y, siendo honesto, me sirvieron muy bien.
Pero conforme mis proyectos fueron creciendo — en complejidad, longevidad y responsabilidad — empecé a sentir que algo estaba… fuera de lugar.
Nada estaba exactamente mal. Pero todo estaba demasiado disperso.
Este post trata sobre:
- los dolores reales que sentí
- el proceso de cuestionar decisiones antiguas
- por qué migré a Spatie Laravel Data + Value Objects
- y las ventajas y desventajas que acepté conscientemente
Sin dogma. Sin hype. Solo ingeniería.
La incomodidad empezó pequeña (como siempre)
Todo empezó con esa sensación clásica:
“¿Dónde exactamente vive esta regla de negocio?”
Vamos con un ejemplo real:
class UserResource extends JsonResource { public function toArray($request) { return [ 'id' => $this->id, 'name' => $this->name, 'email' => $this->email, 'status' => $this->is_active ? 'active' : 'inactive', ]; }}Controller en el medio, models abajo, services en algún lugar.
¿Funciona? Funciona - muy bien en realidad.
Pero fíjate:
- La validación está en un lugar
- La transformación en otro
- El tipado… en ningún lugar
- La regla de conversión (
is_active→status) escondida en el Resource
Nada de esto se rompe. Pero todo esto fragmenta.
El problema no es Laravel, es el acoplamiento implícito
Lo que empezó a incomodarme fue darme cuenta de que:
- Los Form Requests validan, pero no representan datos
- Los API Resources transforman, pero no garantizan un contrato
- El formato real del dato solo existe… en tu cabeza
Y ahí empiezan los síntomas:
- Duplicación de reglas
- Tests más verbosos de lo que deberían
- Frontend dependiendo de “conocimiento tribal”
- Refactors que dan miedo
Fue ahí cuando empecé a mirar con más cariño los DTOs de verdad.
No se trata de arrays con PHPDoc.
Sino de Objetos.
Entra en escena: Spatie Laravel Data
Cuando empecé a usar Spatie Data, la diferencia fue inmediata.
use Spatie\LaravelData\Data;
class UserData extends Data{ public function __construct( public readonly string $name, public readonly string $email, public readonly bool $isActive, ) {}}Ahora:
- El formato
- La validación
- El contrato
¡viven juntos! Sin magia.
Adiós API Resources (con cariño)
Aquí fue donde más dolió emocionalmente 😅, los API Resources son geniales. Pero incentivan algo peligroso:
transformación tardía
Con Data Objects:
class UserData extends Data{ public function __construct( public readonly int $id, public readonly string $name, public readonly string $email, public readonly UserStatus $status, ) {}}La transformación ocurre antes.
El controller solo orquesta:
return UserData::from($user);Sin lógica escondida.
Sin ifs mágicos en el toArray().
Value Objects es el paso que completa el razonamiento
Fue imposible detenerme solo en Data.
Si ya estaba tipando todo… ¿por qué seguir usando string para cosas que no son strings? ¿Y si uso un Value Object para verificaciones importantes?
final class Email{ public function __construct(public readonly string $value) { if (! filter_var($value, FILTER_VALIDATE_EMAIL)) { throw new InvalidArgumentException('Invalid email'); } }}Ahora:
- Un e-mail siempre es válido
- No existe el estado inválido
- La regla no se repite
Eso es liberador.
¿Pero cuál fue el impacto real en el día a día?
Después de la migración, noté ganancias claras:
Ventajas
- Contratos explícitos
- Refactors mucho más seguros
- Menos tests defensivos
- Mejor integración con TypeScript
- El IDE trabajando a mi favor
Desventajas (sí, existen)
- Más clases
- Curva de aprendizaje para el equipo
- Código inicial un poco más verboso
- Menos "conveniencia" inmediata
- Overengineering (mucho, demasiado, ultra) para proyectos pequeños
Y estoy 100% OK con eso.
Prefiero:
claridad ahora que dolor después
No se trata de Spatie. Se trata de madurez
Este post no es un ataque a Laravel.
Es un reconocimiento de que:
- Las herramientas nativas resuelven el 80%
- Los proyectos grandes viven en el otro 20%
Spatie Data + Value Objects me dieron algo que no tenía:
confianza estructural
Hoy, cuando hago refactor, no rezo para que nada se rompa.
El compilador me avisa.
Y eso, después de años sufriendo con bugs silenciosos… no tiene precio.
¿Es una obligación?
Si estás cómodo con Form Requests y API Resources, genial. ¡Está todo bien!
Pero si empezaste a sentir esa incomodidad sutil… quizás sea hora de escucharla. A veces, cambiar duele un poco. Pero vale la pena.