http_request_header

Format: http_request_header ( [ header-name ] )

Purpose: Get client request headers. The header-name parameter must be a string that is allowed in request headers from clients. For a detailed description of request headers see RFC-2068 which defines the HTTP/1.1 protocol.

Return Values: If header-name is given, the function returns a string denoting the request header value for the header name if header-name occurs in the request header. If header-name doesn't occur in the request header, null is returned. If header-name is not given, an object is returned denoting the whole request header. Each object field name/value corresponds to a header name/value in the request header.

Example:

input:

<? http_request_header("User-Agent")> <? http_request_header()>

resulting output:

CCBot/1.0 (+http://www.commoncrawl.org/bot.html) Accept = "text/html,application/xhtml+xml,text/xml"..."0.9,text/plain;q=0.8,image/png,*/*;q=0.5" Accept-Charset = "ISO-8859-1,utf-8;q=0.7,*;q=0.7" Accept-Encoding = "gzip" Accept-Language = "en-us,en;q=0.5" Cache-Control = "no-cache" Connection = "close" Host = "www.radpage.com" pragma = "no-cache" User-Agent = "CCBot/1.0 (+http://www.commoncrawl.org/bot.html)" x-cc-id = "ccc02-01"

See Also: http_header().