NAME

CGI::Thin::Cookies - A very lightweight way to read and set Cookies

SYNOPSIS

use CGI::Thin::Cookies;

my %cookie = &Parse_Cookies ();

print &Set_Cookie (VALUE = 'a cookie value', EXPIRE => '+12h);>

DESCRIPTION

This module is a very lightweight parser and setter of cookies. And it has a special feature that it will return an array if the same key is used twice for different cookies with the ame name. And you can force an array to avoid complications.

USAGE

    * 'CGI::Thin::Cookies::Parse_Cookies(@keys)'
        The optional @keys will be used to force arrays to be returned.

		The function returns a hash of the cookies available to the script. It
		can return more than one cookie if they exist.

    * 'CGI::Thin::Cookies::Set_Cookie (%options)VALUE => 'a cookie value', EXPIRE => '+12h);'

		The %options contain the the following information for the cookie:

		NAME: the name of the cookie
		VALUE: a string with the value of the cookie
		DOMAIN: the domain for the cookie, default is the '.secondaryDomain.toplevelDomain'
		PATH: the path within the domain, default is '/'
		SECURE: true or false value for setting the SECURE flag
		EXPIRE: when to expire including the following options

			"delete" -- expire long ago (the first second of the epoch)
			"now"    -- expire immediately
			"never"  -- expire in 2038 (the last second of the epoch in 31 bits)

			"+180s"  -- in 180 seconds
			"+2m"    -- in 2 minutes
			"+12h"   -- in 12 hours
			"+1d"    -- in 1 day
			"+3M"    -- in 3 months
			"+2y"    -- in 2 years
			"-3m"    -- 3 minutes ago(!)

			If $time is false (0 or '') then don't send an expiration, it will expire
			with the browser being closed

			If you don't supply one of these forms, we assume you are
			specifying the date yourself

BUGS

Fixed

Pending

SEE ALSO

CGI::Thin

SUPPORT

Visit CGI::Thin::Cookies' web site at
    http://www.PlatypiVentures.com/perl/modules/cgi_thin.shtml
Send email to
    mailto:cgi_thin@PlatypiVentures.com

AUTHOR

R. Geoffrey Avery
CPAN ID: RGEOFFREY
modules@PlatypiVentures.com
http://www.PlatypiVentures.com/perl

COPYRIGHT

This module is free software, you may redistribute it or modify in under the same terms as Perl itself.