README

Memcached is a cache package using Memcache as backend.

Phapi has one important rule regarding cache: A working cache should **not** be a requirement for the application to work. So if Phapi is unable to connect to the cache backend it wont stop the execution. Instead the configured cache will be replaced with a dummy cache, new NullCache().

Memcache or Memcached?

Please note that there are two cache provider packages available: phapi/cache-memcache and phapi/cache-memcached. The difference between the packages is the PHP extension they use.

So which one should you use?

It depends on two things:

Which extension do you have installed?
PHP version. Both the Memcache extension and the Memcached exists for PHP 5.6 and HHVM. But according to the gophp7 project extension catalog only Memcached will be updated to PHP 7.

Installation

The package is not installed by default by the Phapi framework. Add the package as a dependency in composer to install the package.

$ composer require phapi/cache-memcached:1.*

Configuration

Configure the package and add it to the container to enable it.

<?php
$container['cache'] = function ($container) {
    return new \Phapi\Cache\Memcached($servers = [
        [
            'host' => 'localhost',
            'port' => 11211
        ]
    ]);
};

Add as many memcache servers as you want by extending the array.

See the configuration documentation for more information about how to configure the integration with the Phapi Framework.

General cache usage

<?php
// Add something to the cache
$cache->set('test', 'value');

// Read something from the cache
echo $cache->get('test'); // Will echo "value"

// Check if something exists in the cache
$bool = $cache->has('test');

// Remove from cache
$cache->clear('test');

// Flush the cache
$cache->flush();

Phapi

This middleware is a Phapi package used by the Phapi Framework. The middleware are also PSR-7 compliant and implements the Phapi Middleware Contract.

License

Memcached Cache Provider is licensed under the MIT License - see the license.md file for details

Contribute

Contribution, bug fixes etc are always welcome.

phapi / cache-memcached

Maintainers

Details