Ruby on Rails latest stable (v6.1.7.7) - 2 notes - Superclass: ActionController::Session::AbstractStore

Class deprecated or moved

This class is deprecated or moved on the latest stable version. The last existing version (v3.2.13) is shown here.

Active Record Session Store

A session store backed by an Active Record class. A default class is provided, but any object duck-typing to an Active Record Session class with text session_id and data attributes is sufficient.

The default assumes a sessions tables with columns:

+id+ (numeric primary key),
+session_id+ (text, or longtext if your session data exceeds 65K), and
+data+ (text or longtext; careful if your session data exceeds 65KB).

The session_id column should always be indexed for speedy lookups. Session data is marshaled to the data column in Base64 format. If the data you write is larger than the column’s size limit, ActionController::SessionOverflowError will be raised.

You may configure the table name, primary key, and data column. For example, at the end of config/application.rb:

ActiveRecord::SessionStore::Session.table_name = 'legacy_session_table'
ActiveRecord::SessionStore::Session.primary_key = 'session_id'
ActiveRecord::SessionStore::Session.data_column_name = 'legacy_session_data'

Note that setting the primary key to the session_id frees you from having a separate id column if you don’t want it. However, you must set = session.session_id by hand! A before filter on ApplicationController is a good place.

Since the default class is a simple Active Record, you get timestamps for free if you add created_at and updated_at datetime columns to the sessions table, making periodic session expiration a snap.

You may provide your own session class implementation, whether a feature-packed Active Record or a bare-metal high-performance SQL store, by setting

ActiveRecord::SessionStore.session_class = MySessionClass

You must implement these methods:

initialize(hash_of_session_id_and_data, options_hash = {})
attr_reader :session_id
attr_accessor :data

The example SqlBypass class is a generic SQL session store. You may use it as a basis for high-performance database-specific stores.


SESSION_RECORD_KEY = 'rack.session.record'



Show files where this class is defined (1 file)
Register or log in to add new notes.
March 23, 2009
4 thanks

So, how do you enable db sessions?

First, run:

rake db:sessions:create

Then, run your pending migrations. This will create the migration you need to run in order to create the sessions table.

Second, go into config/environment.rb and uncomment or put in:

config.action_controller.session_store = :active_record_store
config.action_controller.session = {
   :session_key => '_your_session_name_here',

Third, get yourself a secure key with:

rake secret

And finally, paste your new key into the :secret above.

February 25, 2010
2 thanks

configuration no longer in environment.rb

configure session store in config/initializers/session_store.rb