NAME

Catalyst::Plugin::Session::Store::MongoDB - MongoDB session store for Catalyst

SYNOPSIS

In your MyApp.pm:

use Catalyst qw/
  Session
  Session::Store::MongoDB
  Session::State::Cookie # or similar
/;

and in your MyApp.conf:

<Plugin::Session>
  <client_options>             # if empty, lets MongoDB::MongoClient
    host mongodb://foo:27017   #   use its own defaults
    timeout 10000              # if unspecified, defaults to
    ...                        #   { host => hostname, port => port }
  </client_options>            #   for compatibility with previous versions
  dbname test                  # defaults to catalyst
  collectionname s2            # defaults to session
</Plugin::Session>

Then you can use it as usual:

$c->session->{foo} = 'bar'; # will be saved

DESCRIPTION

Catalyst::Plugin::Session::Store::MongoDB is a session storage plugin using MongoDB (http://www.mongodb.org) as its backend.

CONFIGURATION

client_options

Options passed to MongoDB::MongoClient->new(). If a reference to an empty hash is provided, lets MongoDB::MongoClient use its own defaults.

If left unspecified, defaults to the following for compatibility with previous versions of this module:

{
  host => $self->hostname,
  port => $self->port
}

dbname

Name of the database in which to store session data. Defaults to catalyst.

collectioname

Name of the collection in which to store session data. Defaults to session.

hostname, port

Deprecated: use client_options instead. Default to localhost and 27017, when used as default for an unspecified client_options for compatibility with previous versions of this module.

USAGE

See Catalyst::Plugin::Session and Catalyst::Plugin::Session::Store.

Expired Sessions

When getting session data, this store automatically deletes the session if it has expired. Additionally this store implements the optional delete_expired_sessions() method.

AUTHORS

Ronald J Kimball, <rjk@tamias.net>

Stefan Völkel, <bd@bc-bd.org> <http://bc-bd.org>

Cory G Watson, <gphat at cpan.org>

LICENSE

Copyright 2010 Stefan Völkel <bd@bc-bd.org>

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License v2 or (at your option) any later version, as published by the Free Software Foundation; or the Artistic License.