O que é Eloquent e como você usa modelos?

Question

Accepted Answer

**Eloquent** é o ORM (Object-Relational Mapper) do Laravel — ele usa o padrão **Active Record**, onde cada tabela do banco de dados tem uma classe **Model** correspondente, e as instâncias de modelo representam linhas. Ele fornece uma forma elegante e expressiva de consultar e manipular o banco de dados sem escrever SQL.

## Definindo um 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
```

Um modelo estende `Model` e mapeia para uma tabela por convenção de nomenclatura (`User` → `users`). A lista `$fillable` controla quais campos podem ser atribuídos em massa (um recurso de segurança).

## Operações 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);
```

A API fluente e encadeável do Eloquent lê quase como inglês e gera o SQL para você — sem consultas brutas para operações comuns.

## Consultando com o construtor fluente

```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();
```

## Modelos são mais do que dados

```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 que isso importa

Eloquent é central no Laravel — é como as aplicações interagem com o banco de dados, e seu design Active Record elegante é um dos recursos mais celebrados do framework, então dominá-lo é essencial para qualquer desenvolvimento com Laravel.

Entender como definir modelos (mapeando para tabelas por convenção), realizar operações CRUD e consultar com o construtor fluente e encadeável é conhecimento fundamental e do dia a dia, já que o acesso a dados é central para a maioria das aplicações.

A API expressiva e legível do Eloquent (`User::where(...)->orderBy(...)->get()`) permite que você trabalhe com o banco de dados em PHP limpo sem escrever SQL, melhorando dramaticamente a produtividade e a legibilidade.

Modelos também são mais do que contêineres de dados — eles definem **relacionamentos** (conectando tabelas relacionadas) e podem ter **accessors/mutators** (atributos computados) e lógica de negócio, tornando-os objetos de domínio ricos.

Saber sobre a proteção de atribuição em massa `$fillable` (uma consideração de segurança) também é importante.

Como o Eloquent é como as aplicações Laravel leem e escrevem seus dados — e aparece em praticamente todas as aplicações Laravel — dominar modelos e a API de consulta do Eloquent é material fundamental e obrigatório que sustenta o desenvolvimento eficaz com Laravel.