Что такое Eloquent и как использовать модели?

Question

Accepted Answer

**Eloquent** — это ORM (Object-Relational Mapper) Laravel, который использует паттерн **Active Record**, где каждой таблице базы данных соответствует класс **Model**, а экземпляры модели представляют строки. Он предоставляет элегантный и выразительный способ запроса и манипуляции базой данных без написания SQL.

## Определение модели

```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
```

Модель расширяет `Model` и соответствует таблице по соглашению об именовании (`User` → `users`). Список `$fillable` контролирует, какие поля могут быть массово назначены (функция безопасности).

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

Fluent API Eloquent с цепочкой вызовов читается почти как английский язык и генерирует SQL за вас — без raw запросов для обычных операций.

## Запросы с fluent builder

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

## Модели — это больше чем данные

```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
```

## Почему это важно

Eloquent — это ядро Laravel — это то, как приложения взаимодействуют с базой данных, и его элегантный дизайн Active Record — одна из самых известных особенностей фреймворка, поэтому овладение им необходимо для любой разработки на Laravel.

Понимание того, как определять модели (соответствие таблицам по соглашению), выполнять CRUD операции и запрашивать с помощью fluent, цепочки builder — это повседневное, фундаментальное знание, так как доступ к данным является основой большинства приложений.

Выразительный и читаемый API Eloquent (`User::where(...)->orderBy(...)->get()`) позволяет работать с базой данных на чистом PHP без написания SQL, что значительно повышает производительность и читаемость.

Модели — это также больше, чем контейнеры данных — они определяют **отношения** (соединение связанных таблиц) и могут иметь **accessors/mutators** (вычисляемые атрибуты) и бизнес-логику, делая их богатыми объектами предметной области.

Знание защиты от массового назначения `$fillable` (соображение безопасности) также важно.

Поскольку Eloquent — это то, как приложения Laravel читают и записывают свои данные — и он появляется практически в каждом приложении Laravel — овладение моделями и query API Eloquent является фундаментальным, необходимым материалом, который лежит в основе эффективной разработки на Laravel.