<META HREF="function.headers-sent.html"><META

説明

int header ( string string [, bool replace])

header()関数は、HTMLファイルの送信に先立って、生のHTTPヘッダ文字列を送信するために使用します。HTTPヘッダの詳細は、 HTTP 1.1 Specificationを参照して下さい。

オプションのパラメータ replace は、ヘッダが前に送信された類似のヘッダを置換するか、または、同じ形式の二番目のヘッダを追加するかどうかを指定します。デフォルトでは、この関数は、置換を行ないますが、二番目の引数にFALSE を指定すると、同じ型の複数のヘッダを強制的に生成します。例えば、

header('WWW-Authenticate: Negotiate');
header('WWW-Authenticate: NTLM',false);

特殊なheaderコールが2種類あります。最初のは、"Location" ヘッダーです。このヘッダーはブラウザに返されるだけではなく、 ApacheにREDIRECTステータスコードを返します。スクリプトの作者にとっては、この点はあまり重要ではありませんが、Apacheの内部動作を知る人にとっては、理解しておくべき重要なこととなります。

header("Location: http://www.php.net/");  /* ブラウザをPHP Web サイトに
                                            リダイレクトする */
exit;                 /* リダイレクトを行う際に以下のコードが
                         実行されないようにする */

注意 HTTP/1.1では、スキーム、ホスト名、絶対パスを含む絶対 URIがLocation: の引数として必要ですが、いくつかのクライアントでは相対URIも受けつけます。通常、相対URIから絶対URIを作成するために $HTTP_SERVER_VARS['HTTP_HOST'],$HTTP_SERVER_VARS['PHP_SELF'], dirname()を使用することが可能です。
header("Location: http://".$HTTP_SERVER_VARS['HTTP_HOST']
                      ."/".dirname($HTTP_SERVER_VARS['PHP_SELF'])
                      ."/".$relative_url);

2番目の特別なヘッダは、文字列"HTTP/" から始まる全てのヘッダ(大文字・小文字は区別されません)です。このヘッダは、送信するHTTPステータスコードを示すために使用されます。例えば、存在しないファイルへのリクエストを処理するためにあるPHPスクリプトを使用するよう(ErrorDocumentディレクティブにより)Apacheを設定する場合、そのスクリプトが正しいステータスコードを返すようにする必要があります。

header("HTTP/1.0 404 Not Found");

注意 PHP 3では、このコードは、PHPがApacheモジュール版としてコンパイルされている場合にのみ動作します。Statusヘッダを用いて同じ効果を得ることが可能です。
header("Status: 404 Not Found");

PHPスクリプトはしばしば動的に HTML を生成するため、クライアントブラウザやサーバーおよびクライアントブラウザの間でプロキシがキャッシュを行ったりするべきではありません。多くのプロキシとクライアントでは、以下のコードにより強制的にキャッシュを無効にできます。

header("Expires: Mon, 26 Jul 1997 05:00:00 GMT");    // 日付が過去
header("Last-Modified: " . gmdate("D, d M Y H:i:s") . " GMT"); 
                                                     // 常に修正されている
header("Cache-Control: no-store, no-cache, must-revalidate");  // HTTP/1.1
header("Cache-Control: post-check=0, pre-check=0", false);
header("Pragma: no-cache");                          // HTTP/1.0

注意上記のヘッダを全て出力しなかったとしてもページのキャッシュが行われない場合があることに気付くかもしれません。デフォルトのブラウザのキャッシュの動作をユーザが変更できる手段はいくつもあります。上記のヘッダを送信することにより、スクリプトの出力がキャッシュされる可能性がある設定を上書きするべきです。
加えて、session_cache_limiter()および設定session.cache_limiterをセッションが使用された際にキャッシュ関係のヘッダを正しく自動的に生成するために使用できます。

覚えておいて頂きたいのは、header() 関数は、通常の HTML タグまたは PHP からの出力にかかわらず、すべての実際の出力の前にコールする必要があることです。頻出するエラーとして、include() または require() 関数、他のファイルをアクセスする関数に空白または空行があり、header() の前に出力が行われてしまうというものがあります。同じ問題は、単一の PHP/HTMLファイルを使用している場合でも存在します。

<?php require("user_logging.inc") ?>

<?php header ("Content-type: audio/x-pn-realaudio"); ?>
// 動作しません。上の空行に注意して下さい。

注意 PHP 4では、この問題に対処するために出力のバッファリングを使用することが可能です。この場合、ブラウザへの出力が送信するまでサーバに全てバッファリングされるオーバーヘッドがあります。出力バッファリングは、ob_start()と ob_end_flush()をスクリプトでコールするか php.iniまたはサーバ設定ファイルの設定ディレクティブoutput_bufferingを設定することにより行うことが可能です。

PDFファイルを生成するといったように送信するデータを保存するかどうかユーザにプロンプトを表示したい場合、推奨されるファイル名を指定してブラウザに保存ダイアログを表示させるContent-Dispositionヘッダを使用可能です。

<?php
header("Content-type: application/pdf");
header("Content-Disposition: attachment; filename=downloaded.pdf");

/* ... PDFファイルを出力 ... */

注意 Microsoft Internet Explorer 4.01にはこれが動作しないというバグがあります。この解決策はありません。Microsoft Internet Explorer 5.5にもこれを妨げるバグがあります。これは、サービスパック2以降とすることで修整可能です。

headers_sent(), setcookie()及び HTTP認証の節も参照下さい。