Отправить HEAD-запрос HttpClient::head

Модуль: main — подключать отдельно не нужно

Метод HttpClient::head отправляет HEAD-запрос и возвращает заголовки ответа. Метод нужен, чтобы проверить файл или страницу без загрузки тела, например узнать тип или размер файла.

Сигнатура метода в классе Bitrix\Main\Web\HttpClient:

public function head($url)

Параметры

Обязательные параметры обозначены *

Параметр Тип Описание
url* string Задает абсолютный адрес

Тип в таблице описывает назначение аргумента. Сигнатура PHP не объявляет его.

Возвращаемое значение

Метод возвращает объект HttpHeaders с заголовками ответа или false, если запрос не удался.

Особенности

Метод переходит по редиректам, как get.

Примеры

Пример. Код узнает тип страницы без загрузки тела:

<?php
use Bitrix\Main\Web\HttpClient;

require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';

$client = new HttpClient();
$headers = $client->head('https://example.org/');

echo ($headers !== false ? $headers->getContentType() : 'request failed');

Код выведет text/html.

Смотрите также