その他

PHPのhttp_response_codeで500エラーを返す方法を解説

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

PHPのhttp_response_code関数を使うと、HTTPレスポンスのステータスコードを簡単に設定できます。

特に500エラーは、サーバ内部で予期せぬエラーが発生した場合に返される代表的なコードです。

本記事では、PHPで500エラーを返す際の基本的な使い方と、その背景にある考え方や注意点について解説します。

目次から探す

http_response_code関数の基本動作
- HTTPステータスコードの役割
- 関数の基本的な使用方法
PHPで500エラーを生成する方法
- 500エラー出力の実装例
- エラーハンドリングとの連携
注意事項と運用上のポイント
- セキュリティ上の考慮事項
- 開発環境での確認ポイント
まとめ

http_response_code関数の基本動作

HTTPステータスコードの役割

HTTPステータスコードは、サーバとクライアント間の通信結果を数値で表現します。

各数値は、正常終了やエラーの種類などを示しており、クライアント側での処理や画面表示の条件分岐に利用されます。

500エラーの意味と影響

500エラーは、サーバ内部の問題によって要求の処理が正常に行われなかった場合に返されるエラーコードです。

サーバ側で予期しないエラーが発生したことを示す
クライアント側では、エラー画面への遷移やエラーメッセージの表示などの動作となる

500エラーが返されると、ユーザに対して情報の不一致を防ぐため、具体的なエラー情報が公開されないようにする配慮が必要です。

他の主要ステータスコードとの比較

他に使用される主要なステータスコードには、以下のようなものがあります。

200: 正常終了を示し、要求されたデータが問題なく返される
404: リクエストされたリソースが見つからない場合に返される
302: ページが一時的に移動している場合に使用され、リダイレクト処理を促す

これらと比較して、500エラーはサーバ内部の処理異常を示すため、開発および運用側で迅速な対応が求められます。

関数の基本的な使用方法

http_response_code() は、PHP標準の関数としてHTTPレスポンスのステータスコードを設定するために利用されます。

基本記述方法の確認

基本的な記述方法は、以下の通りです。

<?php
// 任意のHTTPステータスコードを設定する
http_response_code(200);
?>

この関数に整数値を渡すことで、HTTPレスポンスのステータスを変更することができます。

デフォルトでは、既に出力を行う前に設定する必要があります。

動作確認のポイント

PHPスクリプトの冒頭で設定することで、出力前にステータスコードを変更する
ブラウザのデベロッパーツールやcurlコマンドを利用して、レスポンスヘッダに正しいステータスが設定されていることを確認する
ローカル環境や開発環境で十分に動作確認を行い、本番環境への影響を防止する

PHPで500エラーを生成する方法

500エラー出力の実装例

500エラーを返す際は、エラー発生箇所でhttp_response_code(500)とすることで、サーバ内部の問題を示すHTTPステータスを出力することができます。

コード例の提示

以下は、PHPで500エラーを出力するサンプルコードです。

<?php
// PHPのエラーハンドリング例：500エラーを出力する
// システムエラーを模倣するための条件分岐
$errorCondition = true;
if ($errorCondition) {
    // HTTPステータスを500に設定する
    http_response_code(500);
    // エラーメッセージを表示(ユーザ向けには詳細な情報は控える)
    echo "Internal Server Error.";
    // スクリプトの終了
    exit;
}
// 通常処理の場合のコード
echo "正常に処理されました。";
?>

Internal Server Error.

処理の流れの説明

$errorCondition によりエラー発生が確認される
http_response_code(500) により、HTTPステータスコードが500に設定される
ユーザへエラーメッセージ "Internal Server Error." を表示する
exit により処理が終了し、以降の処理が実行されないようにしている

エラーハンドリングとの連携

実際の運用では、500エラー発生時に適切なエラーハンドリングを行い、ログの記録やユーザ向けの適切なエラーレスポンスを返すことが重要です。

エラーログ連動の方法

エラーハンドリングには、下記のようにログ出力機能を連携するケースがあります。

<?php
// エラーログ記録用の例
// エラー発生をシミュレーションする条件
$isError = true;
if ($isError) {
    // HTTPステータスを500に設定
    http_response_code(500);
    // ログファイルにエラー情報を書き込む
    error_log("500 error detected in " . __FILE__);
    echo "Internal Server Error.";
    exit;
}
?>