Полное руководство по исправлению ошибки отправленных заголовков

Продвинутые примеры и методы отладки

1. Использование register_shutdown_function для проверки

Иногда ошибка возникает в уже запущенном скрипте неожиданно. Зарегистрируйте функцию, которая сработает при завершении скрипта и проверит статус заголовков:

register_shutdown_function(function() {
    if (headers_sent($file, $line)) {
        error_log("Headers already sent in $file on line $line");
        // Можно также отправить email администратору
    }
});

Этот код не мешает нормальной работе, но логирует все случаи, когда заголовки были отправлены не вовремя.

2. Отладка с помощью header_list()

Перед вызовом header() можно просмотреть уже отправленные заголовки, чтобы понять, не было ли дублирования или конфликта:

// Список всех заголовков, которые будут отправлены (до фактической отправки)
print_r(headers_list());

// Проверка, есть ли уже заголовок Location
if (in_array('Location: /new-page', headers_list())) {
    // Заголовок уже установлен
}

Результат: массив с заголовками, например ['X-Powered-By: PHP/8.2', 'Content-Type: text/html; charset=utf-8'].

3. Обработка сессий при буферизации

Если сессия запускается после вывода, даже с буферизацией может возникнуть предупреждение. Правильный порядок:

ob_start();
session_start(); // Теперь безопасно, так как вывод в буфере
$_SESSION['user'] = 'admin';
echo 'Данные сессии установлены';
ob_end_flush();

Если забыть вызвать ob_start() до session_start(), PHP выдаст ошибку headers already sent.

4. Перехват вывода через callback ob_start

Можно передать callback-функцию в ob_start(), которая будет модифицировать вывод или записывать его в лог:

ob_start(function($buffer) {
    // Замена ссылок на HTTPS
    return str_replace('http://', 'https://', $buffer);
});

header('Content-Type: text/html');
echo '<a href="http://example.com">Ссылка</a>';

$content = ob_get_clean();
echo $content;
/* Результат:
<a href="https://example.com">Ссылка</a>
*/

Такой подход позволяет контролировать содержимое буфера перед отправкой.

5. Отладка в фреймворках (Symfony)

В Symfony ошибка часто связана с преждевременным выводом в шаблоне или в сервисе. Используйте профилировщик Symfony или вставьте временный код в контроллер:

// app/Controller/DebugController.php
public function debugHeaders() {
    if (headers_sent($file, $line)) {
        $this->addFlash('error', "Заголовки отправлены в $file:$line");
    }
    return $this->redirectToRoute('home');
}

В большинстве случаев причина - echo или var_dump в контроллере или сервисе до вызова header() или return $this->json(...).

6. Принудительная очистка буфера перед header()

Иногда нужно сбросить буфер, если нет возможности заранее его включить:

// Удаляем всё, что было выведено до этого (если есть буфер)
if (ob_get_level()) {
    ob_clean();
}
header('Location: /another-page');
exit;

Важно: ob_clean() очищает только внутренний буфер, но не отменяет факт того, что заголовки уже были отправлены. Если буферизация не была включена, это не поможет.

7. Имитация ошибки и её анализ

Создайте простой скрипт, который воспроизводит проблему, и изучите сообщение об ошибке:

// test.php
echo 'Начало вывода';
header('X-Custom: value');
?>

При запуске PHP выдаст: Warning: Cannot modify header information - headers already sent by (output started at /path/test.php:2). Цифра 2 указывает строку с первым echo. В реальном проекте строка может быть первой пустой строкой файла.