cache-pool-fixtures.md

Cache Pool Fixtures

The Cache Pool Fixtures allows you to load data fixtures for any implementation of the PSR-6 standard.

Install

Before starting loading Cache Pool Fixtures make sure to add PSR-6 as a dependency of your project.

composer require psr/cache

How to load Cache Pool Fixtures?

1. Create fixture classes

The first step to load Cache Pool Fixtures is to create fixtures classes. This classes must implement the CachePoolFixtureInterface.

<?php
declare(strict_types=1);

use Kununu\DataFixtures\Adapter\CachePoolFixtureInterface;
use Psr\Cache\CacheItemPoolInterface;

final class MyFixture implements CachePoolFixtureInterface
{
    public function load(CacheItemPoolInterface $cachePool): void
    {
        $item = $cachePool->getItem('a_key');
        $item->set('a_value');
        $cachePool->save($item);
    }
}

2. Load fixtures

In order to load the fixtures that you created in the previous step you will need to configure the CachePoolExecutor.

<?php
declare(strict_types=1);

use Kununu\DataFixtures\Executor\CachePoolExecutor;
use Kununu\DataFixtures\Loader\CachePoolFixturesLoader;
use Kununu\DataFixtures\Purger\CachePoolPurger;
use Memcached;
use Symfony\Component\Cache\Adapter\MemcachedAdapter;

$memcached = new Memcached();
$memcached->addServer('localhost', 11211);

$cache = new MemcachedAdapter($memcached);

$purger = new CachePoolPurger($cache);

$executor = new CachePoolExecutor($cache, $purger);

$loader = new CachePoolFixturesLoader();
$loader->addFixture(new MyFixture());

$executor->execute($loader->getFixtures());
// If you want you can `append` the fixtures instead of purging the cache pool
$executor->execute($loader->getFixtures(), true);

If you want to know more options on how you can load fixtures in the Loader checkout Load Fixtures.

3. Append Fixtures

By default, when loading fixtures the cache storage is purged. If you want to change this behavior and instead append the fixtures, you can pass true as second argument to the CachePoolExecutor.

<?php
declare(strict_types=1);

use Kununu\DataFixtures\Executor\CachePoolExecutor;

$executor = new CachePoolExecutor($cache, $purger);

// If you want you can `append` the fixtures instead of purging the cache storage
$executor->execute($loader->getFixtures(), true);