PEAR Manual
PrevNext

HTTP::head

HTTP::head -- sends a "HEAD" command

Synopsis

require_once 'HTTP.php';

array HTTP::head (string $url)

Description

Sends a "HEAD" HTTP command to a server and returns the headers in an associative array.

Example

Example 32-1. HEAD request to example.com

require_once "PEAR.php";
require_once "HTTP.php";

$result = HTTP::head("http://example.com/");

if (PEAR::isError($result)) {
    echo "Error: " . $result->getMessage();
} else {
    echo "<pre>";
    print_r($result);
    echo "</pre>";
}
The output of the print_r() call is shown below.

Parameter

Return value

array - an array containing the header lines or a PEAR_Error.

Example output: 
Array
(
    [response_code] => 200
    [response] => HTTP/1.1 200 OK
    [Date] => Tue, 25 Nov 2003 22:08:57 GMT
    [Server] => Apache/1.3.27 (Unix)  (Red-Hat/Linux)
    [Last-Modified] => Wed, 08 Jan 2003 23:11:55 GMT
    [ETag] => "3f80f-1b6-3e1cb03b"
    [Accept-Ranges] => bytes
    [Content-Length] => 438
    [Connection] => close
    [Content-Type] => text/html
)

Throws

Table 32-1. Possible PEAR_Error values

Error codeError messageReasonSolution
NULL "HTTP::head Error $errstr ($erno)" Connection to server failed Check connectivity of your host and the given URL in $url

Note

This function can be called statically.

PrevHomeNext
HTTP::DateUpHTTP::negotiateLanguage