# Rack::Session, Rack::Cache and cache Redis stores for Ruby web frameworks

## Installation

Download and install Redis from [http://code.google.com/p/redis/](http://code.google.com/p/redis/)

    wget http://redis.googlecode.com/files/redis-2.0.0-rc1.tar.gz
    tar -zxf redis-2.0.0-rc1.tar.gz
    mv redis-2.0.0-rc1 redis
    cd redis
    make

Install the gem

    sudo gem install redis-store

## Cache store

Provides a cache store for your Ruby web framework of choice.

### Rails 2.x

    config.gem "redis-store"
    config.cache_store = :redis_store

### Rails 3.x

    # Gemfile
    gem 'rails', '3.0.0.beta4'
    gem 'redis'
    gem 'redis-store', '1.0.0.beta1'

    # config/environments/production.rb
    config.cache_store = :redis_store

### Merb

    dependency "redis-store", "1.0.0.beta1"
    dependency("merb-cache", merb_gems_version) do
      Merb::Cache.setup do
        register(:redis, Merb::Cache::RedisStore, :servers => ["127.0.0.1:6379"])
      end
    end

### Sinatra

    require "sinatra"
    require "redis-store"
    class MyApp < Sinatra::Base
      register Sinatra::Cache
      get "/hi" do
        cache.fetch("greet") { "Hello, World!" }
      end
    end

## Rack::Session

Provides a Redis store for Rack::Session. See [http://rack.rubyforge.org/doc/Rack/Session.html](http://rack.rubyforge.org/doc/Rack/Session.html)

### Rack application

    require "rack"
    require "redis-store"
    require "application"
    use Rack::Session::Redis
    run Application.new

### Rails 2.x

    config.gem "redis-store"
    ActionController::Base.session_store = :redis_session_store

### Rails 3.x

    # Gemfile
    gem 'rails', '3.0.0.beta4'
    gem 'redis'
    gem 'redis-store', '1.0.0.beta1'

    # config/initializers/session_store.rb
    Rails.application.config.session_store :redis_session_store

### Merb

    dependency "redis-store", "1.0.0.beta1"
    Merb::Config.use do |c|
      c[:session_store] = "redis"
    end
    Merb::BootLoader.before_app_loads do
      Merb::SessionContainer.subclasses << "Merb::RedisSession"
    end

### Sinatra

    require "sinatra"
    require "redis-store"

    class MyApp < Sinatra::Base
      use Rack::Session::Redis

      get "/" do
        session[:visited_at] = DateTime.now.to_s # This is stored in Redis
        "Hello, visitor."
      end
    end

## Rack::Cache

Provides a Redis store for HTTP caching. See [http://github.com/rtomayko/rack-cache](http://github.com/rtomayko/rack-cache)

    require "rack"
    require "rack/cache"
    require "redis-store"
    require "application"
    use Rack::Cache,
      :metastore   => 'redis://localhost:6379/0',
      :entitystore => 'redis://localhost:6380/1'
    run Application.new

## Running specs

    gem install jeweler bundler
    git clone git://github.com/jodosha/redis-store.git
    cd redis-store
    bundle install
    REDIS_STORE_ENV=rails3 bundle install # to install Rails 3.x gems
    rake dtach:install
    rake redis:install
    rake
    REDIS_STORE_ENV=rails3 rake # to test against Rails 3.x

If you are on **Snow Leopard** you have to run `env ARCHFLAGS="-arch x86_64" bundle install`

## Copyright

(c) 2010 Luca Guidi - [http://lucaguidi.com](http://lucaguidi.com), released under the MIT license