View on
MetaCPAN is shutting down
For details read Perl NOC. After June 25th this page will redirect to
Randy Kobes (contact brian d foy) > CGI-Apache2-Wrapper-0.215 > CGI::Apache2::Wrapper::Cookie



Annotate this POD


View/Report Bugs
Module Version: 0.215   Source  


CGI::Apache2::Wrapper::Cookie - cookies via libapreq2


 use CGI::Apache2::Wrapper::Cookie;
 sub handler {
    my $r = shift;
    # create a new Cookie and add it to the headers
    my $cookie = CGI::Apache2::Wrapper::Cookie->new($r,
    # fetch existing cookies
    my %cookies = CGI::Apache2::Wrapper::Cookie->fetch($r);
    my $id = $cookies{'ID'}->value;
    return Apache2::Const::OK;


This module provides a wrapper around Apache2::Cookie. Some methods are overridden in order to provide a CGI::Cookie-compatible interface.

Cookies are created with the new method:

 my $c = CGI::Apache2::Wrapper::Cookie->new($r,
                             -name    =>  'foo',
                             -value   =>  'bar',
                             -expires =>  '+3M',
                             -domain  =>  '',
                             -path    =>  '/cgi-bin/database',
                             -secure  =>  1

with a mandatory first argument of the Apache2::RequestRec object $r. The remaining arguments are

After creation, cookies can be sent to the browser in the appropriate header by $c->bake();.

Existing cookies can be fetched with %cookies = CGI::Apache2::Wrapper::Cookie->fetch($r);, which requires a mandatory argument of the Apache2::RequestRec object $r. In a scalar context, this returns a hash reference. The keys of the hash are the values of the name of the Cookie, while the values are the corresponding CGI::Apache2::Wrapper::Cookie object.

Methods ^

Available methods are


CGI, CGI::Cookie, Apache2::Cookie, and CGI::Apache2::Wrapper.

Development of this package takes place at


You can find documentation for this module with the perldoc command:

    perldoc CGI::Apache2::Wrapper::Cookie

You can also look for information at:


If the USE_CGI_PM environment variable is set, the new method will return a CGI::Cookie object, while fetch will return the corresponding cookies using CGI::Cookie.


This software is copyright 2007 by Randy Kobes <>. Use and redistribution are under the same terms as Perl itself; see

syntax highlighting: