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

Blog / Performance, Caching & Scalability / Laravel Performance Optimizati...
Performance, Caching & Scalability

Laravel Performance Optimization: 20 Pemeriksaan untuk Menemukan Bottleneck Aplikasi

AD

Admin HijrahKreativa

Penulis

19 Oct 2026
13 min read
11 views

Daftar periksa sistematis untuk menemukan penyebab aplikasi Laravel lambat sebelum menambah server: mengukur dulu, lalu memeriksa konfigurasi framework, PHP, database, cache, queue, layanan eksternal, dan frontend. Dilengkapi command Artisan yang memeriksa sebagian besar poin secara otomatis.

Overview

Keluhan "aplikasinya lambat" hampir selalu disusul dengan usulan "upgrade VPS". Padahal penyebab paling sering justru hal yang tidak terselesaikan oleh CPU tambahan:

  • APP_DEBUG=true di production,
  • OPcache mati,
  • 300 query untuk satu halaman (N+1),
  • kolom tanpa index pada tabel yang sudah berisi ratusan ribu baris,
  • email dikirim langsung di dalam request,
  • panggilan API eksternal tanpa timeout.

Menambah server untuk masalah seperti ini hanya menunda gejala dengan biaya bulanan yang lebih besar.

Artikel ini memberikan 20 pemeriksaan yang diurutkan dari yang paling murah dan paling sering menjadi penyebab. Contoh kasusnya adalah aplikasi RW: halaman daftar iuran butuh 4 detik, dasbor 6 detik, dan server sering kehabisan worker PHP-FPM pada tanggal 1–10 setiap bulan saat warga ramai membayar.

Hasil akhir:

  • cara mengukur sebelum mengoptimasi,
  • 20 pemeriksaan dengan cara memeriksa dan memperbaikinya,
  • command php artisan performa:periksa yang memeriksa konfigurasi secara otomatis,
  • urutan kerja: ukur, temukan bottleneck terbesar, perbaiki, ukur ulang.

Prerequisites

Komponen Versi
PHP 8.3+ (disarankan 8.4) dengan OPcache
Laravel 13.x
MySQL 8.4
Redis 7.x
Alat ukur Laravel Telescope 5.x atau Debugbar (lokal/staging), Laravel Pulse 1.x (production)
Testing Pest 4

Step-by-step Tutorial

Langkah 0: Ukur Dulu

Optimasi tanpa data adalah menebak. Sebelum mengubah apa pun, catat angka dasar (baseline):

Metrik Alat Contoh baseline
Waktu respons p50 dan p95 per route Pulse, log Nginx ($request_time), APM /iuran p95 = 4,1 detik
Jumlah dan durasi query per request Telescope, Debugbar /iuran = 312 query, 2,8 detik di DB
Memori puncak per request Debugbar, memory_get_peak_usage() 96 MB
Request per detik sebelum error ApacheBench, k6 18 rps, lalu 502
Antrean dan job lambat Horizon, Pulse antrean default tertunda 7 menit

Tambahkan middleware ringan untuk mencatat request lambat di production:

// app/Http/Middleware/CatatRequestLambat.php
namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\{DB, Log};

class CatatRequestLambat
{
    public function handle(Request $request, Closure $next)
    {
        DB::enableQueryLog();

        return $next($request);
    }

    public function terminate(Request $request, $response): void
    {
        $durasiMs = (microtime(true) - LARAVEL_START) * 1000;

        if ($durasiMs >= config('performa.ambang_lambat_ms', 1000)) {
            $queries = DB::getQueryLog();

            Log::channel('performa')->warning('request.lambat', [
                'route'      => $request->route()?->getName() ?? $request->path(),
                'method'     => $request->method(),
                'durasi_ms'  => (int) $durasiMs,
                'query'      => count($queries),
                'query_ms'   => (int) array_sum(array_column($queries, 'time')),
                'memori_mb'  => round(memory_get_peak_usage(true) / 1048576, 1),
            ]);
        }

        DB::disableQueryLog();
        DB::flushQueryLog();
    }
}

Laravel juga menyediakan hook bawaan untuk mendeteksi request dan query lambat tanpa middleware tambahan:

// app/Providers/AppServiceProvider.php
use Illuminate\Contracts\Http\Kernel as HttpKernel;
use Illuminate\Database\Connection;
use Illuminate\Support\Facades\{DB, Log};

public function boot(): void
{
    // Total waktu query satu request melebihi 1 detik
    DB::whenQueryingForLongerThan(1000, function (Connection $connection, $event) {
        Log::channel('performa')->warning('db.total_lama', ['url' => request()?->fullUrl()]);
    });

    // Satu query tunggal di atas 300 ms
    DB::listen(function ($query) {
        if ($query->time > 300) {
            Log::channel('performa')->warning('db.query_lambat', ['sql' => $query->sql, 'ms' => $query->time]);
        }
    });

    // Siklus request di atas 2 detik
    app(HttpKernel::class)->whenRequestLifecycleIsLongerThan(2000, function ($startedAt, $request, $response) {
        Log::channel('performa')->warning('http.lambat', ['url' => $request->fullUrl()]);
    });
}

Fokus pada satu bottleneck terbesar dulu. Bila 2,8 dari 4,1 detik habis di database, mengoptimasi Blade tidak akan terasa.

Kelompok A: Konfigurasi Framework & PHP

Pemeriksaan 1: APP_DEBUG dan APP_ENV

APP_ENV=production
APP_DEBUG=false

APP_DEBUG=true memperlambat penanganan error dan membocorkan informasi. Ini sekaligus masalah keamanan.

Pemeriksaan 2: Cache konfigurasi, route, event, dan view

php artisan optimize      # config:cache, route:cache, event:cache, view:cache

Tanpa cache, Laravel membaca dan menggabungkan puluhan file konfigurasi di setiap request. Jalankan di setiap deploy. Akibat sampingnya: env() hanya boleh dipanggil di dalam file config/, karena setelah config:cache file .env tidak dibaca lagi.

Pemeriksaan 3: OPcache aktif dan cukup besar

; /etc/php/8.4/fpm/conf.d/10-opcache.ini
opcache.enable=1
opcache.memory_consumption=256
opcache.interned_strings_buffer=32
opcache.max_accelerated_files=30000
opcache.validate_timestamps=0     ; production: tidak memeriksa perubahan file
opcache.save_comments=1
opcache.jit=tracing
opcache.jit_buffer_size=64M

Periksa:

php -r 'var_dump(function_exists("opcache_get_status"));'
php artisan about   # bagian Cache dan Drivers

Status OPcache dari CLI tidak mewakili PHP-FPM. Periksa lewat route internal atau opcache_get_status() di halaman admin. Dengan validate_timestamps=0, PHP-FPM wajib di-reload setiap deploy (sudo systemctl reload php8.4-fpm) agar kode baru dipakai.

JIT memberi manfaat besar untuk komputasi berat, tetapi untuk aplikasi web yang didominasi I/O database manfaatnya kecil. OPcache biasa adalah peningkatan terbesar.

Pemeriksaan 4: Autoloader Composer dioptimasi

composer install --no-dev --optimize-autoloader --classmap-authoritative

--no-dev membuang paket pengembangan (Debugbar, Telescope bila hanya dev), dan classmap membuat pencarian kelas tidak lagi memeriksa file system.

Pemeriksaan 5: Driver cache, session, dan queue

Setelan Hindari di production Gunakan
CACHE_STORE file (multi-server), array redis
SESSION_DRIVER file (multi-server) redis atau database
QUEUE_CONNECTION sync redis

QUEUE_CONNECTION=sync berarti semua job "background" sebenarnya dikerjakan di dalam request. Ini salah satu penyebab paling umum halaman lambat setelah deploy.

Pemeriksaan 6: Logging tidak berlebihan

LOG_CHANNEL=daily
LOG_LEVEL=warning

LOG_LEVEL=debug di production menulis ke disk di setiap request dan file log tumbuh cepat. Pastikan juga tidak ada Log::info() di dalam perulangan besar.

Kelompok B: Database

Pemeriksaan 7: N+1 query

Aktifkan pencegahan lazy loading di lingkungan non-production:

// app/Providers/AppServiceProvider.php
use Illuminate\Database\Eloquent\Model;

public function boot(): void
{
    Model::shouldBeStrict(! $this->app->isProduction());
    // = preventLazyLoading + preventSilentlyDiscardingAttributes + preventAccessingMissingAttributes
}

Di production, laporkan alih-alih melempar exception:

Model::handleLazyLoadingViolationUsing(function ($model, $relation) {
    Log::channel('performa')->warning('n_plus_1', ['model' => $model::class, 'relasi' => $relation]);
});

Perbaikannya dengan eager loading: Iuran::with('keluarga.rukunTetangga')->paginate().

Pemeriksaan 8: Index pada kolom filter, join, dan sorting

Query yang lambat di tabel besar hampir selalu karena index tidak ada atau tidak terpakai. Periksa dengan EXPLAIN:

Iuran::where('status', 'belum_bayar')->where('periode', '2026-10')->orderBy('jatuh_tempo')->explain()->dd();

Bila kolom type bernilai ALL dan rows mendekati total isi tabel, query membaca seluruh tabel. Tambahkan composite index yang sesuai, misalnya (periode, status, jatuh_tempo).

Pemeriksaan 9: Hanya memilih kolom yang dibutuhkan

// ❌ memuat semua kolom, termasuk TEXT/JSON besar
Pengumuman::latest()->get();

// ✅
Pengumuman::select('id', 'judul', 'slug', 'terbit_pada')->latest('terbit_pada')->get();

Pemeriksaan 10: Pagination dan chunking

  • Jangan ->get() untuk daftar yang bisa berisi ribuan baris; gunakan paginate(), simplePaginate(), atau cursorPaginate().
  • paginate() menjalankan COUNT(*) tambahan. Pada tabel jutaan baris, simplePaginate() atau cursorPaginate() jauh lebih ringan.
  • Proses data besar di command atau job dengan chunkById() atau lazyById(), bukan all().

Pemeriksaan 11: Agregasi di database, bukan di PHP

// ❌ memuat semua transaksi ke memori lalu menjumlah di PHP
$total = TransaksiKas::where('jenis', 'masuk')->get()->sum('nominal');

// ✅ satu query agregat
$total = TransaksiKas::where('jenis', 'masuk')->sum('nominal');

// ✅ banyak hitungan sekaligus
$ringkasan = Iuran::where('periode', '2026-10')
    ->selectRaw("COUNT(*) AS total, SUM(status = 'lunas') AS lunas, SUM(CASE WHEN status = 'lunas' THEN nominal ELSE 0 END) AS terkumpul")
    ->first();

// ✅ hitung relasi tanpa memuatnya
Keluarga::withCount(['iuran as tunggakan' => fn ($q) => $q->where('status', 'belum_bayar')])->paginate();

Pemeriksaan 12: Koneksi database

  • Gunakan koneksi lewat socket Unix bila database di server yang sama.
  • Periksa max_connections MySQL dibanding jumlah worker PHP-FPM, worker queue, dan Octane di semua server. Bila tidak cukup, muncul error Too many connections saat traffic naik.
  • Untuk beban baca tinggi, pertimbangkan read replica ('read' dan 'write' di config/database.php, dengan 'sticky' => true).

Kelompok C: Cache

Pemeriksaan 13: Hasil berat di-cache

Dasbor yang menghitung ringkasan kas dari puluhan ribu transaksi di setiap kunjungan adalah kandidat utama:

$ringkasan = Cache::flexible("dasbor:ringkasan:{$periode}", [300, 900], fn () => $this->hitungRingkasan($periode));

Cache::flexible (stale-while-revalidate) menyajikan data yang masih "segar" selama 5 menit, lalu sampai 15 menit menyajikan data lama sambil menghitung ulang di belakang layar setelah respons dikirim. Pengguna tidak pernah menunggu perhitungan ulang.

Pemeriksaan 14: Tidak ada cache stampede

Bila cache populer kedaluwarsa dan 200 request datang bersamaan, semuanya menghitung ulang secara bersamaan dan database tumbang. Cache::flexible atau lock mencegahnya:

$data = Cache::get($kunci) ?? Cache::lock("lock:{$kunci}", 10)->block(5, function () use ($kunci) {
    return Cache::get($kunci) ?? tap($this->hitung(), fn ($v) => Cache::put($kunci, $v, 600));
});

Pemeriksaan 15: Memo per request

Data yang sama diambil berkali-kali dalam satu request (misalnya pengaturan aplikasi dibaca di 20 komponen Blade):

// Cache::memo() menyimpan hasil di memori selama satu request di atas store mana pun
$pengaturan = Cache::memo()->remember('pengaturan', 3600, fn () => Pengaturan::pluck('nilai', 'kunci'));

Untuk komputasi murni di dalam satu objek, gunakan helper once().

Kelompok D: Pekerjaan di Luar Request

Pemeriksaan 16: Pekerjaan lambat dipindah ke queue

Cari di controller: Mail::send, Notification::send tanpa ShouldQueue, pembuatan PDF, pemrosesan gambar, impor Excel, panggilan ke API pihak ketiga yang tidak perlu ditunggu. Semuanya dipindah ke job.

Pemeriksaan 17: Panggilan HTTP eksternal punya timeout

Http::timeout(5)->connectTimeout(2)->retry(2, 200, throw: false)->get(...);

Tanpa timeout, satu API pihak ketiga yang lambat menahan worker PHP-FPM sampai max_execution_time. Bila ada 20 request seperti itu bersamaan, seluruh pool worker habis dan aplikasi terlihat mati, padahal CPU menganggur. Untuk beberapa panggilan independen, gunakan Http::pool() atau facade Concurrency.

Kelompok E: Server & Frontend

Pemeriksaan 18: Kapasitas PHP-FPM

grep -E '^pm' /etc/php/8.4/fpm/pool.d/www.conf
grep 'max_children' /var/log/php8.4-fpm.log

Pesan server reached pm.max_children setting berarti request mengantre menunggu worker. Solusinya bukan sekadar menaikkan angka; hitung dari memori yang tersedia (lihat artikel PHP-FPM tuning).

Pemeriksaan 19: Aset statis

  • Build aset dengan Vite untuk production (npm run build), bukan dev server.
  • Nginx menyajikan file di public/build langsung dengan header cache panjang (nama file Vite sudah memuat hash).
  • Kompresi gzip atau brotli untuk teks.
  • Gambar dikonversi dan diperkecil saat unggah (Media Library conversions), serta loading="lazy".
location /build/ {
    expires 1y;
    add_header Cache-Control "public, immutable";
    access_log off;
}

Pemeriksaan 20: Middleware dan service provider yang tidak perlu

  • Middleware global yang melakukan query di setiap request (misalnya memuat pengaturan, menghitung notifikasi belum dibaca) untuk route API dan aset.
  • Service provider yang melakukan pekerjaan berat di boot() (query, panggilan HTTP).
  • Paket yang tidak dipakai lagi.

Telusuri dengan Telescope atau Debugbar: lihat query yang berjalan bahkan di halaman paling sederhana.

Langkah 21: Otomatisasi Pemeriksaan

Sebagian besar pemeriksaan konfigurasi bisa dijalankan sebagai command, misalnya setelah deploy atau di pipeline CI terhadap server staging.

// app/Console/Commands/PeriksaPerforma.php
namespace App\Console\Commands;

use Illuminate\Console\Command;

class PeriksaPerforma extends Command
{
    protected $signature = 'performa:periksa';
    protected $description = 'Memeriksa konfigurasi yang memengaruhi performa';

    public function handle(): int
    {
        $hasil = [
            ['APP_DEBUG mati',              ! config('app.debug')],
            ['Config ter-cache',            app()->configurationIsCached()],
            ['Route ter-cache',             app()->routesAreCached()],
            ['Event ter-cache',             app()->eventsAreCached()],
            ['Cache bukan file/array',      ! in_array(config('cache.default'), ['file', 'array'], true)],
            ['Session bukan file/array',    ! in_array(config('session.driver'), ['file', 'array'], true)],
            ['Queue bukan sync',            config('queue.default') !== 'sync'],
            ['LOG_LEVEL bukan debug',       config('logging.channels.'.config('logging.default').'.level') !== 'debug'],
            ['Debugbar tidak aktif',        ! app()->bound('debugbar')],
            ['Telescope mati (atau lokal)', ! config('telescope.enabled', false) || app()->environment('local')],
            ['Ekstensi redis/predis',       extension_loaded('redis') || class_exists(\Predis\Client::class)],
        ];

        $this->table(['Pemeriksaan', 'Status'], array_map(
            fn ($b) => [$b[0], $b[1] ? '<info>OK</info>' : '<error>PERLU DICEK</error>'],
            $hasil,
        ));

        $this->line('Catatan: status OPcache harus diperiksa dari PHP-FPM, bukan CLI.');

        return collect($hasil)->every(fn ($b) => $b[1]) ? self::SUCCESS : self::FAILURE;
    }
}
php artisan performa:periksa

Langkah 22: Siklus Kerja

  1. Ukur baseline (p95, jumlah query, rps).
  2. Temukan bottleneck terbesar (biasanya database atau I/O eksternal).
  3. Perbaiki satu hal.
  4. Ukur ulang dengan skenario yang sama.
  5. Catat hasilnya (misalnya di pull request): "/iuran p95 4,1 s → 380 ms; query 312 → 6".
  6. Ulangi sampai target tercapai.

Contoh hasil pada studi kasus RW:

Perbaikan /iuran p95 Query
Baseline 4.100 ms 312
Eager loading (Pemeriksaan 7) 1.250 ms 6
Composite index (Pemeriksaan 8) 420 ms 6
optimize + OPcache (Pemeriksaan 2–3) 380 ms 6

Angka di atas adalah ilustrasi pola yang umum terjadi. Ukur di aplikasi Anda sendiri.

Langkah 23: Test untuk Mencegah Regresi

Kunci jumlah query halaman penting agar N+1 tidak kembali tanpa disadari:

// tests/Feature/Performa/JumlahQueryTest.php
use Illuminate\Support\Facades\DB;

it('halaman daftar iuran memakai jumlah query yang tetap', function () {
    $admin = User::factory()->create()->assignRole('admin');
    Iuran::factory()->count(50)->create();

    DB::enableQueryLog();
    $this->actingAs($admin)->get('/iuran')->assertOk();
    $jumlah = count(DB::getQueryLog());

    expect($jumlah)->toBeLessThanOrEqual(12);
});

it('tidak ada lazy loading di halaman dasbor', function () {
    Model::preventLazyLoading();
    $admin = User::factory()->create()->assignRole('admin');
    Iuran::factory()->count(20)->create();

    $this->actingAs($admin)->get('/dasbor')->assertOk();   // akan error bila ada lazy loading
});

Troubleshooting

Error / Gejala Penyebab Solusi
Lambat hanya di production Debug aktif, cache tidak dibangun, OPcache mati Pemeriksaan 1–3
Perubahan .env tidak berlaku Config ter-cache php artisan config:cache ulang setelah mengubah .env
env() mengembalikan null Dipanggil di luar config/ setelah cache Pindahkan ke file config dan pakai config()
Kode baru tidak dipakai setelah deploy opcache.validate_timestamps=0 Reload PHP-FPM di skrip deploy
server reached pm.max_children Worker habis karena request lambat atau terlalu sedikit Cari request lambat dulu, lalu hitung ulang kapasitas
502 Bad Gateway saat ramai PHP-FPM penuh atau crash Log PHP-FPM; timeout HTTP eksternal; kapasitas
Query cepat lokal, lambat di production Data lokal kecil; index tidak ada EXPLAIN dengan volume data realistis
Memori habis (Allowed memory size exhausted) ->get() atau all() pada data besar Pagination, chunkById, lazyById
Database tumbang saat cache kedaluwarsa Cache stampede Cache::flexible atau lock
Halaman cepat, tetapi aksi simpan lambat Email/notifikasi sinkron Queue (Pemeriksaan 16)

Best Practices

Keamanan

  • Paket debug (Debugbar, Telescope tanpa gate) tidak boleh aktif di production.
  • Log performa tidak memuat data pribadi atau nilai binding query yang sensitif.
  • Endpoint diagnostik (status OPcache, dll.) hanya untuk admin.

Performa

  • Ukur dulu, perbaiki bottleneck terbesar, ukur ulang.
  • Database dan I/O eksternal adalah tersangka utama; periksa sebelum menambah server.
  • Cache untuk hasil berat, queue untuk pekerjaan lambat, timeout untuk semua panggilan keluar.

Maintainability

  • php artisan optimize dan reload PHP-FPM bagian dari skrip deploy.
  • Test jumlah query untuk halaman penting.
  • Catat baseline dan hasil setiap optimasi agar keputusan berbasis data.

Related Articles

Last Tested

Komponen Versi
Laravel 13.x
PHP 8.4 (OPcache aktif)
MySQL 8.4
Redis 7.x
Pest 4.x
Tanggal 19 Oktober 2026

Bagikan artikel:

Artikel lainnya