エラーの理由
このエラーは HTTP ヘッダーを変更する関数(後述)の呼び出しより前に、すでに何かがアウトプットされているために発生します。
HTTP ヘッダーを変更する関数
HTTP ヘッダーを変更する関数には以下のようなものがあります。
アウトプット
アウトプットには以下のようなものがあります。
意図したアウトプット
print
、echo
、readfile
、passthru
など出力を伴う関数での出力
<?php
の前や、 <?php
〜 ?>
の外にある、生の <html>
コードなどの出力
どういうことか?
なぜアウトプットの前にヘッダーを送信する必要があるのか、代表的な HTTP レスポンスを見てみます。
HTTP レスポンスは以下のようなものです。
HTTP/1.1 200 OK
Powered-By: PHP/5.3.7
Vary: Accept-Encoding
Content-Type: text/html; charset=utf-8
<html><head><title>PHP page output page</title></head>
<body><h1>Content</h1> <p>Some more output follows...</p>
and <a href="/"> <img src=internal-icon-delayed> </a>
HTTP レスポンスは、ヘッダー部と実データのボディ部に分かれ、それらが空行で区切られ送信されます。常に実データ(アウトプット)の前にヘッダーは送信されます。
PHP スクリプトは主に HTML コンテンツを生成しアウトプットしますが、HTTP ヘッダーも同時に送信します。
PHP はアウトプット(echo
や print
、<html>
など)が行われると、全ての HTTP ヘッダーを送出し、ボディ部の出力を開始します。
また、ボディ部の出力が開始された後には、ヘッダーを送信する(し直す)ことは出来ません。
アウトプットが行われた後に HTTP ヘッダーを変更する関数が呼ばれると、ヘッダーを変更する事が出来ないため以下のエラーが発生します。
Warning: Cannot modify header information - headers already sent (output started at script:line)
問題の解決方法
header()
warning メッセージには、問題に関連した情報が含まれています。
Warning: Cannot modify header information - headers already sent by
(output started at /some/file.php:12) in /some/file.php on line 23
上記のエラーは、/some/file.php
の 23 行目で header()
関数の呼び出しに失敗したということです。
また "output started at" のカッコ書き部分に、アウトプットがすでに行われた箇所が書かれています。この場合、/some/file.php
の 12行目 がそれにあたります。
これらを元に、出力の前に header()
関数を呼び出すか、header()
関数が呼び出された後でアウトプットを開始するようにすれば問題が解決できます。
よくあるケース
print, echo
print
や、echo
文など意図的なアウトプットを伴う文や関数より後に HTTP ヘッダーを変更する関数を使用することは出来ません。
アウトプットの前に HTTP ヘッダーを変更する関数を呼び出すように変更してください。
以下のような関数はアウトプットを伴います。
print
, echo
, printf
, vprintf
trigger_error
, ob_flush
, var_dump
, print_r
readfile
, passthru
, imagepng
, imagejpeg
生の HTML ブロック
PHPとしてパースされない、<?php
より前や、 <?php
〜 ?>
の外にあるブロックは、直接アウトプットされます。
HTTP ヘッダーを変更する関数 より前にこのようなブロックは存在できません。
<!DOCTYPE html>
<?php
// ヘッダーはすでに送信されています。
// もう HTTP ヘッダーを変更する関数 は利用出来ません。
制御ロジックとアウトプットロジックを分離するようにします。
- スクリプトの先頭に制御ロジックを記述します
- 一時的な文字列変数などを用いて後でアウトプットできるようにします
- 実際のアウトプットロジックと HTML の出力は最後に行います
制御ロジックとアウトプットロジックの分離のために、Smarty や Twig といったテンプレートエンジンを使うのもいいと思います。
<?php
の前にあるスペースによる "script.php line 1" Warning
1 行目で出力がある、という Warning が表示されている場合、PHP 開始タグ <?php
の前にスペースや空行がある場合が多いです。
<?php
// ファイルの先頭には <? の前に隠されたスペースが存在します。
同様に、スクリプトのブロックの間にスペースや空行が存在することもあります。
?>
<?php
実際には、PHP は閉じタグ ?>
の後にある 一つの 改行は無視します。
ですが、複数行の改行やタブやスペースが含まれているとそれがアウトプットされます。
UTF-8 BOM
上記した改行やスペース以外にも同じような問題が発生する見えない文字もあります。
よく知られているのは UTF-8 BOM です。これは多くのテキストエディタで見えませんが、ファイルの先頭に EF BB BF
というバイト列が含まれます。PHP はこのバイト列をそのままアウトプットしようとします。
これを解決するには、ファイル保存時に「UTF-8(BOMなし)」や「UTF-8N」などの BOM が出力されない指定を行ってください。
Windows のメモ帳は BOM なしで保存することが出来ない(未確認)ため、他のエディタの利用をお勧めします。
?>
の後ろにあるスペース
PHP 終了タグ ?>
の後でアウトプットがあると表示される場合、終了タグの後でスペースや生のテキストが出力されています。PHP 終了タグ以降もスクリプトの実行は行われるため、PHP 終了タグの後のスペースやテキストはアウトプットされます。
なお、PHP 終了タグ ?>
は必須ではないため、必要のない場合は ?>
を省略することをお勧めします。これにより、この問題の発生を低減できます。(このケースの多くは、include
や require
したファイルで起きます)
<?php
// ...いろいろな記述
// 最後の ?> は不要
"Unknown on line 0" とエラー表示される場合
これは、PHPエクステンションや php.ini 設定に問題がある場合が多いです。
- PHP モジュールの二重ロードや、php.ini 設定の不備により、PHP の開始時の Warning メッセージが出力されている場合。
gzip
ストリームエンコーディング設定、ob_gzhandler
で起こる場合があります。
エラーメッセージ
HTTP ヘッダーを変更する関数より前の文で PHP の Warning や Notice エラーがある場合、それがすでにアウトプットされているため、このエラーが起きます。
エラーメッセージが表示されない場合
php.ini
で error_reporting
や display_errors
をオフにしている場合、エラーが表示されていなくても問題がある場合があります。
例えば、header("Location: ...")
でリダイレクトを行おうとしても、このエラーが起きている場合、リダイレクトは失敗します。
このような場合、スクリプトの最上部で以下のようにしてエラーを表示させるようにする事ができます。
error_reporting(E_ALL);
ini_set("display_errors", 1);
または set_error_handler("var_dump");
のようにエラーが起きた場合のハンドラを指定する事もできます。
アウトプットバッファリング(出力制御)による回避
PHP のアウトプットバッファリング(出力制御)を行う事でこの問題を回避することもできます。
output_buffering=
設定を php.ini か、.htaccess などで行います。
これを有効にすると、PHP はアウトプットをすぐに Web サーバーに送信せず、バッファリングします。それにより、PHP が HTTP ヘッダを集約できます。
起動スクリプトの最初に ob_start();
を呼び出して同様のことを行えます。
ただし、スクリプトの最初で <?php ob_start(); ?>
をしたとしても、それより前に BOM や空白が含まれていた場合、回避することはできません。
ただし、アプリケーションが生成した画像などバイナリデータを送信しようとする場合、バッファリングされた余分な空白が問題となったり、開発環境の構築や、開発サーバーと運用サーバーとの切り替えで問題が生じたりする場合があるため、推奨はできません。
基本的な使用法も併せて参照ください。
headers_sent()
によるチェック
headers_sent()
により、すでにヘッダーが送信済みかどうかをチェックできます。
これは条件によって情報を出力したり、フォールバックを行う際に便利です。
if (headers_sent()) {
die("リダイレクトに失敗しました。このリンクをクリックしてください: <a href=...>");
} else{
// リダイレクトする
exit(header("Location: /user.php"));
}
他の回避方法
HTML <meta>
タグでのリダイレクト
もし、アプリケーションの修正が構造的に難しいような場合、HTML の <META>
タグを用いてリダイレクトを行うことも可能です。
<meta http-equiv="Refresh" content="0; URL=/user.php">
JavaScript でのリダイレクト
代替手段として JavaScriptでのリダイレクトを行う事もできます。
<script> location.replace("target.html"); </script>
ただし、JavaScript が動くブラウザでのみしか利用出来ません。
関連リンク
この回答は以下の本家SOの回答を翻訳・再構成したものです。
https://stackoverflow.com/a/8028987/4369063 @mario
https://stackoverflow.com/a/8028979/345031 @phihag