kuikui/memcache-service-provider

Memcache integration for Silex.

Memcache service provider for Silex 2.x

, _(*1)

It provides access to : * a simple Memcache wrapper with very simple API for standard use, * or your own Memcache wrapper with $app injection for custom use, * or a genuine Memcache(d) object for advanced use., _(*2)

Installation

Create a composer.json in your projects root-directory :, _(*3)

{
    "require": {
        "kuikui/memcache-service-provider": "~2.0"
    }
}

and run :, _(*4)

$ curl -sS http://getcomposer.org/installer | php
$ php composer.phar install

Registering

$app->register(new KuiKui\MemcacheServiceProvider\ServiceProvider());

Example

$app->register(new KuiKui\MemcacheServiceProvider\ServiceProvider());

// Simple use
$app['memcache']->set('key', 'value');
$value = $app['memcache']->get('key');
$app['memcache']->delete('key');

// Advanced use : use \Closure to generate default value and save it during a retrieve process
$value = $app['memcache']->get('key', function() use ($app) {
    return $app['some_other_service']->getData();
});

Options

After registration, you can customize the service with these options :, _(*5)

Connections

Allows you to set up one or more Memcache connections.
Each connection should be defined as follows array('ip_address', port)., _(*6)

$app['memcache.connections'] = array(
    array('127.0.0.1', 11211),
    array('10.0.1.118', 12345)
; // default: array('127.0.0.1', 11211)

Class

Allows you to choose between the two PHP Memcache libraries : \Memcache or \Memcached., _(*7)

$app['memcache.class'] = '\Memcached'; // default: '\Memcache'

Wrapper

• By default, you access to an instance of KuiKui\MemcacheServiceProvider\SimpleWrapper.
• For custom needs, you can use your own wrapper :

$app['memcache.wrapper'] = '\My\Custom\Wrapper';

• Or you can have direct acces to Memcache(d) object :

$app['memcache.wrapper'] = false;

Duration

If you use SimpleWrapper, you can configure the default duration of cached data (in seconds):, _(*8)

$app['memcache.default_duration'] = 60; // default: 0 (no limit)

Running the tests

The development environment is provided by Vagrant and the Xotelia box., _(*9)

$ cp Vagrantfile.dist Vagrantfile
$ vagrant up
$ vagrant ssh

$ cd /vagrant
$ composer install
$ ./vendor/bin/atoum

Dependencies

PHP 5.5+, _(*10)

MemcacheServiceProvider needs one of these PHP modules to be installed : * memcache * memcached, _(*11)

Credits

Deeply inspired by MemcacheServiceProvider from Rafał Filipek.
Tested with atoum., _(*12)

License

The MemcacheServiceProvider is licensed under the MIT license., _(*13)