PHPTime

Редирект в PHP: header Location, коды 301 и 302

PHP отправляет редирект с помощью заголовка Location и кода ответа из группы 3xx. Выбор кода определяет, сможет ли браузер заменить POST на GET и следует ли считать переезд постоянным.

Как сделать редирект в PHP через header Location

Функция header() добавляет HTTP-заголовок в ответ. Заголовок Location указывает клиенту, куда перейти. Вместе с кодом 3xx он образует редирект: сервер возвращает ответ, а браузер делает отдельный запрос к указанному адресу. Так работает обычный PHP redirect без JavaScript и HTML-страницы с таймером.

PHP
<?php
declare(strict_types=1);

// На время отправляем посетителя на страницу каталога.
header('Location: /catalog/', true, 302);
exit;

Первый аргумент содержит имя и значение заголовка. Второй, true, велит заменить ранее установленный заголовок с таким же именем. Третий задаёт код ответа. Если вызвать header('Location: /catalog/') без явного кода, PHP установит 302, за исключением случаев, когда уже задан статус 201 или один из статусов 3xx. Явный код делает поведение понятным при чтении и предсказуемым при повторном использовании обработчика.

header() возвращает void и оставляет выполнение скрипта активным. Поставьте exit; сразу после заголовка, если редирект завершает запрос. Иначе код ниже может изменить данные, сформировать тело ответа или переопределить другой заголовок. При этом exit запускает зарегистрированные функции завершения и деструкторы. Блоки finally при таком выходе пропускаются, поэтому обязательную очистку ресурсов выполните заранее.

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

301 или 302: какой код редиректа выбрать

301 Moved Permanently подходит для постоянного переезда страницы, например когда старый раздел окончательно заменён новым. Клиенты и кеши могут запомнить перенаправление. Если поменять назначение после публикации 301, часть клиентов продолжит ходить по старому правилу, пока сохранённый ответ считается свежим.

PHP
<?php
declare(strict_types=1);

// Старый раздел окончательно переехал.
header('Location: /guides/', true, 301);
exit;

302 Found подходит для временной подмены страницы или перехода, который зависит от состояния пользователя. Исходный адрес при этом сохраняет своё назначение. Временный статус сам по себе не запрещает кеширование. Если переход зависит от сессии и его нельзя повторно использовать, добавьте header('Cache-Control: no-store'); перед редиректом.

КодКогда использоватьЧто будет с методом и телом
301Постоянный переезд страницыКлиент вправе заменить POST на GET и отбросить тело
302Временная подмена страницыКлиент вправе заменить POST на GET и отбросить тело
303Показ страницы результата после POSTПосле POST браузер делает GET без исходного тела
307Временный перенос обработчикаПри переходе метод и тело запроса сохраняются
308Постоянный перенос обработчикаПри переходе метод и тело запроса сохраняются

Для навигации по страницам с GET обычно достаточно 301 или 302. Для POST выбор важнее. При 307 и 308 клиент, который следует редиректу, снова отправляет тело запроса по новому адресу. Используйте такой переход, если новый обработчик действительно принимает те же данные. Если исходный обработчик уже выполнил операцию, отправляйте 303 на страницу результата.

Редирект после формы: POST → 303 → GET

Шаблон Post/Redirect/Get разделяет запись данных и показ результата. Обработчик принимает форму, проверяет ввод, выполняет операцию и возвращает 303. Браузер загружает страницу результата методом GET. Обновление этой страницы повторяет GET и не вызывает повторную отправку формы. От двойного клика или повторного POST со стороны клиента сам редирект не защищает.

PHP
<?php
declare(strict_types=1);

if (($_SERVER['REQUEST_METHOD'] ?? '') !== 'POST') {
    header('Allow: POST');
    http_response_code(405);
    exit;
}

$theme = $_POST['theme'] ?? null;
if (!in_array($theme, ['light', 'dark'], true)) {
    http_response_code(400);
    exit('Выберите светлую или тёмную тему.');
}

// Сохраняем выбранную тему в сессии.
if (!session_start()) {
    http_response_code(500);
    exit;
}
$_SESSION['theme'] = $theme;
if (!session_write_close()) {
    http_response_code(500);
    exit;
}

header('Cache-Control: no-store');
header('Location: /settings/?saved=1', true, 303);
exit;

В примере форма отправляет поле theme, а GET-страница настроек читает тему из сессии. Параметр saved можно использовать для показа уведомления. Если обработчик меняет настройки авторизованного пользователя, до записи проверьте CSRF-токен. Для записи в базу данных отправляйте 303 после успешного сохранения или завершения транзакции, чтобы страница результата могла прочитать новое состояние.

Как передать параметры и безопасно выбрать адрес

Параметры запроса

При формировании Location соберите строку запроса через http_build_query(). Режим PHP_QUERY_RFC3986 кодирует пробел как %20, а четвёртый аргумент позволяет явно задать способ кодирования независимо от настроек проекта. Разделитель передайте третьим аргументом. HTML-экранирование здесь лишнее: строка передаётся в HTTP-заголовок.

PHP
<?php
declare(strict_types=1);

// Передаём фильтр и номер страницы новому обработчику.
$query = http_build_query(
    ['q' => 'книги & журналы', 'page' => 2],
    '',
    '&',
    PHP_QUERY_RFC3986
);

header('Location: /search/?' . $query, true, 302);
exit;

Для динамического сегмента пути применяйте rawurlencode() к отдельному сегменту. Кодирование всего пути за один вызов затронет и разделительные слеши. Пароли, токены и другие секреты держите вне параметров перехода: они могут попасть в историю браузера и журналы запросов.

Возврат после входа

Значение next из запроса нельзя напрямую подставлять в Location. Пользователь сможет сформировать ссылку на ваш сайт, которая отправит посетителя на произвольный внешний ресурс. Проверки первого слеша тоже недостаточно: адрес с двумя начальными слешами браузер интерпретирует как переход на указанный далее хост. Для ограниченного набора страниц передавайте ключ маршрута и выбирайте адрес из заданного приложением списка.

PHP
<?php
declare(strict_types=1);

// Допустимые страницы после успешного входа.
$destinations = [
    'profile' => '/account/profile/',
    'orders' => '/account/orders/',
];

$next = $_POST['next'] ?? '';
$location = is_string($next)
    ? ($destinations[$next] ?? '/account/')
    : '/account/';

header('Cache-Control: no-store');
header('Location: ' . $location, true, 303);
exit;

Пример рассчитан на вызов после успешной проверки учётных данных. Проверка is_string() также обрабатывает случай, когда параметр пришёл массивом. Если приложению необходимо формировать адрес с именем хоста, берите его из доверенной конфигурации. Значение $_SERVER['HTTP_HOST'] может зависеть от заголовка входящего запроса.

Типичные ошибки header() в PHP

Cannot modify header information — headers already sent

PHP может менять заголовки до отправки начала тела ответа. Вывод через echo, var_dump(), предупреждение PHP, HTML перед открывающим тегом или UTF-8 BOM в подключённом файле может отправить ответ раньше вызова header(). Проверьте в том числе файлы, подключённые через require и include. В файлах, в которых содержится только PHP-код, опускайте закрывающий тег ?>, чтобы пробел или перенос после него не попал в ответ.

PHP
<?php
declare(strict_types=1);

// Записываем место первого вывода в журнал PHP.
if (headers_sent($file, $line)) {
    error_log("Заголовки уже отправлены: {$file}:{$line}");
    exit;
}

header('Location: /catalog/', true, 302);
exit;

headers_sent() полезна при диагностике: её аргументы получают имя файла и номер строки, где начался вывод. Если вывод начался до исполнения скрипта, имя файла может быть пустым. Исправление обычно состоит в том, чтобы перенести редирект перед рендерингом шаблона или убрать случайный вывод. При включённой буферизации вывод может оставаться в памяти и ошибка проявится только после сброса буфера. Это объясняет, почему один и тот же код работает на одной конфигурации и падает на другой.

Цикл, неожиданный 302 и пустой экран

  • Цикл перенаправлений. Проверьте условия перехода у исходного и целевого маршрутов. Пример — страница входа защищена тем же правилом, которое отправляет гостей на вход. Если приложение работает за обратным прокси, проверьте, совпадает ли определяемая приложением схема с внешней.
  • Вместо 301 прилетает 302. Укажите статус третьим аргументом header(), завершите обработчик и проверьте первый ответ без автоматического следования за редиректами. Если первый ответ верный, проверьте следующие переходы: их может добавлять другой обработчик или прокси.
  • Пустой экран или прежняя страница. Посмотрите статус, Location и предупреждения в журнале PHP. Проверьте, отвечает ли целевая страница. Если запрос сделан через fetch(), браузер может выполнить переход внутри запроса, оставив адрес текущей вкладки прежним.

Что важно в PHP 8.3, 8.4 и 8.5

В PHP 8.3–8.5 вызов header('Location: /catalog/', true, 302) работает одинаково. Код ответа задавайте целым числом, флаг замены — логическим значением, заголовок — строкой. declare(strict_types=1); действует на скалярные аргументы вызовов из данного файла. Входные данные из $_GET и $_POST по-прежнему требуют проверки типа и допустимых значений.

Начиная с PHP 8.4, exit() ведёт себя как функция: его можно вызвать через переменную или именованный аргумент, а при передаче аргумента применяются правила типизации, включая strict_types. В PHP 8.3 у exit прежнее специальное поведение. Для обычного редиректа используйте exit; без аргумента: эта форма одинакова во всех трёх версиях. Число внутри exit(302) задаёт код завершения процесса. HTTP-статус выставляет header() или http_response_code().

Проверяйте редирект через веб-сервер и в панели «Сеть» браузера. Запуск файла командой php в терминале использует CLI и не создаёт HTTP-ответа, который мог бы получить браузер. Для диагностики POST смотрите метод первого запроса и метод запроса после перехода.

Чек-лист перед публикацией редиректа

  1. Выберите статус по назначению. 301 — постоянный переезд, 302 — временный переход, 303 — страница результата после POST, 307 или 308 — перенос с сохранением метода и тела.
  2. Укажите код в третьем аргументе header(). Сформируйте Location из пути приложения или доверенной конфигурации, а параметры запроса закодируйте отдельно.
  3. Установите заголовки до вывода, завершите обработчик через exit; или верните ответ с редиректом из контроллера.
  4. Проверьте первый ответ, конечную страницу и всю цепочку переходов. Для POST отдельно проверьте, что запись выполняется один раз при отправке формы, а обновление результата повторяет только GET.
  5. Проверьте правила кеширования. Для перехода, зависящего от сессии, используйте Cache-Control: no-store, если ответ нельзя сохранять.

Частые вопросы

Какой код PHP отправит при header Location без третьего аргумента?

По умолчанию PHP выставит 302. Если уже установлен код 201 или статус из группы 3xx, PHP сохранит его. Для предсказуемого результата передавайте статус явно.

Зачем ставить exit после header Location?

Вызов header() задаёт заголовок и позволяет скрипту выполняться дальше. exit завершает обработчик, чтобы код ниже не менял данные, тело ответа или заголовки.

Какой статус использовать после отправки формы методом POST?

Используйте 303, если форма уже обработана и нужно открыть страницу результата методом GET. Если клиент должен отправить тот же POST с исходным телом другому обработчику, используйте 307 для временного переноса или 308 для постоянного.

Справка по теме

Ещё в разделе «Справочник PHP»

Сессии в PHP: session_start, хранение данных и безопасность

Как запустить сессию в PHP через session_start, хранить данные в $_SESSION, настроить cookie, сменить идентификатор при входе и завершить сессию.

8 мин

Сортировка массивов в PHP: sort, usort, ksort и другие

Как сортировать массивы в PHP 8.3–8.5 по значениям, ключам и полям: примеры sort, usort, ksort и array_multisort, флаги сравнения и типичные ошибки.

8 мин

Строки в PHP: длина, поиск, замена и обрезка

Как узнать длину строки в PHP, найти и вырезать подстроку, заменить или удалить текст, обрезать пробелы и обработать переносы строк в PHP 8.3–8.5.

10 мин

Типы данных и преобразование типов в PHP

Типы данных в PHP 8.3–8.5: как узнать тип переменной, преобразовать строку в число, проверить null через isset и empty, разделить и округлить числа.

10 мин