Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

dancer::session::yaml(3pm) [debian man page]

Dancer::Session::YAML(3pm)				User Contributed Perl Documentation				Dancer::Session::YAML(3pm)

Dancer::Session::YAML - YAML-file-based session backend for Dancer DESCRIPTION
This module implements a session engine based on YAML files. Session are stored in a session_dir as YAML files. The idea behind this module was to provide a transparent session storage for the developer. This backend is intended to be used in development environments, when looking inside a session can be useful. It's not recommended to use this session engine in production environments. CONFIGURATION
The setting session should be set to "YAML" in order to use this session engine in a Dancer application. Files will be stored to the value of the setting "session_dir", whose default value is "appdir/sessions". Here is an example configuration that use this session engine and stores session files in /tmp/dancer-sessions session: "YAML" session_dir: "/tmp/dancer-sessions" METHODS
reset to avoid checking if the sessions directory exists everytime a new session is created, this module maintains a cache of session directories it has already created. "reset" wipes this cache out, forcing a test for existence of the sessions directory next time a session is created. It takes no argument. This is particulary useful if you want to remove the sessions directory on the system where your app is running, but you want this session engine to continue to work without having to restart your application. DEPENDENCY
This module depends on YAML. AUTHOR
This module has been written by Alexis Sukrieh, see the AUTHORS file for details. SEE ALSO
See Dancer::Session for details about session usage in route handlers. COPYRIGHT
This module is copyright (c) 2009 Alexis Sukrieh <> LICENSE
This module is free software and is released under the same terms as Perl itself. perl v5.14.2 2011-11-30 Dancer::Session::YAML(3pm)

Check Out this Related Man Page

Dancer::Session(3pm)					User Contributed Perl Documentation				      Dancer::Session(3pm)

Dancer::Session - session engine for the Dancer framework DESCRIPTION
This module provides support for server-side sessions for the Dancer web framework. The session is accessible to the user via an abstraction layer implemented by the Dancer::Session class. USAGE
Configuration The session engine must be first enabled in the environment settings, this can be done like the following: In the application code: # enabling the YAML-file-based session engine set session => 'YAML'; Or in config.yml or environments/$env.yml session: "YAML" By default sessions are disabled, you must enable them before using it. If the session engine is disabled, any Dancer::Session call will throw an exception. See "Configuration" in Dancer::Session::Abstract for more configuration options. Route Handlers When enabled, the session engine can be used in a route handler with the keyword session. This keyword allows you to store/retrieve values from the session by name. Storing a value into the session: session foo => 'bar'; Retrieving that value later: my $foo = session 'foo'; You can either look for an existing item in the session storage or modify one. Here is a simple example of two route handlers that implement basic "/login" and "/home" actions using the session engine. post '/login' => sub { # look for params and authenticate the user # ... if ($user) { session user_id => $user->id; } }; get '/home' => sub { # if a user is present in the session, let him go, otherwise redirect to # /login if (not session('user_id')) { redirect '/login'; a }; Of course, you probably don't want to have to duplicate the code to check whether the user is logged in for each route handler; there's an example in the Dancer::Cookbook showing how to use a before filter to check whether the user is logged in before all requests, and redirect to a login page if not. SUPPORTED ENGINES
Dancer has a modular session engine that makes implementing new session backends pretty easy. If you'd like to write your own, feel free to take a look at Dancer::Session::Abstract. The following engines are supported out-of-the-box (shipped with the core Dancer distribution): Dancer::Session::YAML A YAML file-based session backend, pretty convenient for development purposes, but maybe not the best for production needs. Dancer::Session::Simple A very simple session backend, holding all session data in memory. This means that sessions are volatile, and no longer exist when the process exits. This module is likely to be most useful for testing purposes, and of little use for production. Additionally, many more session engines are available from CPAN, including: Dancer::Session::Memcached Session are stored in Memcached servers. This is good for production matters and is a good way to use a fast, distributed session storage. If you may be scaling up to add additional servers later, this will be a good choice. Dancer::Session::Cookie This module implements a session engine for sessions stored entirely inside encrypted cookies (this engine doesn't use a server-side storage). Dancer::Session::Storable This backend stores sessions on disc using Storable, which offers solid performance and reliable serialisation of various data structures. Dancer::Session::MongoDB A backend to store sessions using MongoDB Dancer::Session::KiokuDB A backend to store sessions using KiokuDB Dancer::Session::PSGI Let Plack::Middleware::Session handle sessions; may be useful to share sessions between a Dancer app and other Plack-based apps. DEPENDENCY
Dancer::Session may depend on third-party modules, depending on the session engine used. See the session engine module for details. AUTHORS
This module has been written by Alexis Sukrieh. See the AUTHORS file that comes with this distribution for details. LICENSE
This module is free software and is released under the same terms as Perl itself. SEE ALSO
See Dancer for details about the complete framework. perl v5.14.2 2012-01-27 Dancer::Session(3pm)
Man Page