Установка

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) {
    $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) {
    $item->expiresAfter(3600);
    $item->tag(['tag_0', 'tag_1']);

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

Загальне кешування (PSR-6)

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

Об'єкт

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

Пул

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

Адаптер

Реадізує сам механізм кешування, щоб зберігати інформацію в файловій системі, базі даних та ін. Компонент надає декілька готових до використання адаптерів для розповсюджених бек-ендів кешування (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);

Просунуте використання (PSR-6)