Поиск объектов кеша

Пулы кеша определяют три метода поиска объектов кеша. Наиболее распространённым методом является getItem($key), который возвращает идентификатор объекта кеша по заданному ключу:

1
2
3
4

use Symfony\Component\Cache\Adapter\FilesystemAdapter;

$cache = new FilesystemAdapter('app.cache');
$latestNews = $cache->getItem('latest_news');

Если для заданного ключа не определено ни одного объекта, метод не возвращает значение null, а возвращает пустой объект, реализующий класс CacheItem.

Если вам нужно извлечь несколько объектов кеша одновременно, то лучше используйте метод getItems(array($key1, $key2, ...)):

1
2

// ...
$stocks = $cache->getItems(array('AAPL', 'FB', 'GOOGL', 'MSFT'));

Опять же, если ни один из ключей не представляет валидный объект кеша, вы не получите значение null,а получите пустой объект CacheItem.

Последний метод, связанный с извлечением объектов кеша, является hasItem($key), который возвращает true, если существует объект кеша, идентифицироанный заданным ключом:

1
2

// ...
$hasBadges = $cache->hasItem('user_'.$userId.'_badges');

Сохранение объектов кеша

Наиболее распространённым методом для сохранения объектов кеша является Psr\\Cache\\CacheItemPoolInterface::save, который сохраняет объект в кеше незамедлительно (возвращает true, если объект был сохранён, или false, если произошла какая-то ошибка):

1
2
3
4

// ...
$userFriends = $cache->getItem('user_'.$userId.'_friends');
$userFriends->set($user->getFriends());
$isSaved = $cache->save($userFriends);

Иногда вам может захотеться не сохранять объекты немедленно, чтобы повысить производительность вашего приложения. В таких случаях, используйте метод Psr\\Cache\\CacheItemPoolInterface::saveDeferred, чтобы отметить объекты кеша, как "готовые к сохранению" и потом вызовите метод Psr\\ache\\CacheItemPoolInterface::commit, когда вы будете готовы сохранить их все:

1
2
3
4
5
6
7
8

// ...
$isQueued = $cache->saveDeferred($userFriends);
// ...
$isQueued = $cache->saveDeferred($userPreferences);
// ...
$isQueued = $cache->saveDeferred($userRecentProducts);
// ...
$isSaved = $cache->commit();

Метод saveDeferred() возвращает true, когда объект кеша был успешно добавлен в "очередь сохранения", и false в других случаях. Метод commit() возвращает true, когда все ожидающие объекты были успешно сохранены, и false в других случаях.

Удаление объектов кеша

Пулы кеша включают методы для удаления объекта кеша, некоторых из них, или всех. Наиболее распространённым является Psr\\Cache\\CacheItemPoolInterface::deleteItem, который удаляет объект кеша, определяемый заданным ключом (возвращает true, когда объект был успешно удалён или не существует, и false в других случаях):

1
2

// ...
$isDeleted = $cache->deleteItem('user_'.$userId);

Используйте метод Psr\\Cache\\CacheItemPoolInterface::deleteItems, чтобы удалять несколько объектов кеша одновременно (возвращает true только, если все объекты были удалены, даже если один или несколько из них не существуют):

1
2

// ...
$areDeleted = $cache->deleteItems(array('category1', 'category2'));

Наконец, чтобы удалить все объекты кеша, хранящиеся в пуле, используйте метод Psr\\Cache\\CacheItemPoolInterface::clear (который возвращает true, когда все объекты были успешно удалены):

1
2

// ...
$cacheIsEmpty = $cache->clear();

1
2
3
4

$ php bin/console cache:pool:delete <cache-pool-name> <cache-key-name>

# deletes the "cache_key" item from the "cache.app" pool
$ php bin/console cache:pool:delete cache.app cache_key

1
2
3
4
5
6
7

$ php bin/console cache:pool:clear <cache-pool-name>

# очищает пул "cache.app"
$ php bin/console cache:pool:clear cache.app

# очищает пул "cache.validation" и "cache.app"
$ php bin/console cache:pool:clear cache.validation cache.app