Delicious Bookmark this on Delicious Share on Facebook SlashdotSlashdot It! Digg! Digg



PHP : Function Reference : Apache-specific Functions : apache_request_headers

apache_request_headers

Fetch all HTTP request headers (PHP 4 >= 4.3.0, PHP 5)
array apache_request_headers ( )

Example 205. 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

Code Examples / Notes » apache_request_headers

tehjosh

To callum85 at notspam dot msn dot com:
All of the request headers, including If-None-Match and If-Modified-Since should be available in the $_SERVER array by default.  Try running this code:
<?php
var_dump($_SERVER);
?>
Experiment by sending different headers in the request to that script and you should see that the headers populate the $_SERVER array automatically.


callum85

There is a simple way to get request headers from Apache even on PHP running as a CGI. As far as I know, it's the only way to get the headers "If-Modified-Since" and "If-None-Match" when apache_request_headers() isn't available. You need mod_rewrite, which most web hosts seem to have enabled. Put this in an .htacess file in your web root:
RewriteEngine on
RewriteRule .* - [E=HTTP_IF_MODIFIED_SINCE:%{HTTP:If-Modified-Since}]
RewriteRule .* - [E=HTTP_IF_NONE_MATCH:%{HTTP:If-None-Match}]
The headers are then available in PHP as
<?php
 $_SERVER['HTTP_IF_MODIFIED_SINCE'];
 $_SERVER['HTTP_IF_NONE_MATCH'];
?>
I've tested this on PHP/5.1.6, on both Apache/2.2.3/Win32 and Apache/2.0.54/Unix, and it works perfectly.
Note: if you use RewriteRules already for clean URLs, you need to put the above rules AFTER your existing ones.


suso

The PHP developers should not be creating functions like this that only work in the module version and not in the CGI version.  It creates situations where people who have setup special installations of PHP (like suphp) run into issues with prewritten software.  If you can't make it work with both, then don't make it work at all.

jrabbit

The following code will implement an approximation of apache_request_headers for lighttpd making most scripts that use the function portable between the two platforms.
Caveats are:
1. This function will convert any _ in a header key to a -
2. This function will capitalize the first character and first character after each hyphen in each header key and lower case the rest of the key.
This does not cause a problem with standard headers which are capitalized in this manner but may cause custom headers to appear in a different case to apache.
if (!function_exists('apache_request_headers')) {
eval('
function apache_request_headers() {
foreach($_SERVER as $key=>$value) {
if (substr($key,0,5)=="HTTP_") {
$key=str_replace(" ","-",ucwords(strtolower(str_replace("_"," ",substr($key,5)))));
$out[$key]=$value;
}
}
return $out;
}
');
}


php

Surly this could be rewritten as
function list_dirs($path, $target)
{
  $list = scandir($path);
  $url = $_SERVER['HTTP_HOST'];
     
  foreach ($list as $number => $filename)
  {
      if ( $filename !== '.' && $filename !== '..' && !is_file($filename) )
      {
          if ($target == '')
          {
              // Print Dirs with link
              print ("<a href=\"http://$url/$filename\">$filename</a>
\n");
          }
          else
          {
              // Print Dirs with link
              print ("<a href=\"http://$url/$filename\" target=\"$target\">$filename</a>
\n");
          }
             
      }
  }
}
which would then not require apache. I havent tested this but looks to do exactly the same.


tehjosh

I wrote a function similar to jrabbit's, except that mine creates a custom function rather than redefining the original.
<?php
function request_headers()
{
if(function_exists("apache_request_headers")) // If apache_request_headers() exists...
{
if($headers = apache_request_headers()) // And works...
{
return $headers; // Use it
}
}
$headers = array();
foreach(array_keys($_SERVER) as $skey)
{
if(substr($skey, 0, 5) == "HTTP_")
{
$headername = str_replace(" ", "-", ucwords(strtolower(str_replace("_", " ", substr($skey, 0, 5)))));
$headers[$headername] = $_SERVER[$skey];
}
}
return $headers;
}
?>
Also, eval() is not necessary to define a function that is within an if block, as is done in jrabbit's code, because PHP will only read the function if it passes the if condition.


limalopex.eisfux.de

I didn't found a replacement for apache_request_headers() in PHP::Compat (http://pear.php.net/package/PHP_Compat) so I wrote my own:
<?php
if( !function_exists('apache_request_headers') ) {
///
function apache_request_headers() {
 $arh = array();
 $rx_http = '/\AHTTP_/';
 foreach($_SERVER as $key => $val) {
   if( preg_match($rx_http, $key) ) {
     $arh_key = preg_replace($rx_http, '', $key);
     $rx_matches = array();
     // do some nasty string manipulations to restore the original letter case
     // this should work in most cases
     $rx_matches = explode('_', $arh_key);
     if( count($rx_matches) > 0 and strlen($arh_key) > 2 ) {
       foreach($rx_matches as $ak_key => $ak_val) $rx_matches[$ak_key] = ucfirst($ak_val);
       $arh_key = implode('-', $rx_matches);
     }
     $arh[$arh_key] = $val;
   }
 }
 return( $arh );
}
///
}
///
?>


renich

Here is a simple listing function. It accepts a path and target. Examples listed bellow
function list_dirs($path, $target)
{
$list = scandir($path);

foreach ($list as $number => $filename)
{
if ( $filename !== '.' && $filename !== '..' && !is_file($filename) )
{
// Asign more readable and logic variables
$dir = $filename;
$url = apache_request_headers();

if ($target == '')
{
// Print Dirs with link
print ("<a href=\"http://$url[Host]/$dir\">$dir</a>
\n");
}
else
{
// Print Dirs with link
print ("<a href=\"http://$url[Host]/$dir\" target=\"$target\">$dir</a>
\n");
}

}
}
}
Examples:
1.- List actual dir with no target option
<?php
list_dirs('.', '');
?>
2.- List "mydir" with a "_blank" as target name
<?php
list_dirs('/home/renich/www/mydir', '_blank')
?>
Notes:
- Its a simple function and it uses a function that interacts with apache. I don't know what will happen if you request a file list of a directory outside of the apache realm!
- Not fully tested!


Change Language


Follow Navioo On Twitter
apache_child_terminate
apache_get_modules
apache_get_version
apache_getenv
apache_lookup_uri
apache_note
apache_request_headers
apache_reset_timeout
apache_response_headers
apache_setenv
ascii2ebcdic
ebcdic2ascii
getallheaders
virtual
eXTReMe Tracker