NAME

       CGI::Cookie::Splitter - Split big cookies into smaller ones.

SYNOPSIS

               use CGI::Cookie::Splitter;

               my $splitter = CGI::Cookie::Splitter->new(
                       size => 123, # defaults to 4096
               );

               @small_cookies = $splitter->split( @big_cookies );

               @big_cookies = $splitter->join( @small_cookies );

DESCRIPTION

       RFC 2109 reccomends that the minimal cookie size supported by the client is 4096 bytes. This has become a
       pretty standard value, and if your server sends larger cookies than that it's considered a no-no.

       This module provides a pretty simple interface to generate small cookies that are under a certain limit,
       without wasting too much effort.

METHODS

       new %params
           The only supported parameters right now are "size". It defaults to 4096.

       split @cookies
           This  method  accepts  a  list  of  CGI::Cookie  objects  (or  look  alikes)  and  returns  a list of
           CGI::Cookies.

           Whenever an object with a total size that is bigger than the limit specified at construction time  is
           encountered  it  is  replaced  in  the  result list with several objects of the same class, which are
           assigned serial names and have a smaller size and the same domain/path/expires/secure parameters.

       join @cookies
           This is the inverse of "split".

       should_split $cookie
           Whether or not the cookie should be split

       mangle_name_next $name
           Demangles name, increments the index and remangles.

       mangle_name $name, $index
       demangle_name $mangled_name
           These methods encapsulate a name mangling scheme for  changing  the  cookie  names  to  allo  wa  1:n
           relationship.

           The default mangling behavior is not 100% safe because cookies with a safe size are not mangled.

           As long as your cookie names don't start with the substring "_bigcookie_" you should be OK ;-)

SUBCLASSING

       This  module  is  designed  to  be  easily  subclassed...  If you need to split cookies using a different
       criteria then you should look into that.

SEE ALSO

       CGI::Cookie,                     CGI::Simple::Cookie,                     <http://www.cookiecutter.com/>,
       <http://perlcabal.org/~gaal/metapatch/images/copper-moose-cutter.jpg>, RFC 2109

VERSION CONTROL

       This    module    is    maintained    using    Darcs.    You    can   get   the   latest   version   from
       <http://nothingmuch.woobling.org/CGI-Cookie-Splitter/>, and use "darcs send" to commit changes.

AUTHOR

       Yuval Kogman, "nothingmuch@woobling.org"

COPYRIGHT & LICENCE

               Copyright (c) 2006 the aforementioned authors. All rights
               reserved. This program is free software; you can redistribute
               it and/or modify it under the same terms as Perl itself.

perl v5.18.2                                       2014-01-21                         CGI::Cookie::Splitter(3pm)