Redis untuk Laravel: Panduan Setup Cache, Session, dan Queue Worker
Admin HijrahKreativa
Penulis
Source code aplikasi, template web, dan ebook. Unduh dari akun setelah bayar. Lihat produk
Admin HijrahKreativa
Penulis
Memasang dan mengamankan Redis untuk production, memisahkan cache dari session dan queue agar kebijakan eviction tidak menghapus data penting, konfigurasi koneksi Laravel dengan phpredis, persistensi, pemantauan memori dan latensi, serta jebakan seperti cache:clear yang ikut menghapus antrean job.
Redis adalah penyimpanan data di memori yang sangat cepat. Di aplikasi Laravel, Redis biasanya memegang tiga peran:
| Peran | Sifat data | Boleh hilang? |
|---|---|---|
| Cache | Salinan hasil perhitungan; bisa dihitung ulang | Ya, kapan saja |
| Session | Status login pengguna | Sebaiknya tidak; pengguna akan logout |
| Queue | Job yang belum diproses | Tidak; email, pembayaran, laporan bisa hilang |
Kesalahan paling umum adalah menaruh ketiganya di satu database Redis dengan satu kebijakan memori. Ketika memori penuh, Redis dengan kebijakan allkeys-lru akan menghapus kunci yang jarang dipakai, dan itu bisa berupa job antrean atau session. Atau sebaliknya, kebijakan noeviction membuat cache gagal ditulis dan aplikasi error. Lebih parah lagi, php artisan cache:clear menjalankan FLUSHDB pada database cache. Bila queue berada di database yang sama, semua job ikut hilang.
Hasil akhir:
config/database.php dengan koneksi cache, session, dan queue,| Komponen | Versi |
|---|---|
| PHP | 8.3+ (disarankan 8.4) dengan ekstensi redis (phpredis 6.x) |
| Laravel | 13.x |
| Redis | 7.2+ / 8.x, atau Valkey 8.x |
| OS | Ubuntu 24.04 LTS atau Debian 12 |
Tentang lisensi: sejak 2024 Redis tidak lagi berlisensi BSD (Redis 8 menawarkan AGPLv3 sebagai salah satu opsi). Valkey adalah fork berlisensi BSD dari Redis 7.2 yang kompatibel protokolnya, dan Laravel bisa memakainya tanpa perubahan konfigurasi. Pilih sesuai kebijakan organisasi Anda; semua perintah di artikel ini berlaku untuk keduanya.
sudo apt update
sudo apt install redis-server # atau: sudo apt install valkey-server
sudo apt install php8.4-redis php8.4-igbinary
sudo systemctl enable --now redis-server
redis-cli ping # PONG
php -m | grep -E 'redis|igbinary'
phpredis vs predis. phpredis adalah ekstensi C dan lebih cepat; predis adalah library PHP murni yang tidak perlu ekstensi. Untuk production, gunakan phpredis.
REDIS_CLIENT=phpredis
Redis yang terbuka ke internet tanpa password adalah target serangan otomatis yang sangat umum. Konfigurasi minimum:
# /etc/redis/redis.conf
bind 127.0.0.1 10.0.0.20 # localhost + IP privat; JANGAN 0.0.0.0 di IP publik
protected-mode yes
port 6379
# Pengguna khusus aplikasi lewat ACL (Redis 6+)
user default off
user laravel on >PASSWORD_PANJANG_ACAK ~* &* +@all -@dangerous +info +flushdb
# Nonaktifkan perintah berbahaya untuk pengguna aplikasi
# (-@dangerous mencakup FLUSHALL, CONFIG, KEYS, DEBUG, dll.)
# .env
REDIS_HOST=10.0.0.20
REDIS_USERNAME=laravel
REDIS_PASSWORD=PASSWORD_PANJANG_ACAK
REDIS_PORT=6379
+flushdb diizinkan kembali karena php artisan cache:clear membutuhkannya. +info dibutuhkan untuk pemantauan dan Horizon. Uji aplikasi setelah mengaktifkan ACL; bila ada fitur yang memakai perintah yang terblokir, Redis akan mengembalikan error NOPERM yang jelas.
Lindungi juga di level jaringan: firewall hanya mengizinkan port 6379 dari server aplikasi dan worker.
sudo ufw allow from 10.0.0.0/24 to any port 6379 proto tcp
Untuk koneksi lintas jaringan yang tidak tepercaya (misalnya Redis terkelola di penyedia lain), gunakan TLS (REDIS_SCHEME=tls atau host berawalan tls://).
Ada dua tingkat pemisahan.
Opsi A: Dua instance Redis (disarankan untuk production).
| Instance | Port | Isi | maxmemory-policy |
Persistensi |
|---|---|---|---|---|
redis-cache |
6379 | Cache | allkeys-lru |
Mati (boleh hilang) |
redis-data |
6380 | Session, queue, lock, rate limiter | noeviction |
AOF everysec |
# /etc/redis/redis-cache.conf
port 6379
maxmemory 1gb
maxmemory-policy allkeys-lru
save ""
appendonly no
# /etc/redis/redis-data.conf
port 6380
maxmemory 512mb
maxmemory-policy noeviction
appendonly yes
appendfsync everysec
Dengan noeviction, Redis menolak penulisan baru saat memori penuh (error OOM command not allowed) alih-alih diam-diam menghapus job atau session. Itu perilaku yang diinginkan untuk data penting: error yang terlihat lebih baik daripada data yang hilang tanpa jejak. Pasang peringatan pemakaian memori agar tidak sampai penuh.
Opsi B: Satu instance, database berbeda (untuk server kecil).
Database nomor (0–15) di Redis berbagi memori dan kebijakan eviction yang sama, sehingga pemisahan ini hanya melindungi dari cache:clear (yang memakai FLUSHDB per database), bukan dari eviction. Gunakan maxmemory-policy volatile-lru: hanya kunci yang punya TTL yang bisa dihapus. Antrean job disimpan tanpa TTL sehingga aman, tetapi session di Redis juga memakai TTL sehingga tetap bisa terhapus saat memori penuh, begitu pula cache yang disimpan dengan forever() tidak akan pernah dibuang. Opsi A lebih aman.
Di Ubuntu/Debian, instance kedua dijalankan lewat unit systemd bertemplat: salin konfigurasi ke /etc/redis/redis-data.conf lalu sudo systemctl enable --now redis-server@data (paket Debian menyediakan redis-server@.service yang membaca /etc/redis/redis-%i.conf). Pastikan pidfile, logfile, dan dir tiap instance berbeda.
// config/database.php
'redis' => [
'client' => env('REDIS_CLIENT', 'phpredis'),
'options' => [
'cluster' => env('REDIS_CLUSTER', 'redis'),
'prefix' => env('REDIS_PREFIX', 'rw_'), // unik per aplikasi bila Redis dipakai bersama
'persistent' => env('REDIS_PERSISTENT', false),
],
// Data penting: session, queue, lock, rate limiter, Horizon
'default' => [
'url' => env('REDIS_URL'),
'host' => env('REDIS_HOST', '127.0.0.1'),
'username' => env('REDIS_USERNAME'),
'password' => env('REDIS_PASSWORD'),
'port' => env('REDIS_PORT', '6380'),
'database' => env('REDIS_DB', '0'),
'read_timeout' => 60,
],
'queue' => [
'host' => env('REDIS_HOST', '127.0.0.1'),
'username' => env('REDIS_USERNAME'),
'password' => env('REDIS_PASSWORD'),
'port' => env('REDIS_PORT', '6380'),
'database' => env('REDIS_QUEUE_DB', '1'),
'read_timeout' => 60,
],
'session' => [
'host' => env('REDIS_HOST', '127.0.0.1'),
'username' => env('REDIS_USERNAME'),
'password' => env('REDIS_PASSWORD'),
'port' => env('REDIS_PORT', '6380'),
'database' => env('REDIS_SESSION_DB', '2'),
],
// Cache: instance terpisah, boleh di-evict
'cache' => [
'host' => env('REDIS_CACHE_HOST', env('REDIS_HOST', '127.0.0.1')),
'username' => env('REDIS_USERNAME'),
'password' => env('REDIS_PASSWORD'),
'port' => env('REDIS_CACHE_PORT', '6379'),
'database' => env('REDIS_CACHE_DB', '0'),
],
],
Hubungkan tiap komponen ke koneksinya:
CACHE_STORE=redis
REDIS_CACHE_CONNECTION=cache
REDIS_CACHE_LOCK_CONNECTION=default # lock di instance data (noeviction)
SESSION_DRIVER=redis
SESSION_CONNECTION=session
QUEUE_CONNECTION=redis
REDIS_QUEUE_CONNECTION=queue
REDIS_QUEUE_RETRY_AFTER=330
Variabel di atas dibaca oleh config/cache.php ('connection' => env('REDIS_CACHE_CONNECTION', 'cache'), 'lock_connection' => env('REDIS_CACHE_LOCK_CONNECTION', 'default')), config/session.php ('connection' => env('SESSION_CONNECTION')), dan config/queue.php ('connection' => env('REDIS_QUEUE_CONNECTION', 'default')). Periksa file config proyek Anda; bila tidak ada, tambahkan baris tersebut.
Mengapa lock dipindah ke instance data: lock dipakai withoutOverlapping, onOneServer, ShouldBeUnique, dan Cache::lock. Bila lock tersimpan di instance yang bisa di-evict, lock bisa hilang di tengah jalan dan dua proses berjalan bersamaan.
phpredis mendukung serializer igbinary dan kompresi (lz4, zstd) yang mengurangi pemakaian memori untuk nilai cache yang besar (misalnya koleksi hasil query).
// config/database.php → koneksi 'cache'
'cache' => [
// ...
'options' => [
'serializer' => \Redis::SERIALIZER_IGBINARY,
'compression' => \Redis::COMPRESSION_LZ4,
],
],
Perhatian:
php --ri redis.php artisan cache:clear setelah mengubahnya.increment, lock, dan flexible di staging sebelum production.SESSION_DRIVER=redis
SESSION_CONNECTION=session
SESSION_LIFETIME=120
SESSION_ENCRYPT=false
SESSION_SECURE_COOKIE=true
Session di Redis disimpan dengan TTL sesuai SESSION_LIFETIME, sehingga kedaluwarsa otomatis tanpa perlu garbage collection. Untuk logout dari semua perangkat atau melihat sesi aktif per pengguna, driver database lebih praktis karena session bisa di-query berdasarkan user_id; pilih sesuai kebutuhan fitur.
// config/queue.php
'redis' => [
'driver' => 'redis',
'connection' => env('REDIS_QUEUE_CONNECTION', 'default'),
'queue' => env('REDIS_QUEUE', 'default'),
'retry_after' => (int) env('REDIS_QUEUE_RETRY_AFTER', 90),
'block_for' => 5,
'after_commit' => true,
],
block_for membuat worker menunggu job baru dengan perintah blocking Redis (BLPOP) alih-alih polling terus-menerus, sehingga beban CPU Redis dan worker lebih rendah. Pastikan read_timeout koneksi lebih besar dari block_for.
Untuk dasbor dan pengaturan worker otomatis, gunakan Horizon. Horizon memakai koneksi Redis default untuk metadatanya; dengan pemisahan di Langkah 3 metadata itu berada di instance data.
// ✅ Cache dengan TTL selalu
Cache::put('kurs:usd', $nilai, now()->addHour());
Cache::remember("keluarga:{$id}:ringkasan", 600, fn () => ...);
// ✅ Counter atomic (rate limit sederhana, statistik)
Cache::add("kunjungan:{$hari}", 0, now()->addDays(2));
Cache::increment("kunjungan:{$hari}");
// ✅ Lock terdistribusi
Cache::lock("rekonsiliasi:{$pembayaranId}", 30)->block(5, fn () => $this->rekonsiliasi($pembayaranId));
// ✅ Akses Redis langsung untuk struktur khusus (sorted set peringkat, dll.)
Redis::connection('cache')->zincrby('populer:pengumuman', 1, $pengumumanId);
Hindari:
KEYS * di production. Perintah ini memblokir Redis selama memindai seluruh kunci. Gunakan SCAN bila benar-benar perlu.Cache::flush() dari kode aplikasi; perintah ini menghapus seluruh database cache.redis-cli -p 6379 INFO memory | grep -E 'used_memory_human|maxmemory_human|mem_fragmentation_ratio'
redis-cli -p 6379 INFO stats | grep -E 'keyspace_hits|keyspace_misses|evicted_keys'
redis-cli -p 6380 INFO stats | grep -E 'rejected_connections'
redis-cli -p 6379 --latency
redis-cli -p 6379 SLOWLOG GET 10
redis-cli -p 6379 --bigkeys # memakai SCAN, aman tetapi tetap jalankan di luar jam sibuk
Metrik yang perlu dipantau:
| Metrik | Arti | Peringatan bila |
|---|---|---|
used_memory vs maxmemory |
Pemakaian memori | > 80% (terutama instance data) |
| Hit rate = hits / (hits + misses) | Efektivitas cache | Turun drastis (cache terlalu kecil atau kunci salah) |
evicted_keys |
Kunci yang dibuang karena penuh | Naik terus di instance cache; > 0 di instance data |
connected_clients |
Jumlah koneksi | Mendekati maxclients |
| Latensi | Waktu respons | > beberapa ms di jaringan lokal |
| Panjang antrean | LLEN queues:default |
Terus naik (worker kurang) |
Command kecil untuk memeriksa dari Laravel:
// app/Console/Commands/StatusRedis.php
public function handle(): int
{
foreach (['cache', 'default', 'queue', 'session'] as $nama) {
$info = Redis::connection($nama)->info();
$stats = $info['Stats'] ?? $info;
$memory = $info['Memory'] ?? $info;
$hits = (int) ($stats['keyspace_hits'] ?? 0);
$miss = (int) ($stats['keyspace_misses'] ?? 0);
$this->line(sprintf('%-8s mem=%s evicted=%s hit=%s%%',
$nama,
$memory['used_memory_human'] ?? '?',
$stats['evicted_keys'] ?? '?',
$hits + $miss ? round($hits / ($hits + $miss) * 100, 1) : '-',
));
}
foreach (['kritis', 'default', 'laporan', 'whatsapp'] as $antrean) {
$this->line("antrean {$antrean}: ".Queue::connection('redis')->size($antrean));
}
return self::SUCCESS;
}
Struktur hasil info() sedikit berbeda antara phpredis dan predis (berkelompok per seksi atau datar), karena itu kode di atas membaca keduanya.
// Health check (lihat artikel load balancer)
Event::listen(function (DiagnosingHealth $event) {
Redis::connection('default')->ping();
});
// tests/Feature/Infra/RedisTest.php
// Jalankan hanya di lingkungan yang punya Redis (misalnya CI dengan service redis)
it('cache, lock, dan queue memakai koneksi yang benar', function () {
expect(config('cache.stores.redis.connection'))->toBe('cache')
->and(config('cache.stores.redis.lock_connection'))->toBe('default')
->and(config('queue.connections.redis.connection'))->toBe('queue')
->and(config('session.connection'))->toBe('session');
});
it('lock mencegah eksekusi ganda', function () {
$lock1 = Cache::store('redis')->lock('uji-lock', 10);
$lock2 = Cache::store('redis')->lock('uji-lock', 10);
expect($lock1->get())->toBeTrue()
->and($lock2->get())->toBeFalse();
$lock1->release();
})->skip(fn () => ! extension_loaded('redis'), 'butuh ekstensi redis');
Untuk test pertama, set nilai .env.testing sesuai konfigurasi production agar perbedaan konfigurasi tertangkap.
| Error / Gejala | Penyebab | Solusi |
|---|---|---|
Connection refused |
Redis mati, salah host/port, atau bind hanya localhost |
systemctl status redis-server; periksa bind dan firewall |
NOAUTH Authentication required |
Password/username tidak dikirim | Set REDIS_USERNAME/REDIS_PASSWORD; config:cache ulang |
NOPERM this user has no permissions |
ACL memblokir perintah | Tambahkan izin perintah yang diperlukan |
OOM command not allowed when used memory > 'maxmemory' |
Instance noeviction penuh |
Naikkan maxmemory, cari kunci besar, periksa antrean menumpuk |
Job hilang setelah cache:clear |
Cache dan queue di database yang sama | Pisahkan koneksi/database |
| Pengguna logout acak | Session ter-evict | Session di instance noeviction |
Class "Redis" not found |
Ekstensi phpredis tidak terpasang untuk SAPI yang dipakai | Pasang php8.4-redis, restart PHP-FPM |
| Worker memakan CPU tinggi saat antrean kosong | Polling tanpa blocking | block_for di config queue |
Error read error on connection |
read_timeout lebih kecil dari block_for |
Naikkan read_timeout |
| Redis lambat sesaat secara berkala | KEYS *, kunci besar, atau BGSAVE |
Hindari KEYS; pecah kunci besar; jadwalkan snapshot |
Keamanan
bind ke IP privat dan firewall.Performa
block_for untuk queue.allkeys-lru) dari data penting (noeviction).evicted_keys; ukur sebelum menambah memori.Maintainability
cache, session, queue, default) yang dapat dipindah ke instance lain tanpa mengubah kode.| Komponen | Versi |
|---|---|
| Laravel | 13.x |
| PHP | 8.4 + phpredis 6.x |
| Redis / Valkey | 7.2 / 8.x |
| Ubuntu | 24.04 LTS |
| Pest | 4.x |
| Tanggal | 19 Oktober 2026 |
Sebelumnya
Jangan Cuma Upgrade VPS: Deep Dive Load Balancer untuk Laravel Saat Traffic Naik
Berikutnya
Cara Mengoptimalkan Query MySQL Laravel Menggunakan Index dan EXPLAIN
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