［PHP］header関数とは？使い方から実践例まで完全解説【初心者向け】

PHP

PHPでWebアプリケーションを開発していると、ページのリダイレクトやファイルのダウンロード、キャッシュ制御など、様々な場面でHTTPヘッダーを操作する必要があります。そんな時に活躍するのがheader関数です。

今回は、PHPのheader関数について、基本的な使い方から実践的な活用例まで、初心者にも分かりやすく詳しく解説していきます。

header関数とは？

header関数は、PHPからHTTPヘッダーを送信するための組み込み関数です。Webサーバーからブラウザやクライアントアプリケーションに対して、様々な情報や指示を伝えることができます。

基本構文

header(string $header, bool $replace = true, int $response_code = 0)
  • $header: 送信するヘッダー文字列
  • $replace: 同じヘッダーを置き換えるかどうか（デフォルト: true）
  • $response_code: HTTPレスポンスコードを設定

header関数の重要なルール

header関数を使用する際には、以下の重要なルールを理解しておく必要があります。

1. HTMLの出力前に実行する

最も重要なルールは、header関数はHTMLやテキストの出力前に実行しなければならないということです。

<?php
// ❌ 間違った例
echo "Hello World";
header("Location: https://example.com"); // エラーが発生
?>

<?php
// ✅ 正しい例
header("Location: https://example.com");
echo "Hello World";
?>

2. 空白文字にも注意

PHPの開始タグ前に空白があるだけでもエラーになります。

 <?php // ❌ 開始タグ前に空白がある
header("Location: https://example.com");
?>

<?php // ✅ 正しい書き方
header("Location: https://example.com");
?>

実践的な使用例

1. ページリダイレクト

最も頻繁に使用される機能の一つです。

<?php
// 別のページにリダイレクト
header("Location: https://example.com/success.php");
exit(); // リダイレクト後の処理を停止
?>

重要: リダイレクト後は必ずexit()またはdie()を呼び出して、後続の処理を停止しましょう。

2. HTTPステータスコードの設定

<?php
// 404 Not Found
header("HTTP/1.1 404 Not Found");

// または
http_response_code(404);
header("Content-Type: text/html; charset=UTF-8");
?>

3. コンテンツタイプの指定

<?php
// JSON形式のデータを返す
header("Content-Type: application/json; charset=UTF-8");
echo json_encode(["message" => "Hello World"]);
?>

<?php
// CSVファイルとしてダウンロード
header("Content-Type: text/csv");
header("Content-Disposition: attachment; filename=\"data.csv\"");
echo "名前,年齢,職業\n";
echo "田中太郎,30,エンジニア\n";
?>

4. キャッシュ制御

<?php
// キャッシュを無効にする
header("Cache-Control: no-cache, must-revalidate");
header("Expires: Sat, 26 Jul 1997 05:00:00 GMT");
header("Pragma: no-cache");
?>

<?php
// 1時間キャッシュする
header("Cache-Control: public, max-age=3600");
header("Expires: " . gmdate("D, d M Y H:i:s", time() + 3600) . " GMT");
?>

5. ファイルダウンロード

<?php
$filename = "sample.pdf";
$filepath = "/path/to/file/" . $filename;

if (file_exists($filepath)) {
    header("Content-Type: application/octet-stream");
    header("Content-Disposition: attachment; filename=\"" . $filename . "\"");
    header("Content-Length: " . filesize($filepath));
    readfile($filepath);
    exit();
} else {
    header("HTTP/1.1 404 Not Found");
    echo "ファイルが見つかりません";
}
?>

6. CORS（Cross-Origin Resource Sharing）の設定

<?php
// 特定のドメインからのアクセスを許可
header("Access-Control-Allow-Origin: https://example.com");

// すべてのドメインからのアクセスを許可（開発環境のみ推奨）
header("Access-Control-Allow-Origin: *");

// 許可するHTTPメソッド
header("Access-Control-Allow-Methods: GET, POST, PUT, DELETE");

// 許可するヘッダー
header("Access-Control-Allow-Headers: Content-Type, Authorization");
?>

よくあるエラーとその対処法

1. “Headers already sent” エラー

<?php
echo "何かの出力"; // この行が原因
header("Location: redirect.php"); // エラー発生
?>

対処法:

  • header関数を出力より前に移動する
  • 出力バッファリング（ob_start()）を使用する
<?php
ob_start(); // 出力バッファリング開始
echo "何かの出力";
header("Location: redirect.php");
ob_end_clean(); // バッファをクリア
?>

2. 文字エンコーディングの問題

<?php
// 日本語を含むヘッダーを送信する場合
header("Content-Disposition: attachment; filename=\"" . urlencode("日本語ファイル名.txt") . "\"");
?>

セキュリティ上の注意点

1. オープンリダイレクト脆弱性

<?php
// ❌ 危険な例
$redirect_url = $_GET['url'];
header("Location: " . $redirect_url);
?>

<?php
// ✅ 安全な例
$redirect_url = $_GET['url'];
$allowed_urls = [
    'https://example.com/page1.php',
    'https://example.com/page2.php'
];

if (in_array($redirect_url, $allowed_urls)) {
    header("Location: " . $redirect_url);
} else {
    header("Location: /error.php");
}
?>

2. HTTPヘッダーインジェクション

<?php
// ❌ 危険な例
$user_input = $_GET['type'];
header("Content-Type: " . $user_input);
?>

<?php
// ✅ 安全な例
$user_input = $_GET['type'];
$allowed_types = ['text/html', 'application/json', 'text/plain'];

if (in_array($user_input, $allowed_types)) {
    header("Content-Type: " . $user_input);
} else {
    header("Content-Type: text/html");
}
?>

まとめ

header関数は、PHPでWebアプリケーションを開発する上で欠かせない重要な関数です。基本的な使い方から実践的な活用例まで理解することで、より柔軟で機能的なWebアプリケーションを開発できるようになります。

重要なポイントをもう一度整理すると：

  • 出力前に実行することが最重要
  • リダイレクト後はexit()を忘れずに
  • セキュリティ対策を怠らない
  • 用途に応じて適切なヘッダーを設定する

これらのポイントを押さえて、header関数を効果的に活用してください。実際の開発では、様々なケースに応じてheader関数を使い分けることで、ユーザビリティとセキュリティの両方を向上させることができます。

タイトルとURLをコピーしました