PHP header関数の使い方と注意点について解説

2025-02-19更新日: 2025-02-19

PHPのheader関数はHTTPレスポンスのヘッダー情報を操作するために利用されます。

たとえば、リダイレクト処理やキャッシュ制御、コンテンツタイプの指定など、ウェブページの挙動に深く関わる機能です。

この記事では、header関数の基本的な使い方と注意点についてわかりやすく解説します。

目次から探す

PHP header関数の基本
- header関数の役割と動作
- 基本構文とパラメータの説明
利用例と実装
エラー防止と運用上の注意
- ヘッダー送信エラーの原因
- 出力バッファの活用方法
まとめ

PHP header関数の基本

header関数の役割と動作

header関数は、HTTPレスポンスヘッダーを送信するために利用される関数です。

リクエストに対するレスポンス情報をブラウザに伝えるため、リダイレクトやキャッシュ制御、コンテンツタイプの指定など、さまざまな用途に用いられます。

この関数を呼び出すと、まだ出力が行われていない場合に限り、HTTPヘッダーの情報を生成し、ブラウザに送信する動作となります。

出力後に呼び出すとエラーが発生するため、コードの記述順序には注意が必要です。

基本構文とパラメータの説明

PHPでheader関数は以下のようなシンプルな構文で利用されます。

header( "Header-Name: Header-Value" );

各パラメータの説明は以下の通りです。

Header-Name: 送信するHTTPヘッダーの名前です。例えば、LocationやContent-Typeなどが該当します。
Header-Value: ヘッダーに設定する値です。数値や文字列など、適切な値を指定します。

また、オプションとして第2引数にブール値を指定することができ、この値がtrueの場合、同名のヘッダーが既に存在する場合に上書きされます。

第3引数にはHTTPのリダイレクト時に利用されるステータスコードが指定可能です。

このように、header関数は柔軟にHTTPヘッダーを扱うための活動ツールとなっています。

利用例と実装

リダイレクト処理の実装

リダイレクト用コード例

以下のサンプルコードでは、ユーザを新しいURLへリダイレクトする例です。

コード内では、コメントを用いて動作を説明しています。

<?php
// リダイレクト先のURLを指定する
$url = "http://example.com/new-location";
// HTTPステータスコード 302(Found)を指定してリダイレクトする
header("Location: " . $url, true, 302);
// スクリプトの終了処理
exit;
?>

output
(ブラウザは指定されたURL http://example.com/new-location にリダイレクトされます)

送信順序に関する注意点

header関数は、出力が行われる前に呼び出す必要があります。

例えば、HTMLなどの出力が始まる前にヘッダー情報を送信しなければなりません。

そのため、リダイレクトやその他のヘッダー操作は、エコーなどの出力処理の前に実行するよう心がける必要があります。

また、PHPの設定やフレームワークによっては出力バッファが有効になっている場合もあるため、その特性を理解した上でコードを記述してください。

キャッシュ制御の設定

キャッシュ関連ヘッダーの設定例

キャッシュ制御を明示するためには、以下のようなヘッダーを利用できます。

次のサンプルコードは、クライアントおよびプロキシによるキャッシュを無効にする例です。

<?php
// キャッシュを無効にするためのヘッダーを設定する
header("Cache-Control: no-store, no-cache, must-revalidate");
header("Cache-Control: post-check=0, pre-check=0", false);
header("Pragma: no-cache");
// 続く処理に必要なコードがあれば記述する
?>

output
(キャッシュが無効化されるため、最新情報が必ず表示されます)

実装時の留意事項

キャッシュ制御ヘッダーを設定する際は、ブラウザやプロキシサーバがヘッダー情報を正しく解釈するかを確認してください。

複数のキャッシュ制御ヘッダーを設定する場合、header関数の第2引数で重複動作を避けるよう注意する必要があります。

また、異なるユーザエージェントに対して適切なキャッシュ戦略を検討することも重要です。

コンテンツタイプの指定方法

設定コードの具体例

header関数を利用して出力するコンテンツタイプを指定することができます。

次のコードは、レスポンスのコンテンツタイプをtext/htmlに設定する例です。

<?php
// ブラウザに送信するコンテンツタイプとしてHTMLを指定する
header("Content-Type: text/html; charset=UTF-8");
// 以下にHTML出力のコードを記述する
echo "<html><body><h1>コンテンツタイプ指定のサンプル</h1></body></html>";
?>

output
<html><body><h1>コンテンツタイプ指定のサンプル</h1></body></html>

実行時の考慮点

コンテンツタイプを変更する場合、スクリプト内の出力やファイルの構造に合わせて正確なMIMEタイプを設定する必要があります。

特に、文字コードやキャラクターエンコーディングに留意し、不正な表示や文字化けが発生しないよう注意が必要です。

また、他のレスポンスヘッダーとの整合性を確認しておくと、ブラウザ上での表示に問題が生じにくくなります。

エラー防止と運用上の注意

ヘッダー送信エラーの原因

header関数の呼び出し時に出力が始まっていると、以下のようなエラーが発生します。

Warning: Cannot modify header information - headers already sent by ...

このエラーは、出力前にヘッダー情報が送信されていることが原因です。

文字列やHTMLの出力が行われる前に、確実にheader関数を呼び出すことで、エラーを防ぐことができます。

また、PHPファイルの先頭やエンコーディングに関する設定も確認することが必要です。

出力前の確認ポイント

PHPスクリプトの先頭に余分な空白や改行がないか確認する
他の出力関数(echo, print等)が実行される前にheader関数を呼び出しているかチェックする
出力バッファリングob_start()が正しく活用されているか確かめる

これらの項目を確認することで、ヘッダー送信エラーを防ぐことができるように配慮してください。

出力バッファの活用方法

バッファ設定の実施例

出力バッファを利用することで、ヘッダー情報を安全に送信することが可能となります。

以下のサンプルコードは、出力バッファを開始し、ヘッダー情報の設定後にバッファをフラッシュする例です。

<?php
// 出力バッファを開始する
ob_start();
// ヘッダー情報を設定する
header("Content-Type: text/plain; charset=UTF-8");
// 出力を行う処理
echo "出力バッファを利用したサンプルコード";
// バッファにたまった内容をすべて送信し、バッファを終了する
ob_end_flush();
?>

output
出力バッファを利用したサンプルコード

この方法を利用することで、意図しない出力が発生しても、ヘッダー情報の送信を適切に管理することができるため、エラー防止に役立ちます。

まとめ

この記事では、PHPのheader関数を利用する基本的な方法やリダイレクト、キャッシュ制御、コンテンツタイプ設定、エラー防止について学びました。

HTTPヘッダーの正しい設定は、ウェブアプリケーションの安定運用に直結する重要な要素であることが確認されました。

ぜひ、実際にコードに取り入れて動作確認し、理解を深めてみてください。