【PHP8.x】error_reporting関数の使い方

<?php

/**
 * PHPのエラー報告を完全にオフにする方法を示すサンプルコードです。
 * error_reporting(0) の基本的な使用方法を、システムエンジニアを目指す初心者向けに解説します。
 */
function demonstrateTurnOffErrorReporting(): void
{
    // エラー報告レベルを変更する前に、現在の設定を取得して表示します。
    // この値は、スクリプトの実行開始時のPHP設定に依存します。
    $oldLevel = error_reporting();
    echo "変更前: 現在のエラー報告レベルは " . $oldLevel . " です。\n";

    // error_reporting(0) を呼び出すことで、PHPのすべてのエラー報告をオフにします。
    // 引数 '0' は、いかなるエラーも報告しないことを意味します。
    // これにより、PHPはエラーが発生してもそれを報告しなくなります。
    error_reporting(0);

    // 変更後のエラー報告レベルを取得し、オフになったことを確認します。
    $newLevel = error_reporting();
    echo "変更後: 新しいエラー報告レベルは " . $newLevel . " です。\n";

    // 注意事項:
    // error_reporting(0) は、PHPがエラーをログに記録したり、
    // カスタムエラーハンドラに渡したりすることを停止します。
    // しかし、エラーがWebページに表示されるかどうかは、php.ini の 'display_errors' 設定に依存します。
    // 本番環境ではセキュリティと情報漏洩防止のため、'display_errors' を 'Off' に設定することが強く推奨されます。
}

// 関数を実行し、エラー報告がオフになることを確認します。
demonstrateTurnOffErrorReporting();

?>

このサンプルコードは、PHPのerror_reporting関数を使って、PHPがどのようなエラーを報告するか、そのレベルを制御する方法を示しています。システムエンジニアにとって、アプリケーションのデバッグや本番環境での安定運用において、エラー報告の管理は非常に重要です。

error_reporting関数を引数なしで呼び出すと、現在設定されているエラー報告レベルを整数値で取得できます。これは、スクリプトの実行開始時や、以前に設定されたレベルを確認する際に役立ち、常に現在のレベルを示す整数が戻り値として返されます。サンプルコードの冒頭では、この方法で現在のレベルを取得し表示しています。

次に、引数に0を指定してerror_reporting(0)を呼び出すと、PHPのすべてのエラー報告を完全にオフにすることができます。引数としての0は、「いかなるエラーも報告しない」という意味を持ちます。これにより、スクリプト内でエラーが発生しても、PHPはそれをログに記録したり、画面に表示したりする動作を停止します。サンプルコードでは、この設定変更後に再度レベルを取得し、0になっていることを確認しています。

ただし、error_reporting(0)を設定しても、エラーメッセージがWebページに表示されるかどうかは、PHPの設定ファイル（php.ini）にあるdisplay_errorsという別の設定に依存します。セキュリティと情報漏洩防止のため、本番環境ではdisplay_errorsをOffに設定し、エラーはログにのみ記録することが強く推奨されます。

<?php

/**
 * error_reporting の設定が期待通りに画面表示されない場合のサンプルコード。
 * display_errors の設定が原因でエラーが表示されない状況を再現し、解説します。
 */
function demonstrateErrorReportingIssue(): void
{
    // 開発環境では通常 E_ALL を設定し、すべてのエラーを報告するようにします。
    // しかし、この設定だけではエラーが画面に表示されるとは限りません。
    error_reporting(E_ALL);

    echo "--- error_reporting(E_ALL) を設定しましたが、画面表示は display_errors に依存します ---" . PHP_EOL . PHP_EOL;

    // display_errors を 'Off' に設定すると、
    // error_reporting で指定されたエラーレベルのエラーは画面に表示されなくなります。
    // 通常、本番環境ではセキュリティ上の理由から display_errors は 'Off' に設定されます。
    ini_set('display_errors', 'Off');
    echo "ini_set('display_errors', 'Off'); を設定しました。" . PHP_EOL;
    echo "これにより、以下のエラーは画面には表示されません（PHPの内部ログには記録される可能性があります）。" . PHP_EOL . PHP_EOL;

    // 未定義変数へのアクセスを試み、E_NOTICE エラーを発生させます。
    // error_reporting(E_ALL) によってこのエラーは報告されますが、
    // display_errors が Off のため画面には表示されません。
    $undefinedVariable; // E_NOTICE: Undefined variable $undefinedVariable
    echo "未定義変数にアクセスしようとしました (E_NOTICE エラー)。" . PHP_EOL;

    // ゼロ除算を試み、E_WARNING エラーを発生させます。
    // 同様に画面には表示されません。
    1 / 0; // E_WARNING: Division by zero
    echo "ゼロ除算を試みました (E_WARNING エラー)。" . PHP_EOL;

    echo PHP_EOL . "--- 実行終了 ---" . PHP_EOL;
    echo "上記の処理でエラーは発生していますが、画面には何も表示されていないはずです。" . PHP_EOL;
    echo "これは 'display_errors' が 'Off' に設定されているためです。" . PHP_EOL;
    echo "エラーを画面に表示するには、'display_errors' を 'On' に設定する必要があります。" . PHP_EOL;
    echo "（例: ini_set('display_errors', 'On'); を上記で設定するか、php.ini を編集）" . PHP_EOL;
    echo "または、エラーログを確認してください ('error_log' の設定による)。" . PHP_EOL;
}

// 関数を実行します。
demonstrateErrorReportingIssue();

error_reporting関数は、PHPがどのような種類のエラーを内部的に報告するかを設定するために使用されます。引数$error_levelには、E_ALL（すべてのエラー）のような定数を整数値で指定し、省略した場合は現在の設定値が返されます。戻り値は、この関数が実行される前のエラー報告レベルを示す整数値です。

しかし、error_reportingでエラーを報告するよう設定しても、エラーが画面に表示されないことがあります。これは、PHPの設定項目であるdisplay_errorsがOffになっていることが原因です。display_errorsは、報告されたエラーをウェブページの画面に表示するかどうかを制御する別の設定項目です。

提供されたサンプルコードでは、まずerror_reporting(E_ALL)で全ての報告を有効にしています。その後にini_set('display_errors', 'Off')で画面への表示を無効にすることで、意図的にエラー（未定義変数へのアクセスやゼロ除算）を発生させても、画面には何も表示されない状況を再現しています。これは、本番環境でセキュリティ上の理由からエラー情報を直接ユーザーに見せないための一般的な設定です。エラーの状況を確認するには、display_errorsをOnにするか、PHPのエラーログ（error_log設定による）を参照する必要があります。

<?php

// PHPの error_reporting 関数は、どの種類のエラーをPHPが報告するかを設定します。
// このサンプルでは、エラーが画面に表示されるように一時的に設定しています。
ini_set('display_errors', '1'); // エラーを画面に表示する設定を有効化
error_reporting(E_ALL);         // すべてのPHPエラー、警告、通知を報告するように設定（開発環境向け）

echo "--- PHP error_reporting 関数の使用例 ---" . PHP_EOL;
echo PHP_EOL;

// 1. 現在のエラー報告レベルを取得する
// error_reporting() を引数なしで呼び出すと、現在の設定値が数値として返されます。
$initialErrorLevel = error_reporting();
echo "現在のPHPエラー報告レベル: " . $initialErrorLevel . PHP_EOL;
echo PHP_EOL;

// 2. エラー報告レベルを E_ALL (すべてのエラー、警告、通知) に設定する
// これは開発時に推奨される、最も詳細なエラー報告設定です。
echo "エラー報告レベルを E_ALL に設定します (すべてのエラーを報告)。" . PHP_EOL;
error_reporting(E_ALL);
echo "新しいエラー報告レベル: " . error_reporting() . PHP_EOL;
echo PHP_EOL;

// 意図的に E_NOTICE (通知) を発生させて、表示されることを確認します。
// 未定義の変数にアクセスすると E_NOTICE が発生します。
echo "--- E_NOTICE のテスト (E_ALL 設定時) ---" . PHP_EOL;
$undefinedVariable1;
echo $undefinedVariable1; // ここで E_NOTICE が発生し、表示されます。
echo PHP_EOL . PHP_EOL;

// 3. エラー報告レベルを E_ALL & ~E_NOTICE (通知を除くすべてのエラー) に設定する
// E_NOTICE は開発時に有用ですが、本番環境では非表示にすることがあります。
echo "エラー報告レベルを E_ALL & ~E_NOTICE に設定します (通知を除くすべてのエラーを報告)。" . PHP_EOL;
error_reporting(E_ALL & ~E_NOTICE);
echo "新しいエラー報告レベル: " . error_reporting() . PHP_EOL;
echo PHP_EOL;

// 同じ E_NOTICE を再度発生させて、今度は表示されないことを確認します。
echo "--- E_NOTICE のテスト (E_ALL & ~E_NOTICE 設定時) ---" . PHP_EOL;
$undefinedVariable2;
echo $undefinedVariable2; // ここで E_NOTICE が発生しますが、設定により表示されません。
echo PHP_EOL . PHP_EOL;

// 4. 元のエラー報告レベルに戻す
// スクリプトの実行が終了すると設定は自動的に元に戻りますが、
// 明示的に戻すことで、後続のコードへの影響を防ぐことができます。
error_reporting($initialErrorLevel);
echo "エラー報告レベルを元の設定 (" . $initialErrorLevel . ") に戻しました: " . error_reporting() . PHP_EOL;
echo PHP_EOL;

// 補足: 本番環境では通常、display_errors は 'Off' に設定し、
// エラーはセキュリティのために画面に表示せず、ログファイルに記録するようにします。

?>

PHPのerror_reporting関数は、PHPがどのような種類のエラー、警告、通知を報告するかを制御する重要な関数です。システム開発において、エラーの把握はデバッグ作業に不可欠です。

この関数は、引数に整数値でエラーレベルを指定することで、報告するエラーの種類を設定します。例えば、E_ALLを指定するとすべてのエラーが報告され、E_NOTICEを除外したい場合はE_ALL & ~E_NOTICEのように定数を組み合わせて設定します。引数を省略して呼び出すと、現在のエラー報告レベルが整数値として返されます。関数が値を設定するために呼び出された場合でも、その変更前のエラー報告レベルが戻り値として返されるため、一時的に設定を変更し、後で元の状態に戻すといった使い方が可能です。

サンプルコードでは、まずini_set('display_errors', '1')で画面へのエラー表示を有効にした上で、error_reportingの挙動を確認しています。最初に引数なしで現在の設定を取得し、次にE_ALLを設定して未定義変数へのアクセスによるE_NOTICE（通知）が表示されることを確認します。その後、E_NOTICEを除外する設定に変更し、同じE_NOTICEが表示されなくなることを示しています。最後に、取得しておいた元のエラーレベルに戻すことで、スクリプトの他の部分への影響を防いでいます。開発環境では詳細なエラー報告を有効にして迅速に問題を特定し、本番環境ではセキュリティとパフォーマンスのために画面へのエラー表示を無効化し、エラーはログファイルに記録することが一般的です。