GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  CGI::THIN::COOKIES (3)

.ds Aq ’

NAME

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

CONTENTS

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 dont send an expiration, it will expire
                        with the browser being closed

                        If you dont 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.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 CGI::THIN::COOKIES (3) 2001-09-16

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.