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

Blog / Performance, Caching & Scalability / Redis untuk Laravel: Panduan S...
Performance, Caching & Scalability

Redis untuk Laravel: Panduan Setup Cache, Session, dan Queue Worker

AD

Admin HijrahKreativa

Penulis

19 Oct 2026
12 min read
10 views

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.

Overview

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:

  • Redis (atau Valkey) terpasang dan diamankan,
  • pemisahan cache dan data penting (session, queue) dengan kebijakan memori berbeda,
  • konfigurasi config/database.php dengan koneksi cache, session, dan queue,
  • persistensi yang sesuai untuk tiap peran,
  • pemantauan memori, hit rate, dan latensi,
  • test koneksi dan health check.

Prerequisites

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.

Step-by-step Tutorial

Langkah 1: Pasang Redis dan Ekstensi PHP

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

Langkah 2: Amankan Redis

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://).

Langkah 3: Pisahkan Cache dari Data Penting

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.

Langkah 4: Konfigurasi Koneksi Laravel

// 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.

Langkah 5: Serialisasi dan Kompresi (Opsional)

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:

  • Konstanta kompresi hanya tersedia bila phpredis dikompilasi dengan dukungan tersebut. Periksa dengan php --ri redis.
  • Mengganti serializer membuat data lama tidak terbaca. Jalankan php artisan cache:clear setelah mengubahnya.
  • Terapkan hanya pada koneksi cache, uji fungsi increment, lock, dan flexible di staging sebelum production.

Langkah 6: Session di Redis

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.

Langkah 7: Queue di Redis

// 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.

Langkah 8: Pola Pemakaian yang Aman

// ✅ 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.
  • Kunci tanpa TTL di instance cache, kecuali memang permanen.
  • Nilai sangat besar (beberapa MB) dalam satu kunci; memecahnya lebih baik untuk latensi.
  • Cache::flush() dari kode aplikasi; perintah ini menghapus seluruh database cache.

Langkah 9: Pemantauan

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.

Langkah 10: Health Check dan Test

// 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.

Troubleshooting

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

Best Practices

Keamanan

  • Jangan pernah membuka Redis ke internet; bind ke IP privat dan firewall.
  • ACL dengan pengguna khusus aplikasi dan perintah berbahaya diblokir.
  • TLS bila melintasi jaringan yang tidak tepercaya.
  • Jangan menyimpan data sensitif tanpa enkripsi di cache.

Performa

  • phpredis, koneksi persisten bila perlu, block_for untuk queue.
  • Pisahkan cache (allkeys-lru) dari data penting (noeviction).
  • Pantau hit rate dan evicted_keys; ukur sebelum menambah memori.
  • Kompresi untuk nilai cache besar, setelah diuji.

Maintainability

  • Satu koneksi per peran (cache, session, queue, default) yang dapat dipindah ke instance lain tanpa mengubah kode.
  • Prefix unik per aplikasi bila Redis dipakai bersama.
  • Persistensi AOF untuk instance data, tanpa persistensi untuk cache.
  • Status Redis dan panjang antrean masuk ke pemantauan rutin.

Related Articles

Last Tested

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

Bagikan artikel:

Artikel lainnya