rchavik / cakephp-redis-session

CakePHP Redis Session Store

Redis Session Store for CakePHP

This class can be used in CakePHP and saves session data into Redis, an open source key-value store.

Installation

1. Place the redis_session.php into [yourapp]/config/.

2. Open [yourapp]/config/core.php and find 'Session.save'.

3. Change the value of the Configure call so that it looks like this:

   Configure::write('Session.save', 'redis_session');

That's it.

Usage

Redis on localhost

If you have a default Redis installation running on localhost you don't need to change anything. It will connect and take over.

To confirm that it does indeed write to Redis you can use redis-cli monitor and refresh your browser. You should see some GET and SETEX calls.

Redis on a foreign host

If you run on a different host you have to add two config settings in your core.php to setup the connection.

Configure::write('RedisSession.hostname', 'some.host.name');
Configure::write('RedisSession.port', 1337);

About

I've ran the core component tests with this store enabled (CakePHP 1.3.10).

The class comes with iRedis, a very lightweight Redis Library by Dan Horrigan. The library is embedded inside the source file, wrapped in a class_exists() condition. If you want to use your own version make sure to include it early or just delete the iRedis block. I leave that up to you. I wanted to keep this store small.

Garbage collection is handled by Redis. I use SETEX (expire) when writing to the store. The key will delete itself when the session expires. You can verify the remaining time with TTL [key].

I have no complex key-namespacing going on. The key however is prefixed with the session name ('Session.cookie' value) followed by the session_id()

The cookie.path is hardcoded to '/'

Enjoy!