NAME

Cookie::Baker - Cookie string generator / parser

SYNOPSIS

use Cookie::Baker;

$headers->push_header('Set-Cookie', bake_cookie($key,$val));

my $cookies_hashref = crush_cookie($headers->header('Cookie'));

DESCRIPTION

Cookie::Baker provides simple cookie string generator and parser.

FUNCTION

my $cookie = bake_cookie('foo','val');
my $cookie = bake_cookie('foo', {
    val => 'val',
    path => "test",
    domain => '.example.com',
    expires => '+24h'
} );

Generates cookie string for HTTP response header. First argument is cookies' name and seconds argument is plain string or hash reference that can contain keys such as value, domain, expires, path, httponly, secure, max-age.

value

Cookie's value

domain

Cookie's domain.

expires

Cookie's expires date time. several formats are supported

expires => time + 24 * 60 * 60 # epoch time
expires => 'Wed, 03-Nov-2010 20:54:16 GMT' 
expires => '+30s' # 30 seconds from now
expires => '+10m' # ten minutes from now
expires => '+1h'  # one hour from now 
expires => '-1d'  # yesterday (i.e. "ASAP!")
expires => '+3M'  # in three months
expires => '+10y' # in ten years time
expires => 'now'  #immediately
path

Cookie's path.

httponly

If true, give HttpOnly flag. false by default.

secure

If true, give secure flag. false by default.

Parses cookie string and returns hashref

my $cookies_hashref = crush_cookie($headers->header('Cookie'));

SEE ALSO

CPAN already has many cookie related modules. But there is not simple cookie string generator and parser modules.

CGI, CGI::Simple, Plack, Dancer::Cookie

LICENSE

Copyright (C) Masahiro Nagano.

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

AUTHOR

Masahiro Nagano <kazeburo@gmail.com>