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
idde tipo entero autoincremental. - Maneja automáticamente las columnas
created_atyupdated_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.
<?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¿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.