Package Exports

session-file-store

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (session-file-store) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

session-file-store

Session file store for Express and Connect. Also you can use it with Koa

Session file store is a provision for storing session data in the session file

Compatibility

Supports Express >= 4.x and Connect >= 1.4.0 through express-session
Supports Node.js >= 0.10 and io.js
Indirectly supports Koa >= 0.9.0 through express-session

Getting Started

Installation

$ npm install session-file-store

Running Tests

$ npm install
$ npm test

Options

path The directory where the session files will be stored. Defaults to ./sessions
ttl Session time to live in seconds. Defaults to 3600
retries The number of retries to get session data from a session file. Defaults to 5
factor The exponential factor to use for retry. Defaults to 1
minTimeout The number of milliseconds before starting the first retry. Defaults to 50
maxTimeout The maximum number of milliseconds between two retries. Defaults to 100
reapIntervalObject [OUT] Contains intervalObject if reap was scheduled
reapInterval Interval to clear expired sessions in seconds or -1 if do not need. Defaults to 1 hour
reapAsync use distinct worker process for removing stale sessions. Defaults to false
reapSyncFallback reap stale sessions synchronously if can not do it asynchronously. Default to false
logFn log messages. Defaults to console.log
fallbackSessionFn returns fallback session object after all failed retries. No defaults
encrypt Enables encryption of the session before writing the file and also decryption when reading it.

Usage

Express or Connect integration

Due to express >= 4 changes, we need to pass express-session to the function session-file-store exports in order to extend session.Store:

var session = require('express-session');
var FileStore = require('session-file-store')(session);

app.use(session({
    store: new FileStore(options),
    secret: 'keyboard cat'
}));

Examples

You can found basic work app examples for express, connect and koa frameworks in examples folder.