4. Transformación de Datos con JsonResource: Ocultar Secretos y Dar Formato
Desacopla la estructura de tu base de datos del contrato JSON público utilizando clases JsonResource para ocultar hashes y formatear fechas.
¿Por qué NUNCA se debe retornar el modelo Eloquent directo?
Hacer return response()->json($usuario); directamente desde un controlador es un antipatrón peligroso conocido como fuga de esquema (Schema Leak).
Provoca graves problemas de seguridad y mantenibilidad:
- Riesgo de Seguridad: Si olvidas agregar una columna a la propiedad
$hiddendel modelo, podrías exponer contraseñas hasheadas, tokens de dos factores (2FA) o datos privados de los clientes. - Acoplamiento Tóxico: Si renombras una columna en la base de datos (por ejemplo
first_nameaprimer_nombre), romperás inmediatamente todas las aplicaciones frontend y móviles que consumen el JSON con el nombre antiguo.
La capa JsonResource actúa como un adaptador que transforma el modelo interno en el contrato JSON externo.
Creación de un API Resource con Artisan
Para generar un recurso de transformación se utiliza:
php artisan make:resource ProductoResource
Dentro del método toArray($request) defines con total libertad qué atributos se envían, cómo se formatean las fechas y qué nombres tendrán las claves JSON.
⚡ Clase ProductoResource con Formateo y Conversión de Atributos
Ejemplo de clase JsonResource para transformar un modelo Producto antes de emitir el JSON:
<?php
namespace App\Http\Resources;
use Illuminate\Http\Request;
use Illuminate\Http\Resources\Json\JsonResource;
class ProductoResource extends JsonResource
{
/**
* Transforma el recurso en un array serializable a JSON.
*
* @return array<string, mixed>
*/
public function toArray(Request $request): array
{
return [
'id' => $this->id,
'nombre' => $this->nombre,
'slug' => $this->slug,
'precio' => (float)$this->precio,
'precio_fmt' => '$ ' . number_format((float)$this->precio, 2, ',', '.'),
'disponible' => $this->stock > 0,
'stock' => (int)$this->stock,
'fecha_creado'=> $this->created_at?->toIso8601String(),
];
}
}
// En el controlador:
// return new ProductoResource($producto);
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Cuál es el beneficio primordial de utilizar Eloquent API Resources en lugar de serializar el modelo directamente con response()->json($modelo)?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar APIs RESTful con Laravel, Resources & Sanctum y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.