Mikä on Eloquent ja kuinka käytät malleja?

Question

Accepted Answer

**Eloquent** on Laravelin ORM (Object-Relational Mapper) — se käyttää **Active Record** -mallia, jossa jokaisella tietokantataaulukolla on vastaava **Model** -luokka ja mallin ilmentymät edustavat rivejä. Se tarjoaa elegantin ja ilmaisevan tavan hakea ja käsitellä tietokantaa ilman SQL:n kirjoittamista.

## Mallin määrittäminen

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

Malli laajentaa `Model`-luokkaa ja yhdistetään taulukkoon nimeämiskäytännön mukaan (`User` → `users`). `$fillable`-luettelo ohjaa, mitä kenttiä voidaan joukkoon liittää (turvaominaisuus).

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

Eloquentin sujuva, ketjutettava API luetaan lähes kuten englanti ja luo SQL:n puolestasi — ei raa'ita kyselyjä tavallisiin toimintoihin.

## Kyseleminen sujuvalla rakentajalla

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

## Mallit ovat enemmän kuin tietoja

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

## Miksi tämä on tärkeää

Eloquent on Laravelin ydin — se on tapa, jolla sovellukset ovat vuorovaikutuksessa tietokannan kanssa, ja sen tyylikäs Active Record -muotoilu on yksi frameworkin eniten juhlittuista ominaisuuksista, joten sen hallitseminen on välttämätöntä kaikelle Laravel-kehitykselle.

Ymmärtäminen siitä, kuinka määritellään mallit (yhdistäminen taulukoihin käytännön mukaan), suoritetaan CRUD-toiminnot ja haetaan sujuvalla, ketjutettavalla rakentajalla on jokapäiväinen, perustieto, sillä tietojen käyttö on useimpien sovellusten ydin.

Eloquentin ilmaisullinen, luettava API (`User::where(...)->orderBy(...)->get()`) antaa sinulle mahdollisuuden työskennellä tietokannan kanssa puhtaassa PHP:ssä ilman SQL:n kirjoittamista, mikä parantaa huomattavasti tuottavuutta ja luettavuutta.

Mallit ovat myös enemmän kuin vain tietokontainereita — ne määrittelevät **suhteet** (liittävät liittyvät taulukot) ja voivat sisältää **accessorit/mutaattorit** (lasketut attribuutit) ja liiketoimintalogiikkaa, jolloin niistä tulee rikkaat verkkotunnuskohteet.

Tietäminen `$fillable`-joukkoon liittämisen suojauksesta (turvanäkökohta) on myös tärkeää.

Koska Eloquent on tapa, jolla Laravel-sovellukset lukevat ja kirjoittavat tietoaan — ja se näkyy käytännössä kaikissa Laravel-sovelluksissa — mallien ja Eloquentin kyselyohjelmisto-ohjelmointirajapinnan hallitseminen on perusmateriaalin, pakollisen osaamisen, joka tukee tehokasta Laravel-kehitystä.