The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

HTTP::Request::CGI - Subclass of HTTP::Request for dealing with CGI-generated requests.

SYNOPSIS

    require HTTP::Request::CGI;
    
    my $r = HTTP::Request::CGI.new();
    
    say "Request method: " ~ $r.method;
    say "Request URI: "    ~ $r.uri;
    say "Query string: "   ~ $r.query_string;

DESCRIPTION

An object of this class represents a client's request. It also contains extra information passed on by the HTTP server, useful to the authors of CGI scripts.

Request Details

An HTTP::Request::CGI object has the following public attributes:

$r.method

The request method used (for example, 'GET').

$r.uri

The request URI.

$r.query_string

The query string portion of the request URI.

$r.remote_host

The hostname of the client, if available.

$r.remote_addr

The IP address of the client, if available.

In addition, the following request headers are set on the HTTP::Headers object, if they are present:

1. Content-Length
2. Content-Type
3. Referer
4. Accept
5. User-Agent

Parameters

The parameters of the request are accessible through the HTTP::Query object that is part of every HTTP::Request::CGI object (accessible as $r.query, where $r is the HTTP::Request::CGI object). The following methods are delegated to the query object:

param
params
keywords
delete_param -> delete
delete_params -> clear

Please read the HTTP::Query documentation for more information on these methods.

AUTHORS

"Aankhen"

LICENSE

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See http://www.perl.com/perl/misc/Artistic.html