Bukan soal mana yang lebih baik, tetapi mana yang tepat untuk pekerjaannya. Panduan praktis memilih Eloquent, Query Builder, atau raw SQL, lengkap dengan contoh kasus nyata dan pengukuran.
Overview
Perdebatan "Eloquent lambat, pakai Query Builder saja" atau sebaliknya "selalu pakai Eloquent agar konsisten" sering berakhir dengan kode yang salah alat. Akibatnya:
- laporan penjualan bulanan memuat 200.000 model Eloquent ke memori dan kehabisan RAM,
- update massal lewat Query Builder melewati observer, sehingga activity log dan cache tidak terbarui,
- logika bisnis tersebar di query
DB::table()tanpa cast, sehingga status dibandingkan sebagai string mentah di banyak tempat.
Keduanya dibangun di atas lapisan yang sama: Eloquent memakai Query Builder di dalamnya. Perbedaannya ada pada apa yang Anda dapatkan setelah query dijalankan.
| Eloquent | Query Builder | Raw SQL | |
|---|---|---|---|
| Hasil | Objek model | stdClass / array |
stdClass |
| Relasi, cast, accessor | Ya | Tidak | Tidak |
| Event & observer | Ya (per model) | Tidak | Tidak |
| Mass assignment protection | Ya | Tidak relevan | Tidak relevan |
| Overhead memori per baris | Lebih besar | Kecil | Kecil |
| Cocok untuk | Logika domain, CRUD, API | Laporan, agregasi, operasi massal | Fitur SQL khusus yang tidak didukung builder |
Hasil akhir: kerangka keputusan yang jelas, contoh query yang sama dalam kedua gaya, teknik menangani data besar, dan cara menggabungkan keduanya dengan aman.
Prerequisites
| Komponen | Versi |
|---|---|
| PHP | 8.3+ (disarankan 8.4) |
| Laravel | 13.x |
| Database | MySQL 8.0+ / PostgreSQL 15+ |
Skema toko online dari artikel Cara Merancang Database Laravel dari Requirement hingga ERD dan Migration.
Step-by-step Tutorial
Langkah 1: Query yang Sama dalam Tiga Gaya
Ambil 10 pesanan terakhir yang sudah dibayar, beserta nama pelanggannya.
Eloquent:
$orders = Order::with('customer:id,name')
->where('status', OrderStatus::Paid)
->latest('placed_at')
->take(10)
->get();
$orders->first()->status; // OrderStatus::Paid (enum, karena cast)
$orders->first()->placed_at; // Carbon
$orders->first()->customer->name;
Query Builder:
use Illuminate\Support\Facades\DB;
$orders = DB::table('orders')
->join('customers', 'customers.id', '=', 'orders.customer_id')
->where('orders.status', 'paid')
->orderByDesc('orders.placed_at')
->limit(10)
->get(['orders.id', 'orders.code', 'orders.total', 'orders.placed_at', 'customers.name as customer_name']);
$orders->first()->placed_at; // string "2026-10-18 09:12:00"
Raw SQL:
$orders = DB::select(
'select o.id, o.code, o.total, c.name as customer_name
from orders o join customers c on c.id = o.customer_id
where o.status = ? order by o.placed_at desc limit 10',
['paid'],
);
Lihat SQL yang dihasilkan sebuah query untuk memahami apa yang terjadi:
Order::where('status', 'paid')->latest('placed_at')->toRawSql();
// select * from `orders` where `status` = 'paid' order by `placed_at` desc
toRawSql() menampilkan SQL lengkap dengan nilai binding. Gunakan hanya untuk debugging, jangan untuk mengeksekusi query.
Langkah 2: Kapan Memilih Eloquent
Gunakan Eloquent ketika Anda bekerja dengan entitas bisnis:
- CRUD dan logika domain. Cast, enum, accessor, dan relasi membuat kode mudah dibaca.
- Butuh event. Observer untuk activity log, invalidasi cache, atau sinkronisasi pencarian hanya berjalan lewat model.
- Data untuk API Resource.
whenLoaded,whenCounted, dan route model binding bekerja dengan model. - Jumlah baris terkendali (hasil paginasi, satu entitas, puluhan sampai ratusan baris).
// Mengubah status pesanan: logika bisnis + event + cast
$order = Order::findOrFail($id);
$order->status = OrderStatus::Shipped;
$order->shipped_at = now();
$order->save(); // memicu observer: activity log, notifikasi ke pelanggan
Langkah 3: Kapan Memilih Query Builder
Gunakan Query Builder ketika hasilnya bukan entitas, atau ketika volumenya besar:
a. Laporan dan agregasi. Hasilnya baris ringkasan, bukan model.
// Laporan penjualan per hari per kategori (requirement R8)
$report = DB::table('order_items as oi')
->join('orders as o', 'o.id', '=', 'oi.order_id')
->join('category_product as cp', 'cp.product_id', '=', 'oi.product_id')
->join('categories as c', 'c.id', '=', 'cp.category_id')
->whereIn('o.status', ['paid', 'shipped', 'completed'])
->whereBetween('o.placed_at', [$from->startOfDay(), $to->endOfDay()])
->groupByRaw('DATE(o.placed_at), c.id, c.name')
->orderByRaw('DATE(o.placed_at)')
->selectRaw('DATE(o.placed_at) as tanggal, c.name as kategori')
->selectRaw('SUM(oi.quantity) as qty, SUM(oi.line_total) as omzet')
->get();
Catatan: produk yang punya dua kategori akan dihitung di kedua kategori. Ini wajar untuk laporan "per kategori", tetapi jangan menjumlahkan total semua kategori sebagai total omzet.
b. Operasi massal. Satu query untuk ribuan baris.
// Nonaktifkan produk yang stoknya 0 selama 90 hari
$affected = DB::table('products')
->where('stock', 0)
->where('updated_at', '<', now()->subDays(90))
->update(['is_active' => false, 'updated_at' => now()]);
c. Upsert dari sumber eksternal (misalnya sinkron stok dari gudang):
DB::table('products')->upsert(
$rows, // [['sku' => 'PRD-001', 'stock' => 12], ...]
uniqueBy: ['sku'],
update: ['stock'],
);
d. Insert dari hasil select, tanpa membawa data ke PHP:
DB::table('daily_sales')->insertUsing(
['date', 'orders_count', 'revenue'],
DB::table('orders')
->whereDate('placed_at', today()->subDay())
->where('status', 'completed')
->selectRaw('DATE(placed_at), COUNT(*), SUM(total)')
->groupByRaw('DATE(placed_at)'),
);
Penting: operasi massal ini tidak memicu event model. Jika ada observer yang harus berjalan (activity log, cache), pilih: jalankan logika tersebut secara eksplisit setelahnya, atau gunakan Eloquent per baris dengan
chunkByIdbila jumlahnya masih wajar.
Langkah 4: Ukur Sendiri, Jangan Menebak
Perbedaan performa nyata hampir selalu berasal dari jumlah baris yang dihidrasi menjadi model, bukan dari pembuatan SQL-nya. Ukur dengan Benchmark:
use Illuminate\Support\Benchmark;
Benchmark::dd([
'eloquent' => fn () => Order::where('status', 'completed')->get(),
'query builder' => fn () => DB::table('orders')->where('status', 'completed')->get(),
'eloquent toBase' => fn () => Order::where('status', 'completed')->toBase()->get(),
], iterations: 5);
Untuk mengukur memori:
$before = memory_get_usage();
$rows = Order::where('status', 'completed')->get();
dump(round((memory_get_usage() - $before) / 1024 / 1024, 2).' MB');
Angka pastinya bergantung pada jumlah kolom, cast, dan versi PHP, jadi jalankan di data Anda sendiri. Polanya konsisten: untuk puluhan ribu baris, model Eloquent memakai memori beberapa kali lipat dibanding stdClass, dan selisihnya bertambah seiring jumlah kolom dan cast. Untuk 20 baris hasil paginasi, perbedaannya tidak relevan.
Langkah 5: Menangani Data Besar (Keduanya Bisa)
Masalah memori lebih sering terjadi karena ->get() pada jutaan baris, bukan karena Eloquent itu sendiri. Laravel menyediakan cara memproses data bertahap:
| Method | Cara kerja | Kapan dipakai |
|---|---|---|
chunkById(1000, fn) |
Query per 1.000 baris berdasarkan ID | Memproses dan mengubah data |
lazyById(1000) |
Seperti chunkById, tetapi mengembalikan LazyCollection |
Iterasi dengan gaya collection |
cursor() |
Satu query, hidrasi satu per satu | Membaca saja; tidak mendukung eager loading |
// Ekspor CSV pesanan tahun ini tanpa kehabisan memori
$handle = fopen(storage_path('app/orders-2026.csv'), 'w');
Order::query()
->with('customer:id,name')
->whereYear('placed_at', 2026)
->lazyById(1000)
->each(function (Order $order) use ($handle) {
fputcsv($handle, [$order->code, $order->customer->name, $order->total, $order->placed_at]);
});
fclose($handle);
Gunakan chunkById / lazyById, bukan chunk(), bila Anda mengubah kolom yang dipakai untuk filter di dalam loop. chunk() berbasis offset dan bisa melewatkan baris saat data bergeser.
Langkah 6: Jalan Tengah, Eloquent tanpa Hidrasi
Anda bisa menulis query dengan relasi dan scope Eloquent, lalu mengambil hasilnya sebagai data mentah:
// Pakai scope Eloquent, hasil berupa stdClass
$rows = Order::query()
->paid() // local scope
->whereBelongsTo($customer)
->toBase()
->get(['id', 'code', 'total']);
// Ambil satu kolom atau pasangan key-value
$codes = Order::paid()->pluck('code');
$totals = Order::paid()->pluck('total', 'code'); // ['INV-001' => 250000, ...]
// Agregat langsung
$omzet = Order::paid()->whereMonth('placed_at', 10)->sum('total');
pluck, sum, count, exists, dan value tidak menghidrasi model sama sekali, jadi aman dipakai lewat Eloquent.
Langkah 7: Raw SQL dengan Aman
Kadang Anda membutuhkan fitur yang tidak dicakup builder, misalnya window function:
// Peringkat produk terlaris per kategori
$ranking = DB::select(<<<'SQL'
select * from (
select c.name as kategori, oi.product_name,
sum(oi.quantity) as terjual,
rank() over (partition by c.id order by sum(oi.quantity) desc) as peringkat
from order_items oi
join orders o on o.id = oi.order_id
join category_product cp on cp.product_id = oi.product_id
join categories c on c.id = cp.category_id
where o.status = ? and o.placed_at >= ?
group by c.id, c.name, oi.product_id, oi.product_name
) ranked
where peringkat <= 3
SQL, ['completed', now()->subMonth()]);
Aturan keamanan yang tidak bisa ditawar:
// SALAH: rawan SQL injection
DB::select("select * from orders where code = '{$request->code}'");
Order::whereRaw("status = '{$request->status}'")->get();
// BENAR: selalu gunakan binding
DB::select('select * from orders where code = ?', [$request->code]);
Order::whereRaw('status = ?', [$request->status])->get();
Untuk nama kolom dinamis (misalnya pengurutan dari input), binding tidak bisa dipakai. Gunakan daftar putih:
$sort = in_array($request->sort, ['placed_at', 'total', 'code'], true) ? $request->sort : 'placed_at';
$orders = Order::orderBy($sort, $request->boolean('asc') ? 'asc' : 'desc')->paginate();
Langkah 8: Tempatkan Query di Tempat yang Tepat
Agar pilihan alat tidak tersebar acak di controller, beri tempat yang jelas:
app/
├── Models/Order.php ← relasi, cast, scope (Eloquent)
├── Services/OrderService.php ← logika bisnis memakai Eloquent
└── Queries/
└── SalesReportQuery.php ← laporan memakai Query Builder
// app/Queries/SalesReportQuery.php
namespace App\Queries;
use Carbon\CarbonInterface;
use Illuminate\Support\Collection;
use Illuminate\Support\Facades\DB;
final class SalesReportQuery
{
public function dailyByCategory(CarbonInterface $from, CarbonInterface $to): Collection
{
return DB::table('order_items as oi')
->join('orders as o', 'o.id', '=', 'oi.order_id')
// ... query dari Langkah 3a
->get();
}
}
Controller cukup memanggil app(SalesReportQuery::class)->dailyByCategory($from, $to), dan query laporan bisa diuji secara terpisah.
Troubleshooting
| Error / Gejala | Penyebab | Solusi |
|---|---|---|
Allowed memory size exhausted |
->get() pada data sangat besar |
Gunakan lazyById, chunkById, atau agregasi di SQL |
| Observer / activity log tidak berjalan | Update lewat DB::table() atau Model::where()->update() |
Gunakan save() per model, atau jalankan logika observer secara eksplisit |
Column 'id' in field list is ambiguous |
Join tanpa prefiks tabel | Sebutkan tabel: orders.id, atau gunakan alias |
SQLSTATE[42000]: ... isn't in GROUP BY |
Mode ONLY_FULL_GROUP_BY MySQL |
Masukkan semua kolom non-agregat ke GROUP BY, atau agregasikan |
| Tanggal hasil Query Builder berupa string | Query Builder tidak melakukan cast | Gunakan Eloquent, atau Carbon::parse() saat menampilkan |
Data hilang saat chunk() sambil update |
Pagination offset bergeser | Ganti ke chunkById() |
cursor() tetap lambat dengan relasi |
cursor() tidak mendukung eager loading, sehingga N+1 |
Gunakan lazyById() yang mendukung with() |
whereRaw mengembalikan hasil aneh atau error sintaks |
Kutip manual dicampur binding | Gunakan placeholder ? dan array binding |
Best Practices
Keamanan
- Selalu gunakan binding (
?atau named binding) diwhereRaw,selectRaw, danDB::select. Jangan pernah menyisipkan input pengguna ke string SQL. - Gunakan daftar putih untuk nama kolom dan arah pengurutan dari input.
- Saat memakai Query Builder untuk insert/update, Anda kehilangan perlindungan
$fillable. Validasi dan pilih kolom secara eksplisit.
Performa
- Ukur dengan
Benchmarkdan data realistis sebelum mengganti Eloquent dengan Query Builder. - Agregasikan di database (
sum,count,groupBy), bukan di collection PHP. - Gunakan
lazyById/chunkByIduntuk data besar;cursor()hanya untuk baca tanpa relasi. - Periksa rencana eksekusi query laporan dengan
->explain().
Maintainability
- Default: Eloquent untuk entitas dan logika bisnis; Query Builder untuk laporan, agregasi, dan operasi massal.
- Kumpulkan query laporan di class khusus (
app/Queries), bukan di controller. - Bila memakai operasi massal yang melewati event, beri komentar dan dokumentasikan efek sampingnya.
- Manfaatkan scope Eloquent bersama
toBase()/pluck()agar aturan filter tetap di satu tempat.
Related Articles
- Mengatasi Masalah N+1 Query di Laravel Menggunakan Eager Loading
- Memahami Eloquent Relationships: One-to-One, One-to-Many, dan Many-to-Many dengan Studi Kasus
- Repository Pattern di Laravel: Kapan Dibutuhkan dan Kapan Justru Menambah Kompleksitas?
- Soft Delete, Audit Trail, dan Activity Log: Cara Melacak Perubahan Data Aplikasi
Last Tested
| Komponen | Versi |
|---|---|
| Laravel | 13.x |
| PHP | 8.4 |
| MySQL | 8.4 LTS |
| Tanggal | 19 Oktober 2026 |