Request Variable

Your A5W pages have access to a system object named Request that contains valuable information. The server creates this object for each client request and can be accessed directly by your applications.

Note: Request variables are local to the page (script) and must be passed to any functions defined on the page.

The following variables will be available for all client requests:

Property

Description

Request.Headers

The headers of the request in a CR-LF delimited list.

Request.Body

The body of the request, will be empty for a GET.

Request.HTTP_Request

The first line of the request headers, which tells the server what file to retrieve and how to retrieve it.

Request.Host

The hostname that this request was sent to. Request.Host will always exist if the client uses HTTP/1.1, but it may not if the client uses HTTP/1.0.

Request.Query_String

The query string of a GET request, such as "foo=bar&this=that".

Request.Raw

The complete raw request received by the server.

Request.Remote_Addr

The IP address of the remote client making the request. Do not attempt to use Request.Remote_Addr as a unique identifier for the session. Use Session ID instead. AOL users share one or two IP addresses.

Request.Request_Method

The request method, such as "GET" or "POST".

Request.Request_URI

The requested file including any GET query string, such as "/index.html?foo=bar&this=that".

Request.Script_Name

The requested file, such as "/index.html" (the currently running page).

Request.Server_Protocol

The protocol used by the request, such as "HTTP/1.1" or "HTTP/1.0".

Request.Variables

A dot variable containing all variables sent from the client. This is a combination of GET variables, POST variables and cookies.

Additionally, the following properties may be available, depending on the request made by the client. If your application uses any of these, it should use an EVAL_VALID() first to make sure they have been defined.

Variable

Description

Request.Accept

The MIME types that the client can accept.

Reqest.Accept_Encoding

Types of transfer encoding accepted by the client.

Request.Accept_Language

Languages that the client is configured to accept.

Request.Connection

The connection type requested by the client, such as "Keep-Alive".

Request.Cookie

A string containing all cookies sent by the client.

Request.Referer

Contains the URL of the page from which the user came.

Request.User_Agent

A string identifying the software used on the client to send this request.

Supported By

Alpha Five Version 6 and Above

See Also

Sessions, Status Codes, Configuring Internet Explorer