Установка

1

$ composer require symfony/cache

Контракты кеша против PSR-6

Данный компонент включает в себя два разных подхода к кешированию:

Кеширование PSR-6 :

Базовая система кеширования, которая включает в себя "пулы" и "объекты" кеша.

Контракты кеширования :

Более простой, но при этом более мощный способ хранить значения кеша, основываясь на обратных вызовах повторных вычислений.

Контракты кеширования

Все адаптеры поддерживают Контракты кеширования. Они содержат только два метода: get() и delete(). Метода set() нет, так как метод get() как получает, так и устанавливает значения кеша.

Первое, что вам нужно сделать, - инстанциировать адаптер кеша. В этом примере используется FilesystemAdapter:

1
2
3

use Symfony\Component\Cache\Adapter\FilesystemAdapter;

$cache = new FilesystemAdapter();

Теперь вы можете извлекать и удалять кешированные данные, используя этот объект. Первый аргумент метода get() - это ключ, произвольная строка, которую вы ассоциируете с кешированным значением, чтобы вы могли извлечь его позже. Второй аргумент - PHP-вызываемое, которое выполняется, когда ключ не найден в коде, чтобы сгенерировать и вернуть значение:

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

use Symfony\Contracts\Cache\ItemInterface;

// Вызываемое будет выполнено только в случае неудачи кеша.
$value = $cache->get('my_cache_key', function (ItemInterface $item): string {
    $item->expiresAfter(3600);

    // ... выполнить какой-то HTTP-запрос или сложные вычисления
    $computedValue = 'foobar';

    return $computedValue;
});

echo $value; // 'foobar'

// ... и удалить ключ кеша
$cache->delete('my_cache_key');

1
2
3
4
5
6
7
8
9

use Symfony\Contracts\Cache\ItemInterface;

$beta = 1.0;
$value = $cache->get('my_cache_key', function (ItemInterface $item): string {
    $item->expiresAfter(3600);
    $item->tag(['tag_0', 'tag_1']);

    return '...';
}, $beta);

Общее кеширование (PSR-6)

Чтобы использовать общие возможности кеширования PSR-6, вам понадобится выучить его ключевые концепты:

Объект

Одна единица информации, хранящаяся в виде пары ключ-значение, где ключ - уникальный идентификатор информации, а значение - его содержимое; см. статью Объекты кеша, чтобы узнать больше.

Пул

Логическое хранилище объектов кеша.Все операции кеша (сохранение объектов, поиск объектов и др.) выполняются через пул. Приложения могут определять столько пулов, сколько необходимо.

Адаптер

Реализует сам механизм кеширования, чтобы хранить информацию в файловой системе, DB и др. Компонент предоставляет несколько готовых к использованию адаптеров для распространённых бэк-эндов кеширования (Redis, APCu, Doctrine, PDO, и т.д.)

Базовое применение (PSR-6)

Эта часть компонента является реализацией PSR-6, что означает, что его базовый API совпадает с определённым в стандарте. До того, как кешировать информацию, создайте пул кеша, используя любые встроенные адаптеры. Например, чтобы создать кеш, основанный на файловой системе, инстанциируйте FilesystemAdapter:

1
2
3

use Symfony\Component\Cache\Adapter\FilesystemAdapter;

$cache = new FilesystemAdapter();

Теперь вы можете создавать, извлекать, обновлять и удалять объекты, используя этот пул кеша:

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

// создайте новый объект, пытаясь получить его из кеша
$productsCount = $cache->getItem('stats.products_count');

// назначьте значение объекту и сохраните его
$numProducts->set(4711);
$cache->save($numProducts);

// извлеките объект кеша
$productsCount = $cache->getItem('stats.products_count');
if (!$productsCount->isHit()) {
    // ... объект не существует в кеше
}
// извлеките значение, хранимое объектом
$total = $productsCount->get();

// удалите объект кеша
$cache->deleteItem('stats.products_count');

Чтобы увидеть список всех поддерживаемых адаптеров, см. Пулы кеша и поддерживаемые адаптеры.

Маршаллинг (сериализация) данных

Symfony использует маршалеров (классы, реализующие MarshallerInterface), чтобы обрабатывать объекты кеширования перед их сохранением.

DefaultMarshaller использует serialize() или igbinary_serialize() PHP, если установлено расширение Igbinary. Есть и другие маршалеры, которые зашифровывают или сжимают данные перед их сохранением:

1
2
3
4
5
6

use Symfony\Component\Cache\Adapter\RedisAdapter;
use Symfony\Component\Cache\DefaultMarshaller;
use Symfony\Component\Cache\DeflateMarshaller;

$marshaller = new DeflateMarshaller(new DefaultMarshaller());
$cache = new RedisAdapter(new \Redis(), 'namespace', 0, $marshaller);

Продвинутое использование