Query Builder nedir ve Eloquent ile ilişkisi nedir?

Question

Accepted Answer

Laravel'in **Query Builder**, ham SQL yazmadan veritabanı sorgularını oluşturmak ve çalıştırmak için akıcı, zincirlenebilir bir arabirimdir. **Eloquent, Query Builder'ın üzerine inşa edilmiştir** — Eloquent modelleri arka planda bunu kullanır ve Eloquent sorguları tüm Query Builder yöntemlerini kullanabilir.

## Query Builder (veritabanı seviyesi, DB facade üzerinden)

```php
use Illuminate\Support\Facades\DB;

DB::table('users')
    ->where('active', true)
    ->where('age', '>', 18)
    ->orderBy('name')
    ->limit(10)
    ->get();                          // returns generic objects (not models)

DB::table('users')->where('id', 1)->update(['name' => 'X']);
DB::table('users')->insert(['name' => 'Ann']);
```

Query Builder doğrudan tablolarla çalışır (Eloquent modelleri değil, düz nesneler döndürür). Zincirlenebilir ve **otomatik olarak parametre bağlama kullanır** — SQL enjeksiyonunu önler.

## Eloquent aynı akıcı yöntemleri kullanır

```php
// Eloquent queries support ALL Query Builder methods (it's built on top)
User::where('active', true)
    ->where('age', '>', 18)
    ->orderBy('name')
    ->get();                          // returns User MODELS (with relationships, etc.)
```

Eloquent modeli üzerinde yöntemleri zincirlendiğinde, arka planda Query Builder'ı kullanıyorsunuz — ancak düz nesneler yerine **modeller** (ilişkiler, erişimciler ve yöntemlerle) geri alırsınız.

## Gelişmiş sorgular (her ikisi de bunları destekler)

```php
DB::table('orders')
    ->join('users', 'orders.user_id', '=', 'users.id')   // joins
    ->select('orders.*', 'users.name')
    ->where('orders.total', '>', 100)
    ->groupBy('users.id')
    ->havingRaw('SUM(orders.total) > 1000')
    ->get();

User::where('role', 'admin')
    ->orWhere('role', 'editor')
    ->whereIn('status', ['active', 'pending'])
    ->get();
```

Her ikisi de join, toplamlar, alt sorgular ve karmaşık koşulları destekler.

## Hangisini ne zaman kullanmalı

```text
Eloquent (Model::...) → the default — get models with relationships/accessors/methods.
                        Best for most application logic.
Query Builder (DB::table) → when you want lightweight queries without model overhead,
                            complex reporting/aggregations, or to avoid loading models.
```

## Neden önemli

Query Builder'ı ve Eloquent ile olan ilişkisini anlamak, Laravel'de veritabanlarıyla etkili bir şekilde çalışmak ve her durum için doğru aracı seçmek için önemlidir.

Ana fikir şu ki **Eloquent, Query Builder'ın üzerine inşa edilmiştir** — bu nedenle Eloquent modelleri üzerinde kullandığınız akıcı, zincirlenebilir yöntemler (`where`, `orderBy`, `join`, vb.) Query Builder'ınkidir, yani birini öğrenmek her ikisini de öğretir.

Query Builder, ham SQL yazmadan sorguları oluşturmak için temiz, SQL-enjeksiyondan güvenli (otomatik parametre bağlama aracılığıyla) bir yol sağlar ve Eloquent bunun üzerine model işlevselliğini (ilişkiler, erişimciler, yöntemler) katmanlar.

**Hangisini kullanmalı olduğunu bilmek** pratik beceridir: çoğu uygulama mantığı için **Eloquent** (ilişkiler ve davranışlarla zengin model nesneleri elde edersiniz) ve hafif sorgular, karmaşık raporlama/toplamalar veya tam modellere ihtiyaç duymadığınızda doğrudan **Query Builder** (`DB::table`) — belirli durumlar için daha verimli olabilir.

Her ikisi de karmaşık sorguları (join, toplamlar, alt sorgular) aynı akıcı API ile güvenli bir şekilde işler.

Query Builder'ı, Eloquent'in bunu nasıl oluşturduğunu, paylaşılan güvenli parametre bağlamayı (SQL enjeksiyonunu önleyen), aralarındaki seçimi anlamak, Laravel'de verimli ve güvenli veritabanı kodu yazmak için önemlidir, çünkü veritabanı erişimi çoğu uygulamanın merkezinde yer alır ve uygun seviyeyi seçmek (model açısından zengin Eloquent vs hafif Query Builder) hem netliği hem de performansı etkiler.