Отправка HTTP ответа в PHP: коды состояния и заголовки

Расширенные и нестандартные примеры управления HTTP ответом в PHP

Отправка ответа с кодом 201 Created с указанием Location

<?php
// Создание нового ресурса (например, пользователя)
$newId = 42;
http_response_code(201);
header('Location: /users/' . $newId);
header('Content-Type: application/json');
echo json_encode(['id' => $newId, 'status' => 'created']);
?>

HTTP/1.1 201 Created
Location: /users/42
Content-Type: application/json

{"id":42,"status":"created"}

Пояснение: код 201 означает успешное создание, заголовок Location указывает URL нового ресурса. Важно отправить все заголовки до вывода тела.

Ответ с кодом 403 Forbidden и кастомным сообщением

<?php
http_response_code(403);
header('Content-Type: text/plain');
echo 'Доступ запрещён: недостаточно прав.';
?>

HTTP/1.1 403 Forbidden
Content-Type: text/plain

Доступ запрещён: недостаточно прав.

Используется для ограничения доступа к защищённым ресурсам. Рекомендуется не раскрывать детали.

Ответ с кодом 503 Service Unavailable и заголовком Retry-After

<?php
http_response_code(503);
header('Retry-After: 3600'); // повторить через час
header('Content-Type: text/html');
echo '<h1>Сервис временно недоступен</h1><p>Попробуйте позже.</p>';
?>

HTTP/1.1 503 Service Unavailable
Retry-After: 3600
Content-Type: text/html

<h1>Сервис временно недоступен</h1><p>Попробуйте позже.</p>

Обработка ошибок с установкой кода 500 и логированием

<?php
ob_start();
try {
    // некий код, который может выбросить исключение
    if (rand(0,1)) throw new Exception('Неизвестная ошибка');
    http_response_code(200);
    echo 'Успех';
} catch (Exception $e) {
    ob_clean(); // очистить ранее накопленный вывод
    http_response_code(500);
    header('Content-Type: text/plain');
    echo 'Внутренняя ошибка сервера';
    error_log($e->getMessage());
} finally {
    ob_end_flush();
}
?>

(в случае исключения) HTTP/1.1 500 Internal Server Error

Буферизация позволяет избежать «headers already sent» при исключении. Логирование ошибки не показывается клиенту.

Отправка разного ответа в зависимости от HTTP метода (REST)

<?php
$method = $_SERVER['REQUEST_METHOD'];
switch ($method) {
    case 'GET':
        http_response_code(200);
        echo json_encode(['data' => 'список']);
        break;
    case 'POST':
        http_response_code(201);
        echo json_encode(['status' => 'создано']);
        break;
    case 'PUT':
        http_response_code(200);
        echo json_encode(['status' => 'обновлено']);
        break;
    case 'DELETE':
        http_response_code(204); // No Content
        // без тела
        break;
    default:
        http_response_code(405);
        header('Allow: GET, POST, PUT, DELETE');
        echo json_encode(['error' => 'Метод не поддерживается']);
}
?>

(пример для DELETE) HTTP/1.1 204 No Content

Код 204 используется для успешного удаления, тело ответа отсутствует.

Установка заголовков для предотвращения кэширования (динамический контент)

<?php
http_response_code(200);
header('Cache-Control: no-cache, no-store, must-revalidate');
header('Pragma: no-cache');
header('Expires: 0');
echo date('Y-m-d H:i:s');
?>

HTTP/1.1 200 OK
Cache-Control: no-cache, no-store, must-revalidate
Pragma: no-cache
Expires: 0

2025-03-28 12:34:56

Эти заголовки заставляют браузер и прокси не кэшировать ответ, подходит для страниц с часто меняющимся содержимым.

Отправка gzip-сжатого ответа вручную

<?php
$data = str_repeat('Тестовая строка для сжатия ', 1000);
$compressed = gzencode($data, 9);
header('Content-Encoding: gzip');
header('Content-Length: ' . strlen($compressed));
header('Content-Type: text/plain; charset=utf-8');
echo $compressed;
?>

(результат - сжатый двоичный поток)

Обычно сжатие включается на уровне сервера (mod_deflate), но для специфичных случаев можно сжать данные программно. Перед сжатием убедитесь, что клиент принимает gzip (заголовок Accept-Encoding).