PHP 「Cannot modify header information – headers already sent」の原因と解決方法【HTTPヘッダー操作の落とし穴】

Cannot modify header information – headers already sent とは

PHPでWebアプリケーションを開発していると、一度は遭遇するであろう「Cannot modify header information – headers already sent」エラー。このエラーは、HTTPヘッダーが既にクライアントに送信された後に、再度ヘッダーを変更しようとした際に発生します。特にリダイレクトやセッション管理で頻繁に問題となりますが、原因が分かりづらく、デバッグに時間を要することも多いでしょう。

エラーの発生パターン

このエラーは主に以下のようなケースで発生します。

パターン1: HTMLコンテンツ出力後の `header()` 関数呼び出し

Welcome!
";

// ここでヘッダーは既に送信されている
header("Location: /dashboard.php"); // Fatal error: Cannot modify header information
exit();
?>

`echo` や `print` といった関数でHTMLコンテンツが出力されると、その時点でHTTPヘッダーもクライアントに送信されてしまいます。一度ヘッダーが送信されると、その後に `header()` 関数を使ってリダイレクトなどのヘッダー操作を行おうとしても、「headers already sent」エラーが発生します。

パターン2: PHPファイルの先頭にある空白文字やBOM（Byte Order Mark）

PHPスクリプトファイルの先頭に、PHPタグ `空白文字（スペース、タブ、改行）や、UTF-8 BOM（Byte Order Mark）が含まれている場合、それらがコンテンツとして解釈され、ヘッダーが送信されてしまいます。特にBOMは目に見えないため、原因特定が困難になりがちです。

パターン3: `print_r` や `var_dump` などデバッグ出力の使用

 1, 'name' => 'Test'];
var_dump($data); // デバッグ出力でヘッダーが送信される

// その後でクッキーを設定しようとするとエラー
setcookie('user_session', 'abc', time() + 3600);
?>

開発中にデバッグ目的で `print_r()`、`var_dump()`、`echo` などの関数を使用して変数の中身を出力すると、その出力がHTTPヘッダーよりも先にクライアントに送信されてしまいます。これにより、その後の`setcookie()` や `header()` などのヘッダー操作が失敗します。

 1, 'name' => 'Test'];

// デバッグ出力は条件付きにするか、ヘッダー送信後に移動するか、ログファイルに出力する
// if (ENV === 'development') { var_dump($data); }
error_log(print_r($data, true)); // ログに出力

// ヘッダー操作は出力より前に行う
setcookie('user_session', 'abc', time() + 3600);
?>

根本原因の特定方法

エラーメッセージに表示される `{marker}output started at …{/marker}` の箇所を特定し、そのファイルと行番号を確認することが第一歩です。その行に直接の出力がない場合でも、その行より前に何らかの出力が発生している可能性を疑いましょう。`grep` コマンドやIDEの検索機能で、ファイル内の `echo`, `print`, `var_dump`, `print_r` などの出力関数、またはPHPタグ外の文字を検索します。

防止策とベストプラクティス

最も確実な予防策は、{marker}HTTPヘッダーを操作する処理（`header()`、`setcookie()`、`session_start()` など）を、あらゆるコンテンツ出力よりも前に行う{/marker}ことです。また、PHPファイルの保存時にBOMなしUTF-8エンコーディングを使用し、ファイルの先頭や末尾に不要な空白文字や改行を入れないように徹底しましょう。

よくある質問（FAQ）

この用語と一緒に知っておきたい用語