PHP Manual
Prev |  | Next

# apache_request_headers

(PHP 4 >= 4.3.0, PHP 5)

apache_request_headers -- Fetch all HTTP request headers

## Description

array apache_request_headers ( void )

Fetches all HTTP requests from the current request.

This function is only supported when PHP is installed as an Apache module.

## Return Values

An associative array of all the HTTP headers in the current request, or `FALSE` on failure.

## Examples

Example 1. apache_request_headers() example

`<?php $headers = apache_request_headers(); foreach ($headers as $header => $value) { echo "$header: $value <br />\n"; } ?>`

The above example will output something similar to:

    Accept: */*
    Accept-Language: en-us
    Accept-Encoding: gzip, deflate
    User-Agent: Mozilla/4.0
    Host: www.example.com
    Connection: Keep-Alive

## Notes

> Note: Prior to PHP 4.3.0, apache_request_headers() was called getallheaders(). After PHP 4.3.0, getallheaders() is an alias for apache_request_headers().

> Note: You can also get at the value of the common CGI variables by reading them from the environment, which works whether or not you are using PHP as an Apache module. Use phpinfo() to see a list of all of the available environment variables.

> Note: As of PHP 4.3.3 you can use this function with the NSAPI server module in Netscape/iPlanet/SunONE webservers, too.

## See Also

apache_response_headers()

Prev | Home | Next
apache_note | Up | apache_reset_timeout