The Perl and Raku Conference 2025: Greenville, South Carolina - June 27-29 Learn more

 / 
Catalyst-Plugin-Session-Store-Redis-Fast-1.001
River stage zero No dependents
/ Catalyst::Plugin::Session::Store::Redis::Fast

NAME


            

              
              
Catalyst::Plugin::Session::Store::Redis::Fast - Catalyst session store Redis Fast Plugin
works with redis 2.0.0 and above
Redis::Fast is 50% faster than Redis.pm

VERSION

Version 1.000

SYNOPSIS


            

              
              
use Catalyst qw/
    Session
    Session::Store::Redis::Fast
    Session::State::Foo
/;
     
MyApp->config->{Plugin::Session} = {
    server       => '127.0.0.1:6379',   # Defaults to $ENV{REDIS_SERVER} or 127.0.0.1:6379
    sock         => '/path/to/socket',  #(optional) use unix socket
    reconnect    => 60,                 #(optional) Enable auto-reconnect
    every        => 500_000,            #(optional) Try to reconnect every 500ms up to 60 seconds until success
    encoding     => undef,              #(optional) Disable the automatic utf8 encoding => much more performance
    password     => 'TEST',             #(optional) default undef
    select_db    => 4,                  #(optional) will use the redis db default 0
};
# ... in an action:
$c->session->{foo} = 'bar'; # will be saved

method

server (optional) either server or sock


            

              
              
# Defaults to $ENV{REDIS_SERVER} or 127.0.0.1:6379
MyApp->config->{Plugin::Session} = {
    server => '127.0.0.1:6379',
}

sock (optional)


            

              
              
# use unix socket
 MyApp->config->{Plugin::Session} = {
     sock    => '/path/to/socket',
 }

reconnect & every (optional)


            

              
              
## Enable auto-reconnect
## Try to reconnect every 500ms up to 60 seconds until success
## Die if you can't after that
MyApp->config->{Plugin::Session} = {
    server    => '127.0.0.1:6379',
    reconnect => 60,
    every     => 500_000,
}

name (optional)


            

              
              
 ## Set the connection name (requires Redis 2.6.9)
MyApp->config->{Plugin::Session} = {
    server => '127.0.0.1:6379',
    name    => 'TEST',
}

encoding (optional)


            

              
              
## Disable the automatic utf8 encoding => much more performance
## !!!! This will be the default after redis version 2.000
MyApp->config->{Plugin::Session} = {
    server => '127.0.0.1:6379',
    enci    => 'TEST',
}

password (optional)


            

              
              
## Sets the connection password
MyApp->config->{Plugin::Session} = {
    server      => '127.0.0.1:6379',
     encoding   => undef
}

select_db (optional)


            

              
              
## Selects db to be used for connection
MyApp->config->{Plugin::Session} = {
    server      => '127.0.0.1:6379',
    select_db   => 3
}

refer Redis::Fast for more connection method support


            

              
              
no_auto_connect_on_new => 1,
server => '127.0.0.1:6379',
write_timeout => 0.2,
read_timeout => 0.2,
cnx_timeout => 0.2,

AUTHOR

Sushrut Pajai, <spajai at cpan.org>

BUGS

Please report any bugs or feature requests to

bug-catalyst-plugin-session-store-redis-fast at rt.cpan.org, or through

the web interface at https://rt.cpan.org/NoAuth/ReportBug.html?Queue=Catalyst-Plugin-Session-Store-Redis-Fast.

I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.


            

              
              
perldoc Catalyst::Plugin::Session::Store::Redis::Fast

You can also look for information at:

ACKNOWLEDGEMENTS

LICENSE AND COPYRIGHT

This software is copyright (c) 2021 by Sushrut Pajai

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language itself.