Kaj je Eloquent in kako uporabljate modele?

Question

Accepted Answer

**Eloquent** je Laravelov ORM (Object-Relational Mapper) — uporablja vzorec **Active Record**, kjer ima vsaka tabela v bazi podatkov ustrezni razred **Model**, instance modelov pa predstavljajo vrstice. Zagotavlja eleganten in izrazit način poizvedovanja in manipuliranja baze podatkov brez pisanja SQL.

## Definiranje modela

```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 razširja `Model` in se preslika na tabelo po dogovoru imena (`User` → `users`). Seznam `$fillable` nadzira, katera polja je mogoče hromadno dodeliti (varnostna funkcija).

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

Fluidni, verižni API Eloquenta se bere skoraj kot angleščina in zgenera SQL za vas — brez surovih poizvedb za običajne operacije.

## Poizvedovanje s fluidnim graditeljem

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

## Modeli so več kot podatki

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

## Zakaj je to pomembno

Eloquent je osrednji del Laravela — to je način, kako aplikacije komunicirajo z bazo podatkov, in njegov eleganten Active Record dizajn je ena najbolj proslavljenih lastnosti ogrodja, zato je njihovo obvladovanje bistveno za vsak razvoj v Laravelu.

Razumevanje, kako definirate modele (preslikava tabel po dogovoru), izvajate operacije CRUD in poizvedujete s fluidnim, verizibilnim graditeljem, je vsakodnevno, temeljno znanje, saj je dostop do podatkov jedrnat za večino aplikacij.

Eloqentov izrazit, berljiv API (`User::where(...)->orderBy(...)->get()`) vam omogoči delo z bazo podatkov v čistem PHP-ju brez pisanja SQL, kar dramatično izboljša produktivnost in berljivost.

Modeli so tudi več kot vsebniki podatkov — definirajte **relacije** (povezovanje sorodnih tabel) in imajo lahko **dostopnike/muteatorje** (izračunani atributi) in poslovno logiko, kar jih naredi bogate domenske objekte.

Znanje zaščite hromaznega dodeljevanja `$fillable` (varnostna premislka) je prav tako pomembno.

Ker je Eloquent način, kako Laravelove aplikacije berejo in pišejo svoje podatke — in se pojavi v praktično vsaki Laravelovi aplikaciji — je obvladovanje modelov in Eloquentovega API-ja za poizvedovanje temeljni, neogibni material, ki je osnova učinkovitega razvoja v Laravelu.