Eloquent nedir ve modelleri nasıl kullanırsınız?

Question

Accepted Answer

**Eloquent**, Laravel'in ORM'sidir (Object-Relational Mapper) — **Active Record** desenini kullanır; burada her veritabanı tablosunun karşılık gelen bir **Model** sınıfı vardır ve model örnekleri satırları temsil eder. Veritabanını sorgulamak ve değiştirmek için SQL yazmadan zarif ve ifadeli bir yol sağlar.

## Bir modeli tanımlama

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

Bir model `Model` sınıfını genişletir ve adlandırma kuralına göre tabloya eşlenir (`User` → `users`). `$fillable` listesi hangi alanların toplu atanabileceğini kontrol eder (bir güvenlik özelliği).

## CRUD işlemleri (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'in akıcı, zincirleme API'si neredeyse İngilizcemiş gibi okunur ve SQL'i sizin yerinize oluşturur — yaygın işlemler için ham sorgu yazmanıza gerek yoktur.

## Akıcı builder ile sorgulama

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

## Modeller sadece veri değildir

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

## Neden önemli

Eloquent, Laravel'in merkezinde yer alır — uygulamalar veritabanı ile bu şekilde etkileşim kurar ve zarif Active Record tasarımı çerçevenin en takdir edilen özelliklerinden biri olduğu için, bunu öğrenmek herhangi bir Laravel geliştirmesi için gereklidir.

Modelleri nasıl tanımlayacağınızı (kural ile tablolara eşlemeyi), CRUD işlemlerini gerçekleştirmeyi ve akıcı, zincirleme builder ile sorgu yapmayı anlamak günlük, temel bilgisidir; çünkü veri erişimi çoğu uygulamanın çekirdeğidir.

Eloquent'in ifadeli, okunabilir API'si (`User::where(...)->orderBy(...)->get()`) veritabanı ile SQL yazmadan temiz PHP'de çalışmanıza izin verir ve üretkenliği ile okunabilirliği dramatik olarak artırır.

Modeller ayrıca sadece veri kapsayıcıları değildir — **ilişkiler** tanımlarlar (ilişkili tabloları bağlarlar) ve **erişimci/değiştirici** (hesaplanan öznitelikler) ve iş mantığına sahip olabilirler; bu onları zengin etki alanı nesneleri yapar.

`$fillable` toplu atama korumasını (bir güvenlik hususu) bilmek de önemlidir.

Eloquent, Laravel uygulamalarının verilerini nasıl okuyup yazdığı olduğundan — ve neredeyse her Laravel uygulaması boyunca görüldüğünden — modelleri ve Eloquent'in sorgu API'sini öğrenmek, etkili Laravel geliştirmesinin temelini oluşturan, bilinmesi gereken temel bilgidir.