Caching

Lihat sebagai Markdown Edit di GitHub Dokumentasi di 2cc7b2b

Queuety menyertakan lapisan cache yang mengurangi kueri basis data pada jalur yang sering digunakan, seperti pemeriksaan jeda antrean, penghitung batas laju, pencarian status alur kerja, dan operasi kunci. Cache diinisialisasi secara otomatis saat Anda memanggil Queuety::init().

Antarmuka cache

Semua backend cache mengimplementasikan Queuety\Contracts\Cache:

Metode	Mengembalikan	Deskripsi
`get( string $key )`	`mixed`	Ambil sebuah nilai. Mengembalikan `null` jika tidak ditemukan atau sudah kedaluwarsa.
`set( string $key, mixed $value, int $ttl = 0 )`	`void`	Simpan sebuah nilai. TTL 0 berarti tidak kedaluwarsa.
`delete( string $key )`	`void`	Hapus sebuah nilai.
`has( string $key )`	`bool`	Periksa apakah kunci ada dan belum kedaluwarsa.
`add( string $key, mixed $value, int $ttl = 0 )`	`bool`	Tetapkan nilai hanya jika kunci belum ada (atomik). Mengembalikan `true` jika nilai berhasil ditetapkan.
`flush()`	`void`	Hapus semua item dari cache. `ApcuCache::flush()` memanggil `apcu_clear_cache()`, yang menghapus setiap entri APCu di server, bukan hanya milik Queuety.

Backend bawaan

MemoryCache (default)

Queuety\Cache\MemoryCache adalah cache berbasis array untuk setiap proses. Item disimpan dalam array PHP dan hilang saat proses berakhir. Ini adalah backend default saat APCu tidak tersedia.

Backend ini tidak memerlukan ekstensi, berfungsi baik untuk deployment dengan satu worker, dan menjaga setiap proses worker tetap terisolasi dari yang lain.

ApcuCache

Queuety\Cache\ApcuCache menggunakan ekstensi APCu untuk berbagi memori di antara semua proses PHP pada server yang sama. Semua kunci otomatis diawali dengan queuety: untuk menghindari konflik dengan aplikasi lain.

Backend ini memerlukan ekstensi php-apcu, berbagi entri cache di antara worker pada server yang sama, dan membuat add() benar-benar atomik melalui apcu_add().

Deteksi otomatis

Queuety\Cache\CacheFactory memilih backend terbaik yang tersedia secara otomatis:

Jika apcu_store() tersedia dan apcu_enabled() mengembalikan true, Queuety menggunakan ApcuCache. Jika tidak, sistem beralih ke MemoryCache. Proses ini berlangsung di dalam Queuety::init(), sehingga perilaku default tidak memerlukan konfigurasi tambahan.

Data yang di-cache

Lapisan cache digunakan secara internal oleh beberapa subsistem:

Data	Tujuan
Status jeda antrean	Menghindari kueri basis data pada setiap iterasi worker
Penghitung batas laju	Melacak jumlah eksekusi di memori, bukan di basis data
Status alur kerja	Mengurangi pembacaan saat alur kerja bertahap dilanjutkan
Status kunci	Mempercepat pemeriksaan keberadaan kunci untuk pekerjaan unik dan middleware mutex

Konfigurasi TTL

TTL cache default adalah 5 detik. TTL ini berlaku untuk status jeda antrean dan penghitung batas laju; pembacaan status dan keadaan alur kerja di-cache selama 2 detik tetap, yang tidak diubah oleh konstanta. Ganti nilai default dengan konstanta QUEUETY_CACHE_TTL di wp-config.php Anda:

PHP

define( 'QUEUETY_CACHE_TTL', 10 ); // 10 seconds

TTL yang lebih rendah berarti kueri basis data lebih sering, tetapi data lebih baru. TTL yang lebih tinggi mengurangi beban basis data, tetapi membuat data lebih usang. Untuk sebagian besar deployment, nilai default 5 detik merupakan keseimbangan yang baik.

Backend cache kustom

Untuk menggunakan backend cache kustom (Redis, Memcached, atau yang lain), implementasikan antarmuka Contracts\Cache dan panggil Queuety::set_cache() sebelum Queuety::init():

PHP

use Queuety\Contracts\Cache;
use Queuety\Queuety;

class RedisCache implements Cache {
    public function get( string $key ): mixed { /* ... */ }
    public function set( string $key, mixed $value, int $ttl = 0 ): void { /* ... */ }
    public function delete( string $key ): void { /* ... */ }
    public function has( string $key ): bool { /* ... */ }
    public function add( string $key, mixed $value, int $ttl = 0 ): bool { /* ... */ }
    public function flush(): void { /* ... */ }
}

// Set the cache before init() so all subsystems use it.
Queuety::set_cache( new RedisCache() );
Queuety::init( $connection );

Jika set_cache() dipanggil sebelum init(), deteksi otomatis factory dilewati sepenuhnya dan backend kustom Anda akan digunakan.

Mengakses cache

Ambil instance cache aktif kapan saja:

PHP

$cache = Queuety::cache();

$cache->set( 'my_key', 'my_value', 60 );
$value = $cache->get( 'my_key' );

Ini mengembalikan backend yang sedang aktif (MemoryCache, ApcuCache, atau implementasi kustom Anda).