Eloquent ni nini na unatumiaje models?

Question

Accepted Answer

**Eloquent** ni ORM (Object-Relational Mapper) ya Laravel — inatumia mtindo wa **Active Record**, ambapo kila table ya database ina class ya **Model** inayolingana, na instances za model huwakilisha rows. Inatoa njia nadhifu na ya kueleweka ya kuhoji na kushughulikia database bila kuandika SQL.

## Kubainisha model

```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 hu-extend `Model` na hulingana na table kwa kanuni ya kutaja (`User` → `users`). Orodha ya `$fillable` hudhibiti ni fields zipi zinazoweza kuwekewa mass-assignment (kipengele cha usalama).

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

API ya Eloquent inayotiririka na inayoweza kuunganishwa (chainable) inasomeka karibu kama Kiingereza na huzalisha SQL kwa niaba yako — hakuna queries ghafi kwa operesheni za kawaida.

## Kuhoji kwa builder inayotiririka

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

## Models ni zaidi ya data

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

## Kwa nini ni muhimu

Eloquent ni kiini cha Laravel — ndiyo namna programu zinavyoshirikiana na database, na muundo wake nadhifu wa Active Record ni mojawapo ya vipengele vinavyosifiwa zaidi vya framework, hivyo kuimudu ni muhimu kwa ukuzaji wowote wa Laravel.

Kuelewa jinsi ya kubainisha models (kulingana na tables kwa kanuni), kutekeleza operesheni za CRUD, na kuhoji kwa builder inayotiririka na inayoweza kuunganishwa ni maarifa ya kila siku na ya msingi kwa sababu ufikiaji wa data ni kiini cha programu nyingi.

API ya Eloquent ya kueleweka na inayosomeka (`User::where(...)->orderBy(...)->get()`) inakuruhusu kufanya kazi na database katika PHP safi bila kuandika SQL, na kuboresha kwa kiasi kikubwa tija na usomekaji.

Models pia ni zaidi ya vyombo vya data — hubainisha **relationships** (kuunganisha tables zinazohusiana) na zinaweza kuwa na **accessors/mutators** (computed attributes) na mantiki ya biashara, na kuzifanya kuwa vitu tajiri vya domain.

Kujua ulinzi wa mass-assignment wa `$fillable` (jambo la usalama) pia ni muhimu.

Kwa kuwa Eloquent ndiyo namna programu za Laravel zinavyosoma na kuandika data zao — na inajitokeza karibu katika kila programu ya Laravel — kuimudu models na API ya query ya Eloquent ni nyenzo ya msingi na ya lazima kujua inayotegemeza ukuzaji bora wa Laravel.