Apa itu query builder dan bagaimana hubungannya dengan Eloquent?

Question

Accepted Answer

**Query Builder** Laravel adalah antarmuka yang lancar dan dapat dirantai untuk membangun dan menjalankan kueri database tanpa menulis SQL mentah. **Eloquent dibangun di atas Query Builder** — model Eloquent menggunakannya di belakang layar, dan kueri Eloquent dapat menggunakan semua metode Query Builder.

## Query Builder (tingkat database, melalui facade DB)

```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 bekerja langsung dengan tabel (mengembalikan objek polos, bukan model Eloquent). Dapat dirantai dan **secara otomatis menggunakan parameter binding** — mencegah SQL injection.

## Eloquent menggunakan metode fluent yang sama

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

Saat Anda merantai metode pada model Eloquent, Anda menggunakan Query Builder di belakangnya — tetapi Anda mendapatkan kembali **model** (dengan relasi, accessor, dan metode) bukan objek polos.

## Kueri lanjutan (keduanya mendukung ini)

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

Keduanya mendukung join, aggregate, subquery, dan kondisi kompleks.

## Kapan menggunakan yang mana

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

## Mengapa ini penting

Memahami Query Builder dan hubungannya dengan Eloquent penting untuk bekerja secara efektif dengan database di Laravel dan memilih alat yang tepat untuk setiap situasi.

Wawasan kuncinya adalah bahwa **Eloquent dibangun di atas Query Builder** — jadi metode fluent yang dapat dirantai yang Anda gunakan pada model Eloquent (`where`, `orderBy`, `join`, dll.) adalah milik Query Builder, yang berarti mempelajari satu mengajari Anda keduanya.

Query Builder menyediakan cara yang bersih dan aman dari SQL injection (melalui parameter binding otomatis) untuk membangun kueri tanpa menulis SQL mentah, dan Eloquent melapisi fungsionalitas model (relasi, accessor, metode) di atasnya.

Mengetahui **kapan menggunakan yang mana** adalah keterampilan praktis: **Eloquent** untuk sebagian besar logika aplikasi (Anda mendapatkan objek model kaya dengan relasi dan perilaku), dan **Query Builder langsung** (`DB::table`) untuk kueri ringan tanpa overhead model, pelaporan kompleks/aggregasi, atau saat Anda tidak memerlukan model penuh — yang dapat lebih efisien untuk kasus tertentu.

Keduanya menangani kueri kompleks (join, aggregate, subquery) dengan aman dengan API fluent yang sama.

Memahami Query Builder, bagaimana Eloquent dibangun di atasnya, parameter binding aman bersama (mencegah SQL injection), dan pilihan di antara keduanya adalah pengetahuan penting untuk menulis kode database yang efisien dan aman di Laravel, karena akses database adalah pusat sebagian besar aplikasi dan memilih tingkat yang sesuai (Eloquent kaya model versus Query Builder ringan) mempengaruhi kejelasan dan kinerja.