Отправить статус, заголовки и cookie HttpResponse::writeHeaders
Модуль: main — подключать отдельно не нужно
Метод HttpResponse::writeHeaders отправляет клиенту статус, заголовки и cookie ответа функциями PHP header и setcookie. Тело ответа метод не отправляет.
Методы flush и send вызывают writeHeaders сами. Вызывайте метод отдельно, если тело ответа выводит другой код, например функция readfile.
Сигнатура метода в классе Bitrix\Main\HttpResponse:
public function writeHeaders()
Возвращаемое значение
Метод ничего не возвращает.
Метод отправляет данные в таком порядке:
- Строку статуса, если код статуса больше нуля.
- Заголовок
Last-Modified, если время задал метод setLastModified. - Заголовки ответа. Каждое значение метод отправляет отдельным вызовом
headerв видеИмя: значение, в том числе пустое значение. По умолчанию функцияheaderзаменяет заголовок с тем же именем, поэтому из нескольких значений клиент получит последнее. - Cookie ответа. Метод шифрует значения cookie класса
Bitrix\Main\Web\CryptoCookie. Метод не отправляет cookie без флагаCookie::SPREAD_DOMAIN.
Особенности
- После начала вывода PHP не отправляет заголовки. Вызывайте метод до вывода тела ответа.
- При запуске из консоли функция
headerне отправляет заголовки, и метод ничего не выводит.
Примеры
Пример. Код отправляет заголовки ответа для текстового файла, а тело выводит отдельно:
<?php
use Bitrix\Main\HttpResponse;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$response = new HttpResponse();
$response
->addHeader('Content-Type', 'text/plain; charset=utf-8')
->addHeader('Content-Disposition', 'attachment; filename="units.txt"')
;
$response->writeHeaders();
echo "kg\ng\nt";
В браузере код отдаст файл units.txt из трех строк. При запуске из консоли код выведет только текст.
Смотрите также
Была ли статья полезна?
Предыдущая
Следующая