Tema 9 · Eloquent ORM

9. Eloquent ORM Esencial: Modelos, Consultas, Asignación Masiva ($fillable) y Scopes

Interactúa con MySQL utilizando objetos de PHP: métodos all(), find(), where(), create(), update(), delete() y protección contra Mass Assignment.

¿Qué es Eloquent ORM?

Eloquent es el mapeador objeto-relacional (ORM) incluido en Laravel. Sigue el patrón Active Record: cada tabla de tu base de datos tiene un Modelo correspondiente que se utiliza para interactuar con esa tabla.

php artisan make:model Curso

Por convención en Laravel:

  • El modelo en singular y PascalCase (ej: Curso) se mapea a la tabla plural y snake_case (ej: cursos).
  • La clave primaria se asume como id de tipo entero autoincremental.
  • Maneja automáticamente las columnas created_at y updated_at.

Asignación Masiva y Seguridad: $fillable vs $guarded

Cuando usas Curso::create($request->all()), Laravel te protege contra la vulnerabilidad de Mass Assignment (donde un atacante podría enviar campos inesperados en el formulario como is_admin = 1 o saldo = 99999).

En tu modelo debes definir explícitamente qué campos son editables masivamente con $fillable:

class Curso extends Model
{
    // Solo estos campos se pueden llenar con ::create() o ::update()
    protected $fillable = [
        'title',
        'slug',
        'summary',
        'description',
        'price_cop',
        'hours',
        'is_active',
    ];
}

Consultas Esenciales con Eloquent

Operación Sintaxis Eloquent Equivalente en SQL
Obtener todos Curso::all() SELECT * FROM cursos
Buscar por ID Curso::findOrFail($id) SELECT * FROM cursos WHERE id = ? (Lanza 404 si falla)
Filtrar con WHERE Curso::where('price_cop', '>', 0)->get() SELECT * FROM cursos WHERE price_cop > 0
Ordenar y Limitar Curso::orderBy('created_at', 'desc')->take(5)->get() SELECT * FROM cursos ORDER BY created_at DESC LIMIT 5
Insertar Curso::create([...]) INSERT INTO cursos (...) VALUES (...)
Actualizar $curso->update(['price_cop' => 420000]) UPDATE cursos SET price_cop = 420000 WHERE id = ?
Eliminar $curso->delete() DELETE FROM cursos WHERE id = ?

Local Scopes: Reutilización Elegante de Filtros

Los Local Scopes te permiten definir consultas comunes como métodos del modelo para mantener los controladores limpios y legibles:

// En el modelo Curso.php:
public function scopeActivos($query)
{
    return $query->where('is_active', true);
}

// En el controlador:
$cursosPublicos = Curso::activos()->orderBy('title')->get();

⚡ Modelo Eloquent con Fillable, Casts y Local Scopes

Estructura profesional de un modelo Eloquent en Laravel 11/12.

Curso.php
Solo lectura
<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Builder;

class Curso extends Model
{
    use HasFactory;

    // Tabla asociada (opcional si sigue la convención plural)
    protected $table = 'cursos';

    // Atributos asignables de forma masiva
    protected $fillable = [
        'instructor_id',
        'slug',
        'title',
        'summary',
        'description',
        'price_cop',
        'hours',
        'is_active',
    ];

    // Casteo automático de tipos primitivos
    protected $casts = [
        'price_cop' => 'integer',
        'hours'     => 'integer',
        'is_active' => 'boolean',
    ];

    /** Scope para filtrar solo cursos disponibles al público */
    public function scopeActivos(Builder $query): Builder
    {
        return $query->where('is_active', true);
    }

    /** Scope para filtrar cursos gratuitos */
    public function scopeGratis(Builder $query): Builder
    {
        return $query->where('price_cop', 0);
    }
}
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Para qué sirve la propiedad protegida $fillable en un modelo Eloquent de Laravel?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar Laravel Framework Profesional 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.