Perl Tutorials - Herong's Tutorial Examples
∟CGI.pm Module for Building Web Pages
∟What Is CGI::Cookie?
This section describes what is CGI::Cookie, which is a sub class of the CGI.pm Perl module, which help you to create HTTP cookies and manage them in HTTP headers of request and response messages.
If you are interested to retrieve old cookies from the request and set new cookies to the response,
The CGI.pm module offers the following methods for you to use:
- @l = $q->cookie() - Retrieve cookie names from the request into an array.
- $v = $q->cookie($n) - Retrieve the cookie value of the given cookie name from the request.
- print $q->header(-cookie=>$c, ...) - Print header lines with 1 given cookie object to the HTTP response.
- print $q->header(-cookie=>[$c1, $c2, ...], ...) - Print header lines with multiple cookie objects to the HTTP response.
What Is CGI::Cookie?
CGI::Cookie is a sub class of the CGI.pm Perl module, which help you to create HTTP cookies and manage them
in HTTP headers of request and response messages.
Here are main methods offered in CGI::Cookie class:
In order to create cookie objects, we need to use methods offered in the sub class CGI::Cookie:
- $c = CGI::Cookie->new(-name=>'...', -value=>'...') - Create a new cookie (CGI::Cookie) object
with the given name and the given value.
- $c = CGI::Cookie->new(-name=>'...', -value=>'...', -expire=>'...', -domain=>'...', -path=>'...',
-secure=>'...', -httponly=>'...') - Create a new cookie (CGI::Cookie) object with the given name, the given value
and other optional properties.
- $c->name() - Get or set the name of this cookie.
- $c->value() - Get or set the value of this cookie.
- $c->domain() - Get or set the domain of this cookie.
- $c->path() - Get or set the path of this cookie.
- $c->expires() - Get or set the expiration time of this cookie.
- %l = CGI::Cookie->fetch() - Retrieve cookies from the request into a hash array.
- %l = CGI::Cookie->parse($ENV{COOKIE}) - Parse cookies from the cookie environment variable into a hash array.
Note that you can use the following properties to control the cookie should behave in the browser.
- "expire" - Defines how long this cookie can stay alive in the browser.
By default, the browser will remove all cookies that have no expiration time, when the browser is closed.
- "domain" - Defines for which domain(s) this cookie should be returned by the browser.
By default, the browser returns the cookie to a Web server that matches the domain where this cookie was received.
- "path" - Defines path name to which this cookie is associated. The browser should return this cookie
only if the requesting URI matches the associated path.
By default, the cookie's path is "/".
- "secure" - Defines the security Boolean flag. If true, the browser should return this cookie
only when the request is secured with SSL or other protocol.
- "httponly" - Defines the httponly Boolean flat. If true, the browser should provide this cookie to HTTP request,
not to JavaScript or other browser scripts.
Table of Contents
About This Book
Perl on Linux Systems
ActivePerl on Windows Systems
Data Types: Values and Variables
Expressions, Operations and Simple Statements
User Defined Subroutines
Perl Built-in Debugger
Name Spaces and Perl Module Files
Symbolic (or Soft) References
Hard References - Addresses of Memory Objects
Objects (or References) and Classes (or Packages)
Typeglob and Importing Identifiers from Other Packages
String Built-in Functions and Performance
File Handles and Data Input/Output
Open Files in Binary Mode
Open Directories and Read File Names
File System Functions and Operations
Image and Picture Processing
Using DBM Database Files
Using MySQL Database Server
Socket Communication Over the Internet
XML::Simple Module - XML Parser and Generator
XML Communication Model
SOAP::Lite - SOAP Server-Client Communication Module
Perl Programs as IIS Server CGI Scripts
CGI (Common Gateway Interface)
XML-RPC - Remote Procedure Call with XML and HTTP
RPC::XML - Perl Implementation of XML-RPC
Integrating Perl with Apache Web Server
►CGI.pm Module for Building Web Pages
What Is CGI.pm?
Generating HTML Document with CGI.pm
Retrieving Query Parameters and Headers
Retrieving Environment and Script Information
Redirecting Browser to a URI
"Refresh" http-equiv Meta Tag
►What Is CGI::Cookie?
Retrieving and Setting HTTP Cookies
LWP::UserAgent and Web Site Testing
Converting Perl Script to Executable Binary
Managing Perl Engine and Modules on macOS
Archived Tutorials
References
Full Version in PDF/EPUB