Установка

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:

use SymfonyComponentCacheAdapterRedisAdapter; use SymfonyComponentCacheDefaultMarshaller; use SymfonyComponentCacheDeflateMarshaller;

$marshaller = new DeflateMarshaller(new DefaultMarshaller()); // вы можете оционально использовать расширение Igbinary, если оно у вас установлено // $marshaller = new DeflateMarshaller(new DefaultMarshaller(useIgbinarySerialize: true));

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

Существуют и другие маршаллеры, которые могут зашифровывать или сжимать данные перед их сохранением.

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