Доступні опції

class (тип: string, за замовчуванням: null)

Вказує бібліотеку підключення для повернення: \Redis, \Relay\Relay або \Predis\Client. Якщо жодна з них не вказана, буде використано запасне значення у наступному порядку, залежно від того, яке з них доступне першим: \Redis, \Relay\Relay, \Predis\Client. Ясно встановіть значення \Predis\Client для Sentinel, якщо ви зіткнулися з проблемами при отриманні основної інформації.

persistent (тип: int, за замовчуванням: 0)

Підключає чи відключає використання персистентних з'єднань. Значення 0 відключає персистентні з'єднання, а значення 1 - включає.

persistent_id (тип: string|null, за замовчуванням: null)

Вказує персистентний id рядку, що використовується для персистентного з'єднання.

timeout (тип: int, за замовчуванням: 30)

Вказує час (в секундах), що використовується для підключення до серверу Redis до тайм-ауту спроби з'єднання.

read_timeout (тип: int, за замовчуванням: 0)

Вказує час (в секундах), який використовується при виконанні операцій читання в основному джерелі мережі до тайм-ауту операції.

retry_interval (тип: int, за замовчуванням: 0)

Вказує проміжок (в мілісекундах) між спробами повторного з'єднання у випадку, якщо клієнт втратить зв'язок з сервером.

tcp_keepalive (тип: int, за замовчуванням: 0)

Вказує тайм-аут TCP-keepalive з'єднання (в секундах). Це вимагає phpredis v4 або вище, та серверу з включеним TCP-keepalive.

lazy (тип: bool, за замовчуванням: null)

Включає або відключає ліниві зʼєднання з бекендом. За замовчуванням false, при використанні в якості окремого компонента, і true за замовчуванням, при використанні всередині додатку Symfony.

redis_cluster (тип: bool, за замовчуванням: false)

Включає або відключає кластер redis. Реальне передане значення не важливе, якщо воно передає перевірки вільного порівняння: `redis_cluster=1` буде достатньо.

redis_sentinel (тип: string, за замовчуванням: null)

Вказує основне імʼя, зʼєднане з вартовими.

sentinel_master (тип: string, за замовчуванням: null)

Псевдонім опції redis_sentinel.

dbindex (тип: int, за замовчуванням: 0)

Вказує індекс дати бази для вибору.

failover (тип: string, за замовчуванням: none)

Вказує відмовостійкість для реалізацій кластеру. Для \RedisCluster валідними опціями є: none (за замовчуванням), error, distribute або slaves. Для \Predis\ClientInterface валідні опції - slaves або distribute.

ssl (тип: array, за замовчуванням: null)

Опції контексту SSL. Див. php.net/context.ssl, щоб дізнатися більше.

relay_cluster_context (тип: array, за замовчуванням: [])

Визначає опції конфігурації, специфічні для \Relay\Cluster. Наприклад, щоб
використати самопідписаний сертифікат для тестування у локальному середовищі:

1
2
3
4
5
6
7
8
9
10
11
12
13
14

$options = [
    // ...
    'relay_cluster_context' => [
        // ...
        'stream' => [
            'verify_peer' => false,
            'verify_peer_name' => false,
            'allow_self_signed' => true,
            'local_cert' => '/valkey.crt',
            'local_pk' => '/valkey.key',
            'cafile' => '/valkey.crt',
        ],
    ],
];

TagAwareMarshaller для кешування, заснованого на тегах

Оптимізує кешування для вилучення за тегами, дозволяючи ефективно управляти пов'язаними елементами:

1
2
3
4
5
6
7

$marshaller = new TagAwareMarshaller();

$cache = new RedisAdapter($redis, 'tagged_namespace', 3600, $marshaller);

$item = $cache->getItem('tagged_key');
$item->set(['value' => 'some_data', 'tags' => ['tag1', 'tag2']]);
$cache->save($item);

SodiumMarshaller для зашифрованого кешування

Шифрує кешовані дані за допомогою Sodium для підвищення безпеки:

1
2
3
4
5
6
7
8

$encryptionKeys = [sodium_crypto_box_keypair()];
$marshaller = new SodiumMarshaller($encryptionKeys);

$cache = new RedisAdapter($redis, 'secure_namespace', 3600, $marshaller);

$item = $cache->getItem('secure_key');
$item->set('confidential_data');
$cache->save($item);

DefaultMarshaller з серіалізацією igbinary

Використовує igbinary для швидшої та ефективнішої серіалізації, якщо це доступно:

1
2
3
4
5
6
7

$marshaller = new DefaultMarshaller(true);

$cache = new RedisAdapter($redis, 'optimized_namespace', 3600, $marshaller);

$item = $cache->getItem('optimized_key');
$item->set(['data' => 'optimized_data']);
$cache->save($item);

DefaultMarshaller з виключенням при невдачі

Викликає виключення, якщо серіалізація завершиться невдало, полегшуючи обробку помилок:

1
2
3
4
5
6
7
8
9
10
11

$marshaller = new DefaultMarshaller(false, true);

$cache = new RedisAdapter($redis, 'error_namespace', 3600, $marshaller);

try {
    $item = $cache->getItem('error_key');
    $item->set('data');
    $cache->save($item);
} catch (\ValueError $e) {
    echo 'Serialization failed: '.$e->getMessage();
}

SodiumMarshaller з ротацією ключів

Підтримує ротацію ключів, забезпечуючи безпечне розшифрування як зі старими, так і з новими ключами:

1
2
3
4
5
6
7
8

$keys = [sodium_crypto_box_keypair(), sodium_crypto_box_keypair()];
$marshaller = new SodiumMarshaller($keys);

$cache = new RedisAdapter($redis, 'rotated_namespace', 3600, $marshaller);

$item = $cache->getItem('rotated_key');
$item->set('data_to_encrypt');
$cache->save($item);