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.

The HTTP package is deprecated. Use HTTP2::head instead.

Example

HEAD request to example.com


<?php
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

string $url - a valid absolute URL

Return value

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

Example output:


<?php
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

Possible PEAR_Error values
Error code	Error message	Reason	Solution
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.