Apakah itu query builder dan bagaimana ia berkaitan dengan Eloquent?

Question

Accepted Answer

**Query Builder** Laravel ialah antara muka yang fasih (fluent) dan boleh dirantai (chainable) untuk membina dan menjalankan query pangkalan data tanpa menulis SQL mentah. **Eloquent dibina di atas Query Builder** — model Eloquent menggunakannya di sebalik tabir, dan query Eloquent boleh menggunakan semua kaedah Query Builder.

## Query Builder (peringkat pangkalan data, 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 secara langsung dengan jadual (memulangkan objek biasa, bukan model Eloquent). Ia boleh dirantai dan **menggunakan parameter binding secara automatik** — mencegah SQL injection.

## Eloquent menggunakan kaedah fasih 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.)
```

Apabila anda merantai kaedah pada model Eloquent, anda menggunakan Query Builder di sebaliknya — tetapi anda mendapat **model** (dengan hubungan, accessor, dan kaedah) dan bukannya objek biasa.

## Query lanjutan (kedua-duanya menyokong 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();
```

Kedua-duanya menyokong join, agregat, subquery, dan syarat yang kompleks.

## Bila 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 ia penting

Memahami Query Builder dan hubungannya dengan Eloquent adalah penting untuk bekerja secara berkesan dengan pangkalan data dalam Laravel dan memilih alat yang sesuai untuk setiap situasi.

Wawasan utama ialah **Eloquent dibina di atas Query Builder** — jadi kaedah fasih dan boleh dirantai yang anda gunakan pada model Eloquent (`where`, `orderBy`, `join`, dan lain-lain) adalah milik Query Builder, bermakna belajar satu mengajar anda kedua-duanya.

Query Builder menyediakan cara yang bersih dan selamat daripada SQL injection (melalui parameter binding automatik) untuk membina query tanpa menulis SQL mentah, dan Eloquent melapisi fungsi model (hubungan, accessor, kaedah) di atasnya.

Mengetahui **bila menggunakan yang mana** ialah kemahiran praktikalnya: **Eloquent** untuk kebanyakan logik aplikasi (anda mendapat objek model yang kaya dengan hubungan dan tingkah laku), dan **Query Builder secara langsung** (`DB::table`) untuk query ringan tanpa overhead model, pelaporan/agregasi yang kompleks, atau apabila anda tidak memerlukan model penuh — yang boleh lebih cekap untuk kes tertentu.

Kedua-duanya mengendalikan query yang kompleks (join, agregat, subquery) dengan selamat menggunakan API fasih yang sama.

Memahami Query Builder, cara Eloquent dibina di atasnya, parameter binding selamat yang dikongsi (mencegah SQL injection), dan pilihan antara keduanya adalah pengetahuan penting untuk menulis kod pangkalan data yang cekap dan selamat dalam Laravel, kerana akses pangkalan data adalah pusat kepada kebanyakan aplikasi dan memilih tahap yang sesuai (Eloquent yang kaya model vs Query Builder yang ringan) mempengaruhi kedua-dua kejelasan dan prestasi.