Relasi & masalah N+1

Satu-satunya masalah performa yang hampir pasti ada di setiap aplikasi Laravel yang belum diperiksa adalah N+1. Kabar baiknya, ia gampang dilihat dan gampang diperbaiki.

Bentuk relasi

class Produk extends Model
{
    public function kategori(): BelongsTo
    {
        return $this->belongsTo(Kategori::class);       // produk.kategori_id → kategori.id
    }

    public function ulasan(): HasMany
    {
        return $this->hasMany(Ulasan::class);
    }

    public function tag(): BelongsToMany
    {
        return $this->belongsToMany(Tag::class, 'produk_tag')
            ->withTimestamps();
    }

    public function gambarUtama(): HasOne
    {
        return $this->hasOne(Gambar::class)->latestOfMany();
    }
}

Masalah N+1, dilihat langsung

// Controller
$produk = Produk::latest()->take(50)->get();     // 1 query

@foreach ($produk as $p)
    <li>{{ $p->nama }} — {{ $p->kategori->nama }}</li>   {{-- 1 query PER BARIS --}}
@endforeach

Total: 51 query.

select * from produk order by created_at desc limit 50
select * from kategori where id = 3 limit 1
select * from kategori where id = 7 limit 1
select * from kategori where id = 3 limit 1     ← yang sama, lagi
… 47 baris berikutnya

Di laptop dengan database lokal, 51 query terasa "cukup cepat". Di produksi, dengan latensi jaringan 1–2 ms ke RDS, itu tambahan 50–100 ms yang bukan berasal dari kode apa pun yang bisa kamu lihat di halaman itu.

Obatnya

$produk = Produk::with('kategori')->latest()->take(50)->get();

Total: 2 query — berapa pun jumlah barisnya.

select * from produk order by created_at desc limit 50
select * from kategori where id in (3, 7, 12, 4, …)

// Bersarang dan berkondisi
Produk::with([
    'kategori',
    'ulasan' => fn ($q) => $q->where('disetujui', true)->latest()->limit(3),
    'ulasan.penulis:id,name',        // hanya kolom yang dipakai
])->get();

// Menghitung tanpa memuat isinya — satu subquery, bukan satu query per baris
Produk::withCount('ulasan')->get();          // $p->ulasan_count
Produk::withSum('items', 'jumlah')->get();   // $p->items_sum_jumlah
Produk::withExists('ulasan')->get();         // $p->ulasan_exists

Menjadikan N+1 sebagai error

// app/Providers/AppServiceProvider.php
public function boot(): void
{
    // Di lokal dan saat tes: mengakses relasi tanpa with() akan melempar exception.
    Model::preventLazyLoading(! $this->app->isProduction());

    // Sekalian: cegah mengisi kolom yang tidak ada di $fillable secara diam-diam
    Model::preventSilentlyDiscardingAttributes(! $this->app->isProduction());
}

Menyaring berdasarkan relasi

Produk::whereHas('ulasan', fn ($q) => $q->where('rating', 5))->get();
Produk::whereDoesntHave('ulasan')->get();
Produk::has('ulasan', '>=', 10)->get();

// Sering lebih murah untuk sekadar "ada atau tidak"
Produk::whereRelation('kategori', 'slug', 'minuman')->get();

Menyimpan lewat relasi

$produk->ulasan()->create(['isi' => 'Bagus', 'rating' => 5]);   // foreign key otomatis

$produk->tag()->attach([1, 2]);        // tambah
$produk->tag()->detach(1);             // lepas satu
$produk->tag()->sync([2, 3]);          // jadikan persis ini — sisanya dilepas
$produk->tag()->syncWithoutDetaching([4]);

Alur berburu N+1

1. Nyalakan Model::preventLazyLoading() di lokal.
2. Jalankan suite tes — kegagalan menunjuk langsung ke relasi dan berkasnya.
3. Tambahkan with() di query-nya, bukan di template.
4. Untuk hitungan, ganti dengan withCount().
5. Pasang Laravel Pulse atau Telescope (Fase 7) supaya query lambat tetap terlihat setelah rilis.