Laravel Performance Optimization: 20 Pemeriksaan untuk Menemukan Bottleneck Aplikasi
Admin HijrahKreativa
Penulis
Source code aplikasi, template web, dan ebook. Unduh dari akun setelah bayar. Lihat produk
Admin HijrahKreativa
Penulis
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.
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,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:
php artisan performa:periksa yang memeriksa konfigurasi secara otomatis,| 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 |
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.
APP_DEBUG dan APP_ENVAPP_ENV=production
APP_DEBUG=false
APP_DEBUG=true memperlambat penanganan error dan membocorkan informasi. Ini sekaligus masalah keamanan.
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.
; /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.
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.
| 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.
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.
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().
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).
// ❌ memuat semua kolom, termasuk TEXT/JSON besar
Pengumuman::latest()->get();
// ✅
Pengumuman::select('id', 'judul', 'slug', 'terbit_pada')->latest('terbit_pada')->get();
->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.chunkById() atau lazyById(), bukan all().// ❌ 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();
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.'read' dan 'write' di config/database.php, dengan 'sticky' => true).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.
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));
});
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().
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.
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.
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).
npm run build), bukan dev server.public/build langsung dengan header cache panjang (nama file Vite sudah memuat hash).loading="lazy".location /build/ {
expires 1y;
add_header Cache-Control "public, immutable";
access_log off;
}
boot() (query, panggilan HTTP).Telusuri dengan Telescope atau Debugbar: lihat query yang berjalan bahkan di halaman paling sederhana.
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
/iuran p95 4,1 s → 380 ms; query 312 → 6".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.
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
});
| 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) |
Keamanan
Performa
Maintainability
php artisan optimize dan reload PHP-FPM bagian dari skrip deploy.| Komponen | Versi |
|---|---|
| Laravel | 13.x |
| PHP | 8.4 (OPcache aktif) |
| MySQL | 8.4 |
| Redis | 7.x |
| Pest | 4.x |
| Tanggal | 19 Oktober 2026 |
Sebelumnya
Membangun Integrasi Antar-Modul Laravel dengan Event, Listener, Queue, dan API
Berikutnya
Jangan Cuma Upgrade VPS: Deep Dive Load Balancer untuk Laravel Saat Traffic Naik
Dokumen ini menjelaskan prosedur konfigurasi autentikasi SSH Key antara server Ubuntu dan GitHub untuk memungkinkan server melakukan operasi Git, seperti clone, pull, dan fetch tanpa menggunakan username dan password akun GitHub.
Peta jalan arsitektur dari satu server hingga banyak server: tahapan pertumbuhan dan sinyal kapan naik tahap, prinsip yang sebaiknya diterapkan sejak awal (stateless, asinkron, data ber-tenant), read replica, pengelolaan data yang terus tumbuh, degradasi yang anggun saat layanan bermasalah, feature...
Menyiapkan lingkungan uji yang jujur, mengukur satu endpoint dengan ApacheBench, mensimulasikan perilaku pengguna sungguhan dengan k6 (skenario, threshold, autentikasi token), menelusuri penyebab request lambat dengan Telescope, memantau server selama pengujian, serta menulis laporan hasil dan angga...
Bagaimana Octane membuat Laravel lebih cepat dengan mem-boot aplikasi sekali dan menyimpannya di memori, apa yang sebenarnya dipercepat (dan yang tidak), risiko kebocoran state antar-request yang wajib dipahami, cara memeriksa kode agar aman untuk Octane, pemasangan dengan FrankenPHP di production,...
03 Nov 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
HijrahKreativa
Kami balas secepatnya
Masuk dulu untuk chat dengan tim kami. Riwayat chat Anda tersimpan di akun.
Masuk