Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Split big cookies into smaller ones.
branch: master

This branch is 11 commits ahead of nothingmuch:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
t replace tabs with spaces
LICENSE CGI-Cookie-Splitter-0.04
dist.ini remove inaccurate pod, and weave in a replacement


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


version 0.04


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 );


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.


  • 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 ;-)


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


CGI::Cookie, CGI::Simple::Cookie,,, RFC 2109


יובל קוג'מן (Yuval Kogman)


This software is copyright (c) 2006 by יובל קוג'מן (Yuval Kogman).

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

Something went wrong with that request. Please try again.