There is a full list on page 1375 of the CF5 Web Application Construction
Kit.
Alternatively:
CGI Environment Variables
Each time a browser makes a request to a server, a set of environment
variables are created, some by the Web server and some by the browser.
In ColdFusion, these variables are referred to as CGI environment variables
and they use the "CGI" prefix (even if your server is using a server API
instead of CGI to communicate to the ColdFusion Server).
The environment variables contain a range of data about the transaction
between the browser and the server, such as the IP Address, browser type,
and authenticated username. You can reference CGI environment variables for
a given page request anywhere in the page. All CGI variables are read-only.
Note The environment variables available to your applications depend on the
browser and server software in use for a given request.
Testing for CGI variables
Because not all CGI variables are supported by every browser, ColdFusion
always returns TRUE when testing for the existence of a CGI variable, even
if the variable is not supported by the client browser. The way around this
is to test for an empty string, instead of a boolean return, to see whether
the CGI variable is available.
<CFIF CGI.varname IS NOT "">
CGI variable exists
<CFELSE>
CGI variable does not exist
</CFIF>
CGI server variables
The following table describes the most common CGI environment variables
created on the server (not all of these will be available with every
server):
CGI Server Variables
Variable Description
SERVER_SOFTWARE The name and version of the information server software
answering the request (and running the gateway). Format: name/version.
SERVER_NAME The server's hostname, DNS alias, or IP address as it appears
in self-referencing URLs.
GATEWAY_INTERFACE The revision of the CGI specification to which this
server complies. Format: CGI/revision.
SERVER_PROTOCOL The name and revision of the information protocol this
request came in with. Format: protocol/revision.
SERVER_PORT The port number to which the request was sent.
REQUEST_METHOD The method with which the request was made. For HTTP, this
is Get, Head, Post, and so on.
PATH_INFO The extra path information, as given by the client. Scripts can
be accessed by their virtual pathname, followed by extra information at the
end of this path. The extra information is sent as PATH_INFO.
PATH_TRANSLATED The server provides a translated version of PATH_INFO,
which takes the path and does any virtual-to-physical mapping to it.
SCRIPT_NAME A virtual path to the script being executed; used for
self-referencing URLs.
QUERY_STRING The query information that follows the ? in the URL that
referenced this script.
REMOTE_HOST The hostname making the request. If the server does not have
this information, it sets REMOTE_ADDR and does not set REMOTE_HOST.
REMOTE_ADDR The IP address of the remote host making the request.
AUTH_TYPE If the server supports user authentication, and the script is
protected, this is the protocol-specific authentication method used to
validate the user.
REMOTE_USER AUTH_USER If the server supports user authentication, and the
script is protected, this is the username they have authenticated as. (Also
available as AUTH_USER.)
REMOTE_IDENT If the HTTP server supports RFC 931 identification, this
variable is set to the remote username retrieved from the server. Use this
variable for logging only.
CONTENT_TYPE For queries that have attached information, such as HTTP POST
and PUT, this is the content type of the data.
CONTENT_LENGTH The length of the content as given by the client.
CGI client variables
The following chart describes the most common CGI environment variables
created by the browser and passed in the request header:
CGI Client Variables
Variable Description
HTTP_REFERER The referring document. This is the document that linked to or
submitted form data.
HTTP_USER_AGENT The browser the client is currently using to send the
request. Format: software/version library/version.
HTTP_IF_MODIFIED_SINCE The last time the page was modified. This variable
is sent at the discretion of the browser, usually in response to the server
having sent the LAST_MODIFIED HTTP header. It can be used to take advantage
of browser-side caching.
CGI client certificate variables
ColdFusion exposes the following client certificate data. These variables
are available only when running Microsoft IIS 4.0 or Netscape Enterprise
under SSL, and your web server must be configured to accept client
certificates.
CGI Client Certificate Variables
Variable Description
CERT_SUBJECT Client-specific information provided by the web server. This
data typically includes the client's name, e-mail address, etc. For example:
O="VeriSign, Inc.", OU=VeriSign Trust Network,
OU="www.verisign.com/repository/RPA Incorp. by Ref.,LIAB.LTD(c)98",
OU=Persona Not Validated, OU=Digital ID Class 1 - Microsoft, CN=Matthew
Lund, [EMAIL PROTECTED]
CERT_ISSUER Information about the authority that provided the client
certificate. For example: O="VeriSign, Inc.", OU=VeriSign Trust Network,
OU="www.verisign.com/repository/RPA Incorp. By Ref.,LIAB.LTD(c)98",
CN=VeriSign Class 1 CA Individual Subscriber-Persona Not Validated
CLIENT_CERT_ENCODED The entire client certificate binary, base-64 encoded.
This data is typically of interest only to developers integrating with other
software that uses client certificates.
==
Peter Tilbrook
Project Officer
Strategic Development
Australian Building Codes Board
GPO Box 9839
CANBERRA ACT 2601
AUSTRALIA
E-Mail: [EMAIL PROTECTED]
Telephone: (02) 6213 6731
Mobile: 0439 401 823
Facsimile: (02) 6213 7287
-----Original Message-----
From: Ciliotta, Mario [mailto:mario.ciliotta@;csfb.com]
Sent: Tuesday, 12 November 2002 11:15 AM
To: CF-Talk
Subject: CGI Variables
Hi,
Does anyone know the cgi variable to capture a users ip address. I have
used it before but I just seem to be drawing a blank. Also does anyone have
a link to a list of all the available CGI variables.
Thanks
Mario
This message is for the named person's use only. It may contain sensitive
and private proprietary or legally privileged information. No
confidentiality or privilege is waived or lost by any mistransmission. If
you are not the intended recipient, please immediately delete it and all
copies of it from your system, destroy any hard copies of it and notify the
sender. You must not, directly or indirectly, use, disclose, distribute,
print, or copy any part of this message if you are not the intended
recipient. CREDIT SUISSE GROUP and each legal entity in the CREDIT SUISSE
FIRST BOSTON or CREDIT SUISSE ASSET MANAGEMENT business units of CREDIT
SUISSE FIRST BOSTON reserve the right to monitor all e-mail communications
through its networks. Any views expressed in this message are those of the
individual sender, except where the message states otherwise and the sender
is authorized to state them to be the views of any such entity.
Unless otherwise stated, any pricing information given in this message is
indicative only, is subject to change and does not constitute an offer to
deal at any price quoted. Any reference to the terms of executed
transactions should be treated as preliminary only and subject to our
formal written confirmation.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~|
Archives: http://www.houseoffusion.com/cf_lists/index.cfm?forumid=4
Subscription:
http://www.houseoffusion.com/cf_lists/index.cfm?method=subscribe&forumid=4
FAQ: http://www.thenetprofits.co.uk/coldfusion/faq
Structure your ColdFusion code with Fusebox. Get the official book at
http://www.fusionauthority.com/bkinfo.cfm
