¿Qué es Eloquent y cómo usas los modelos?

Question

Accepted Answer

**Eloquent** es el ORM (Object-Relational Mapper) de Laravel — utiliza el patrón **Active Record**, donde cada tabla de base de datos tiene una clase **Model** correspondiente, e instancias de modelo representan filas. Proporciona una forma elegante y expresiva de consultar y manipular la base de datos sin escribir SQL.

## Definir un modelo

```php
<?php
class User extends Model {
    // by convention, the User model maps to the "users" table automatically
    protected $fillable = ['name', 'email'];   // mass-assignable fields (security)
}
// generate with: php artisan make:model User
```

Un modelo extiende `Model` y se asigna a una tabla por convención de nombres (`User` → `users`). La lista `$fillable` controla qué campos se pueden asignar masivamente (una función de seguridad).

## Operaciones CRUD (Active Record)

```php
// CREATE
$user = User::create(['name' => 'Ann', 'email' => 'ann@x.com']);
$user = new User; $user->name = 'Bob'; $user->save();

// READ
User::all();                              // all rows
User::find(1);                            // by primary key
User::where('active', true)->get();        // query with conditions
User::where('email', $email)->first();     // first match

// UPDATE
$user->update(['name' => 'New Name']);
$user->name = 'X'; $user->save();

// DELETE
$user->delete();
User::destroy(1);
```

La API fluida y encadenable de Eloquent se lee casi como inglés y genera SQL para ti — sin consultas raw para operaciones comunes.

## Consultar con el constructor fluido

```php
User::where('age', '>', 18)
    ->where('active', true)
    ->orderBy('name')
    ->limit(10)
    ->get();                              // chainable query building

User::where('role', 'admin')->count();
User::where('email', $e)->exists();
```

## Los modelos son más que datos

```php
class Post extends Model {
    public function author() {                          // a relationship
        return $this->belongsTo(User::class);
    }
    public function getExcerptAttribute() {              // an accessor (computed attribute)
        return Str::limit($this->body, 100);
    }
}
$post->author;       // the related User
$post->excerpt;       // computed attribute
```

## Por qué es importante

Eloquent es central en Laravel — es cómo las aplicaciones interactúan con la base de datos, y su elegante diseño Active Record es una de las características más celebradas del framework, por lo que dominarlo es esencial para cualquier desarrollo en Laravel.

Entender cómo definir modelos (asignación a tablas por convención), realizar operaciones CRUD y consultar con el constructor fluido y encadenable es conocimiento fundamental y cotidiano, ya que el acceso a datos es el núcleo de la mayoría de aplicaciones.

La API expresiva y legible de Eloquent (`User::where(...)->orderBy(...)->get()`) te permite trabajar con la base de datos en PHP limpio sin escribir SQL, mejorando dramáticamente la productividad y la legibilidad.

Los modelos son también mucho más que simples contenedores de datos — definen **relaciones** (conectan tablas relacionadas) y pueden tener **accessors/mutators** (atributos calculados) y lógica empresarial, convirtiéndolos en objetos de dominio ricos.

Conocer la protección de asignación masiva `$fillable` (una consideración de seguridad) también es importante.

Puesto que Eloquent es la forma en que las aplicaciones Laravel leen y escriben sus datos — y aparece en prácticamente todas las aplicaciones Laravel — dominar modelos y la API de consultas de Eloquent es material fundamental e imprescindible que sustenta un desarrollo Laravel eficaz.