NAME

ASP4::Request - Interface to the incoming request

SYNOPSIS

if( my $cookie = $Request->Cookies('cust-email') ) {
  # Greet our returning user:
}

if( my $file = $Request->FileUpload('avatar_pic') ) {
  # Handle the uploaded file:
  $file->SaveAs( "/var/media/$Session->{user_id}/avatar/" . $file->FileName );
}

if( $Request->ServerVariables("HTTPS") ) {
  # We're under SSL:
}

DESCRIPTION

The intrinsic $Request object provides a few easy-to-use methods to simplify the processing of incoming requests - specifically file uploads and cookies.

METHODS

Cookies( [$name] )

Returns a cookie by name, or all cookies if no name is provided.

ServerVariables( [$name] )

A wrapper around the global %ENV variable.

This means that:

$Request->ServerVariables('HTTP_HOST')

is the same as:

$ENV{HTTP_HOST}

FileUpload( $fieldname )

Returns a ASP4::FileUpload object that corresponds to the fieldname specified.

So...if your form has this:

<input type="file" name="my_uploaded_file" />

Then you would get to it like this:

my $upload = $Request->FileUpload('my_uploaded-file');

Header( $name )

Returns the value of an incoming http request header by the given name.

BUGS

It's possible that some bugs have found their way into this release.

Use RT http://rt.cpan.org/NoAuth/Bugs.html?Dist=ASP4 to submit bug reports.

HOMEPAGE

Please visit the ASP4 homepage at http://0x31337.org/code/ to see examples of ASP4 in action.