Products.BeakerSessionDataManager 2.1

Description:

Products.BeakerSessionDataManager 2.1

Introduction



Products.BeakerSessionDataManager is a replacement for the default Zope 2
session implementation. It uses Beaker as a backend (via collective.beaker)
and adapts the Beaker session to provide the same interface as a normal Zope
session.
Beaker is a better alternative to the default session implementation for several
reasons:


The Zope session implementation does not perform well in high-write scenarios.
Beaker provides better flexibility in where session data is actually stored.
Beaker is used and maintained outside of the Zope ecosystem.



Note
If you are developing a product that needs sessions but are not already
using Zope sessions, you should probably just use collective.beaker
directly. This product is meant for use with existing add-ons that already
use Zope sessions (i.e. request.SESSION).


Installation

Add the Products.BeakerSessionDataManager egg to your buildout:
[instance]
eggs =
Products.BeakerSessionDataManager

Make sure that buildout adds Beaker configuration to zope.conf. For example:
zope-conf-additional =
<product-config beaker>
session.type file
session.data_dir ${buildout:directory}/var/sessions/data
session.lock_dir ${buildout:directory}/var/sessions/lock
session.key beaker.session
session.secret secret
</product-config>
The “secret” should be replaced with a unique string for your system. It
must be the same for all Zope instances using the same session store.
See the collective.beaker docs for more details on configuration.

In the ZMI, delete the session_data_manager object and add a
Beaker Session Data Manager.



Notes

Beaker does not automatically clean up old sessions, so you may want to set
up a cron job to take care of this.




Contributors

David Glick [davisagli]
Paul Roe [kuetrzi]



Changelog

2.1 (2021-05-12)

Add dict API methods on BeakerSessionDataObject for plone addons compatibility
[mpeeters]



2.0 (2021-05-12)

Python 3 compatibility and drop Python 2.6 compability
[mpeeters]



1.1 (2011-12-05)

Made compatible with Zope 2.10.
[davisagli]



1.0 (2011-06-29)

Add test and fix for missing __len__.
[kuetrzi]



1.0b1 (2011-04-17)

Initial release.
[davisagli]