Manual Reference Pages - CGI::COOKIE::SPLITTER (3)
CGI::Cookie::Splitter - Split big cookies into smaller ones.
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 recommends 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 its 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.
$splitter = CGI::Cookie::Splitter->new(%params)
The only supported parameters right now are size. It defaults to 4096.
@cookies = $splitter->split(@cookies)
This method accepts a list of CGI::Cookie objects (or lookalikes) 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.
$cookie = $splitter->join(@cookies)
This is the inverse of split.
Whether or not the cookie should be split
These methods encapsulate a name mangling scheme for changing the cookie names
to allow a 1:n relationship.
are not mangled.
As long as your cookie names dont start with the substring _bigcookie_ you
should be OK ;-)
Demangles name, increments the index and remangles.
This module is designed to be easily subclassed... If you need to split cookies
using a different criteria then you should look into that.
XXXX XXXXX (Yuval Kogman) <firstname.lastname@example.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2006 by XXXX XXXXX (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.
|perl v5.20.3 ||CGI::COOKIE::SPLITTER (3) ||2015-08-16 |
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.