Tema 15 · Rendimiento & Caché

15. Optimización de Consultas API: Prevención del Problema N+1 y Caché con Redis

Acelera respuestas reduciendo milisegundos mediante precarga de relaciones con with(), selección de columnas clave y almacenamiento en caché con tags.

Milisegundos que Valen Oro en APIs

En una API RESTful, el tiempo de respuesta (TTFB) debe mantenerse por debajo de los 100 milisegundos. Dos factores determinan la velocidad de tus endpoints: la optimización de consultas SQL y la estrategia de almacenamiento en caché.

1. Eager Loading frente a Lazy Loading

El Lazy Loading (carga perezosa) ejecuta una consulta SQL cada vez que accedes a una propiedad relacionada. Al listar 50 productos con su categoría, ejecuta 1 consulta para los productos y 50 consultas individuales para las categorías (51 consultas en total).

Con Eager Loading (Producto::with('categoria:id,nombre')), Laravel ejecuta únicamente 2 consultas SQL optimizadas con la cláusula WHERE IN (...), reduciendo el tiempo de ejecución en más del 85%.

2. Caché en Memoria con Redis

Para endpoints de alta demanda pero datos que cambian con poca frecuencia (como el catálogo de productos o la lista de países), consultar la base de datos relacional en cada petición es un desperdicio. Utilizando Redis con la Facade Cache::remember() servimos la respuesta directamente desde la memoria RAM en 2 a 5 milisegundos.

⚡ Controlador Optimizado con Eager Loading Selectivo y Caché Redis

Patrón de alto rendimiento combinando with(), select() y Cache::remember():

ProductoOptimizadoController.php
Solo lectura
<?php

namespace App\Http\Controllers\Api\V1;

use App\Http\Controllers\Controller;
use App\Models\Producto;
use App\Http\Resources\ProductoResource;
use Illuminate\Http\Request;
use Illuminate\Http\JsonResponse;
use Illuminate\Support\Facades\Cache;

class ProductoOptimizadoController extends Controller
{
    /**
     * GET /api/v1/catalogo
     */
    public function index(Request $request): JsonResponse
    {
        $pagina = (int)$request->query('page', 1);
        $claveCache = "catalogo_productos_pag_{$pagina}";

        // Cachear el resultado durante 60 minutos en Redis
        $productos = Cache::remember($claveCache, now()->addMinutes(60), function () {
            return Producto::query()
                // 1. Seleccionar únicamente las columnas necesarias de la tabla principal
                ->select(['id', 'nombre', 'slug', 'precio', 'stock', 'categoria_id', 'created_at'])
                // 2. Eager Loading selectivo: solo id y nombre de la categoría
                ->with(['categoria' => function ($q) {
                    $q->select(['id', 'nombre']);
                }])
                ->where('activo', true)
                ->latest()
                ->paginate(20);
        });

        return response()->json(ProductoResource::collection($productos));
    }
}
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Cuál es el propósito de utilizar el método with() de Eloquent antes de paginar registros que serán transformados por un API Resource?
🦉
¿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.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.