README

A simple sentinel/redis driver wrapper for laravel.

The default laravel redis driver supports redis clusters, however, it does not support high availability with redis, which is where Laravel-PSRedis comes to the rescue.

With Laravel-PSRedis you'll get all the laravel redis magic that you aleady have such as Redis::set() and Redis::get(), and even session, queue, and cache support using redis, you'll just be able to leverage High Avaliability redis instances instead of a simple cluster.

We do this by asking your Redis Sentinels the location of your master before creating our Redis bindings in the IOC Container. By doing this we ensure anytime your app has a connection to your redis instance, that connection is to master.

## Installation ### Installation for Laravel 5

You can install Laravel-PSRedis easily with composer.

	"require": {  
        "itryit/laravel-ps-redis": "v2.2",
    },

## Configuration

Next, just fill in your sentinel/redis server info in the app/config/database.php config files that already exist in your application.

You may already have some default laravel config values in place in your database config file that looks like this.

/*
	|--------------------------------------------------------------------------
	| Redis Databases
	|--------------------------------------------------------------------------
	|
	| Redis is an open source, fast, and advanced key-value store that also
	| provides a richer set of commands than a typical key-value systems
	| such as APC or Memcached. Laravel makes it easy to dig right in.
	|
	*/
	'redis' => [
		'cluster' => false,
		'default' => [
			'host'     => '127.0.0.1',
			'port'     => 6379,
			'database' => 0,
		],
	],

Just overwrite those with the values below and fill in your server info.

	/** redisConfigName config is supported since version 2.2 */
	'redisConfigName' => 'redis', // your redis setting key name, 'redis' for default, this would be compatible with past versions

	'redis' => [

   		/** the name of the redis node set */
    	'nodeSetName' => 'your-sentinel-node-set-name',

    	'cluster' => false,

    	/** database config is supported since version 2.1 */
    	'database' => 0, // redis database choice

	    /** Array of sentinels */
	    'masters' => [
	        [
	            'host' => 'sentinel-instance.domain.com',
	            'port' => '26379',
	        ],
	        [
            	'host' => 'sentinel-instance.domain.com',
        	    'port' => '26379',
    	    ]
	    ],
    
    	/** how long to wait and try again if we fail to connect to master */
	    'backoff-strategy' => [
			'max-attempts' => 10, // the maximum-number of attempt possible to find master
			'wait-time' => 500,   // miliseconds to wait for the next attempt
			'increment' => 1.5, // multiplier used to increment the back off time on each try
    	]
    ];

### The Service Provider

Finally, you just need to add the service provider to the providers array in app.php and comment or remove the redis service provider.

	/*
    |--------------------------------------------------------------------------
    | Autoloaded Service Providers
    |--------------------------------------------------------------------------
    |
    */
	'providers' => [
		...
		// 'Illuminate\Redis\RedisServiceProvider', # comment this out
		'Itryit\LaravelPSRedisHelper\LaravelPSRedisServiceProvider' # add this
	],

Note: you may have to composer dump-autoload after adding the service provider

## Contributing

Fork it
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -m 'Added some feature')
Push to the branch (git push origin my-new-feature)
Create new Pull Request

## Testing

Feel free to clone the repo and run the unit tests locally.

	./vendor/bin/phpunit -c ./phpunit.xml

## License [The MIT License (MIT)](https://github.com/iTryIt/laravel-PSRedis/blob/master/LICENSE)

itryit / laravel-ps-redis

Maintainers

Details

README

README Contents