arnaud-23 / cachebundle

Symfony2 Bundle for OpenClassrooms Cache

CacheBundle adds features to Doctrine Cache implementation

• Default lifetime
• Fetch with a namespace
• Save with a namespace
• Cache invalidation through namespace strategy
• CacheProvider Builder

See OpenClassrooms/Cache for more details.

Installation

This bundle can be installed using composer:

composer require jms/serializer-bundle or by adding the package to the composer.json file directly.

{
    "require": {
        "openclassrooms/cache-bundle": "*"
    }
}

After the package has been installed, add the bundle to the AppKernel.php file:

// in AppKernel::registerBundles()
$bundles = array(
    // ...
    new OpenClassrooms\Bundle\CacheBundle\OpenClassroomsCacheBundle(),
    // ...
);

Configuration

open_classrooms_cache:
    default_lifetime: 10    (optional, default = 0)
# Providers
    # array
    provider: array
    # memcache
    provider:
        memcache:
            host: localhost
            port: 11211     (optional, default = 11211)
            timeout: 0      (optional, default = 0)
    # memcached
    provider:
        memcached:
            host: localhost
            port: 11211     (optional, default = 11211)
    # redis            
    provider:
        redis:
            host: localhost
            port: 6379      (optional, default = 6379)
            timeout: 0.0    (optional, default = 0.0)

Usage

The configured cache is available as openclassrooms.cache.cache service:

$cache = $container->get('openclassrooms.cache.cache');

$cache->fetch($id);
$cache->fetchWithNamespace($id, $namespaceId);
$cache->save($id, $data);
$cache->saveWithNamespace($id, $data, $namespaceId);
$cache->invalidate($namespaceId);

The configured cache provider is available as openclassrooms.cache.cache_provider service:

$cacheProvider = $container->get('openclassrooms.cache.cache_provider');

The cache provider builder is available as openclassrooms.cache.cache_provider service:

$builder = $container->get('openclassrooms.cache.cache_provider_builder');

// Redis
$cacheProvider = $builder
    ->create(CacheProviderType::REDIS)
    ->withHost('127.0.0.1')
    ->withPort(6379) // Default 6379
    ->withTimeout(0.0) // Default 0.0
    ->build();

See OpenClassrooms/Cache for more details.