1 package Catalyst::Plugin::Session::State::Cookie;
2 use base qw/Catalyst::Plugin::Session::State/;
14 $c->NEXT::setup_session(@_);
16 $c->config->{session}{cookie_name} ||= "session";
22 my $cookie_name = $c->config->{session}{cookie_name};
24 if ( my $sid = $c->sessionid ) {
25 my $cookie = $c->request->cookies->{$cookie_name};
26 if ( !$cookie or $cookie->value ne $sid ) {
27 $c->response->cookies->{$cookie_name} = {
29 expires => $c->session->{__expires},
31 if ( my $domain = $c->config->{session}{cookie_domain} ) {
32 $c->response->cookies->{$cookie_name}->{domain} = $domain;
34 $c->log->debug(qq/A cookie with the session id "$sid" was saved/)
39 return $c->NEXT::finalize(@_);
45 my $ret = $c->NEXT::prepare_cookies(@_);
47 my $cookie_name = $c->config->{session}{cookie_name};
49 if ( my $cookie = $c->request->cookies->{$cookie_name} ) {
50 my $sid = $cookie->value;
52 $c->log->debug(qq/Found sessionid "$sid" in cookie/) if $c->debug;
66 Catalyst::Plugin::Session::State::Cookie - A session ID
70 use Catalyst qw/Session Session::State::Cookie Session::Store::Foo/;
74 In order for L<Catalyst::Plugin::Session> to work the session ID needs to be
75 stored on the client, and the session data needs to be stored on the server.
77 This plugin stores the session ID on the client using the cookie mechanism.
79 =head1 EXTENDED METHODS
85 Will restore if an appropriate cookie is found.
89 Will set a cookie called C<session> if it doesn't exist or if it's value is not
90 the current session id.
94 Will set the C<cookie_name> parameter to it's default value if it isn't set.
104 The name of the cookie to store (defaults to C<session>).
108 The name of the domain to store in the cookie (defaults to current host)
114 L<Catalyst>, L<Catalyst::Plugin::Session>.
118 Sebastian Riedel E<lt>C<sri@cpan.org>E<gt>,
119 Marcus Ramberg E<lt>C<mramberg@cpan.org>E<gt>,
120 Andrew Ford E<lt>C<andrewf@cpan.org>E<gt>,
121 Yuval Kogman E<lt>C<nothingmuch@woobling.org>E<gt>
125 This program is free software, you can redistribute it and/or modify it
126 under the same terms as Perl itself.