Kas yra Eloquent ir kaip naudojate modelius?

Question

Accepted Answer

**Eloquent** yra Laravel ORM (Object-Relational Mapper) — jis naudoja **Active Record** šabloną, kuriame kiekviena duomenų bazės lentelė turi atitinkamą **Model** klasę, o modelio egzemplioriai reiškia eilutes. Jis suteikia elegantišką, išraiškingą būdą užklausti ir manipuliuoti duomenų baze nerašant SQL.

## Modelio apibrėžimas

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

Modelis išplečia `Model` ir susieja su lentele pagal pavadinimo susitarimą (`User` → `users`). `$fillable` sąrašas kontroliuoja, kurie laukai gali būti masiškai priskirti (saugumo funkcija).

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

Eloquent's sklandus, keičiamas API skaitosi beveik kaip anglų kalba ir sukuria jums SQL — nėra žaliuzių užklausų paprastoms operacijoms.

## Užklausimas su 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();
```

## Modeliai yra daugiau nei duomenys

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

## Kodėl tai svarbu

Eloquent yra Laravel branduolys — tai yra kaip programos sąveikauja su duomenų baze, o jo elegantus Active Record dizainas yra vienas iš labiausiai pagerbamų sistemos bruožų, todėl jo įvaldymas yra būtinas bet kokiam Laravel kūrimui.

Supratimas, kaip apibrėžti modelius (susiejimas su lentelėmis pagal susitarimą), atlikti CRUD operacijas ir užklausti su sklandžiu, keičiamu builder yra kasdienės, pagrindinės žinios, nes duomenų prieiga yra dauguma programų esmė.

Eloquent's išraiškinga, skaitoma API (`User::where(...)->orderBy(...)->get()`) leidžia jums dirbti su duomenų baze švariame PHP be SQL rašymo, dramatiškai padidinant produktyvumą ir skaitomumą.

Modeliai taip pat yra daugiau nei duomenų konteineriai — jie apibrėžia **ryšius** (susijungiamos susijusios lentelės) ir gali turėti **prieigos rakus/mutatorius** (apskaičiuotus atributus) ir verslo logiką, padarydami juos turtingais domeno objektais.

`$fillable` masinio priskyrim apsaugos (saugumo svarstymas) žinojimas taip pat yra svarbus.

Kadangi Eloquent yra tai, kaip Laravel programos skaitosi ir rašo savo duomenis — ir pasirodo praktiškai visose Laravel programose — modelių ir Eloquent užklausų API įvaldymas yra pagrindinė, būtina medžiaga, kuri yra veiksmingo Laravel kūrimo pagrindas.