Кешування

Переглянути як Markdown Редагувати на GitHub Документація для 2cc7b2b

Queuety містить рівень кешу, що зменшує кількість запитів до бази даних на часто використовуваних шляхах, як-от перевірки призупинення черги, лічильники обмеження частоти, пошук стану робочого процесу та операції блокування. Кеш автоматично ініціалізується під час виклику Queuety::init().

Інтерфейс кешу

Усі серверні модулі кешу реалізують Queuety\Contracts\Cache:

Метод	Повертає	Опис
`get( string $key )`	`mixed`	Отримує значення. Повертає `null`, якщо його не знайдено або строк його дії минув.
`set( string $key, mixed $value, int $ttl = 0 )`	`void`	Зберігає значення. TTL 0 означає, що строк дії не обмежений.
`delete( string $key )`	`void`	Видаляє значення.
`has( string $key )`	`bool`	Перевіряє, чи існує ключ і чи не минув строк його дії.
`add( string $key, mixed $value, int $ttl = 0 )`	`bool`	Задає значення, лише якщо ключа ще немає (атомарно). Повертає `true`, якщо значення було задано.
`flush()`	`void`	Видаляє всі елементи з кешу. `ApcuCache::flush()` викликає `apcu_clear_cache()`, яка очищає кожен запис APCu на сервері, а не лише записи Queuety.

Вбудовані бекенди

MemoryCache (за замовчуванням)

Queuety\Cache\MemoryCache — кеш на основі масиву, окремий для кожного процесу. Елементи зберігаються в масиві PHP і втрачаються після завершення процесу. Це бекенд за замовчуванням, якщо APCu недоступний.

Для нього не потрібні розширення; він добре підходить для розгортань з одним воркером, а кожен процес воркера ізольований від інших.

ApcuCache

Queuety\Cache\ApcuCache використовує розширення APCu для спільної пам’яті між усіма процесами PHP на одному сервері. До всіх ключів автоматично додається префікс queuety:, щоб уникнути конфліктів з іншими застосунками.

Для цього бекенду потрібне розширення php-apcu. Він спільно використовує записи кешу між воркерами на одному сервері та забезпечує справжню атомарність add() за допомогою apcu_add().

Автоматичне визначення

Queuety\Cache\CacheFactory автоматично вибирає найкращий доступний бекенд:

Якщо apcu_store() існує, а apcu_enabled() повертає true, Queuety використовує ApcuCache. Інакше він переходить до MemoryCache. Це відбувається всередині Queuety::init(), тож для поведінки за замовчуванням не потрібна додаткова конфігурація.

Що кешується

Рівень кешу використовується всередині системи кількома підсистемами:

Дані	Призначення
Стан призупинення черги	Уникає запиту до бази даних на кожній ітерації циклу воркера
Лічильники обмеження частоти	Відстежують кількість виконань у пам’яті, а не в базі даних
Стан робочого процесу	Зменшує кількість читань під час просування багатоетапного робочого процесу
Стан блокування	Прискорює перевірки наявності блокувань для унікальних завдань і проміжного ПЗ mutex

Налаштування TTL

Стандартний TTL кешу становить 5 секунд. Він застосовується до стану призупинення черги та лічильників обмеження частоти; читання статусу й стану робочого процесу кешуються на фіксовані 2 секунди, які ця константа не змінює. Перевизначте стандартне значення константою QUEUETY_CACHE_TTL у вашому wp-config.php:

PHP

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

Менший TTL означає частіші запити до бази даних, але актуальніші дані. Більший TTL зменшує навантаження на базу даних, але збільшує ризик застарілих даних. Для більшості розгортань стандартні 5 секунд — вдалий баланс.

Власний бекенд кешу

Щоб використовувати власний бекенд кешу (Redis, Memcached або будь-який інший), реалізуйте інтерфейс Contracts\Cache і викличте Queuety::set_cache() перед 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 );

Якщо set_cache() викликати перед init(), автоматичне визначення фабрики буде повністю пропущено й використовуватиметься ваш власний бекенд.

Доступ до кешу

Отримати активний екземпляр кешу можна будь-коли:

PHP

$cache = Queuety::cache();

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

Це повертає поточний активний бекенд (MemoryCache, ApcuCache або вашу власну реалізацію).