Çfarë është Eloquent dhe si përdorni modelet?

Question

Accepted Answer

**Eloquent** është ORM-i (Object-Relational Mapper) i Laravel-it — ai përdor modelin **Active Record**, ku çdo tabelë e bazës së të dhënave ka një klasë përkatëse **Model**, dhe instancat e modelit përfaqësojnë rreshta. Ai ofron një mënyrë elegante dhe shprehëse për të kërkuar dhe manipuluar bazën e të dhënave pa shkruar SQL.

## Përcaktimi i një modeli

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

Një model zgjeron `Model` dhe shëndelet në një tabelë sipas konventes (User → users). Lista `$fillable` kontrollon cilat fusha mund të caktohen hap pas hapi (një veçori sigurie).

## Operacionet 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-ja e rrjedhës Eloquent, e zinxhirueshme, lexohet pothuajse si anglisht dhe gjeneron SQL-in për ju — pa pyetje të papërpunuara për operacione të zakonshme.

## Kërkimi me ndërtuesi i rrjedhës

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

## Modelet janë më shumë se të dhëna

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

## Pse ka rëndësi

Eloquent është qendror në Laravel — kjo është mënyra se si aplikacionet ndërveprojnë me bazën e të dhënave, dhe dizajni i tij i elegantë Active Record është një nga veçoritë më të shënuara të kornizës, kështu që zotërimi i tij është thelbësor për çdo zhvillim Laravel.

Përcaktimi se si përcaktohen modelet (shëndetimi në tabela sipas konventes), kryerja e operacioneve CRUD dhe kërkimi me ndërtuesi të rrjedhës, zinxhirueshëm është njohuri të përditshme, themelore pasi qasja në të dhëna është në zemrën e shumicës së aplikacioneve.

API-ja shprehëse, e lexueshme e Eloquent-it (`User::where(...)->orderBy(...)->get()`) ju lejon të punoni me bazën e të dhënave në PHP të pastër pa shkruar SQL, i cili përmirëson ndjeshëm produktivitetin dhe lexueshmërinë.

Modelet janë gjithashtu më shumë se kontejnerë të dhënash — ata përcaktojnë **marrëdhënie** (lidhjen e tabelave të ndërlidhura) dhe mund të kenë **aksesorë/mutatorë** (atribute të llogaritura) dhe logjikë biznesi, duke i bërë ato objekte të pasura të domenit.

Dije për `$fillable` mbrojtjen ndaj caktimit hap pas hapi (një konsideratë sigurie) është gjithashtu e rëndësishme.

Pasi Eloquent është mënyra se si aplikacionet Laravel lexojnë dhe shkruajnë të dhënat e tyre — dhe ai shfaqet në praktikisht çdo aplikacion Laravel — zotërimi i modeleve dhe API-t e kërkimit të Eloquent-it është material themelor, i detyrueshëm për të njohur që qëndron në themel të zhvillimit efektiv të Laravel-it.