Source code aplikasi, template web, dan ebook. Unduh dari akun setelah bayar. Lihat produk

Blog / Database / Laravel Query Builder vs Eloqu...
Database

Laravel Query Builder vs Eloquent ORM: Kapan Menggunakan Masing-Masing?

AD

Admin HijrahKreativa

Penulis

19 Oct 2026
10 min read
10 views

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:

  1. CRUD dan logika domain. Cast, enum, accessor, dan relasi membuat kode mudah dibaca.
  2. Butuh event. Observer untuk activity log, invalidasi cache, atau sinkronisasi pencarian hanya berjalan lewat model.
  3. Data untuk API Resource. whenLoaded, whenCounted, dan route model binding bekerja dengan model.
  4. 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 chunkById bila 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) di whereRaw, selectRaw, dan DB::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 Benchmark dan data realistis sebelum mengganti Eloquent dengan Query Builder.
  • Agregasikan di database (sum, count, groupBy), bukan di collection PHP.
  • Gunakan lazyById / chunkById untuk 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

Last Tested

Komponen Versi
Laravel 13.x
PHP 8.4
MySQL 8.4 LTS
Tanggal 19 Oktober 2026

Bagikan artikel:

Artikel lainnya