PHP 8.6.0 以降、ストリームコンテキスト
を使うすべての操作で、
ストリームコンテキストオプション
の error_mode、error_store、
error_handler を設定して、
ストリームのエラーを報告する方法を変更できます。
各エラーは StreamError オブジェクトで表され、その
code プロパティは
StreamErrorCode の case です。
エラーには、ファイルを開けない場合のように操作を打ち切るエラーと、
操作を打ち切らないエラーがあります。
操作を打ち切らないエラーは、報告はされますが、
StreamErrorMode::Exception モードでも例外はスローされません。
1 回の操作で複数のエラーが報告されることもあります。
error_mode オプションには
StreamErrorMode の case を指定し、
エラーの報告方法を選択します:
デフォルトの StreamErrorMode::Error は、
E_WARNING や E_NOTICE
などの診断エラーを発生させます。
StreamErrorMode::Exception は、
操作を打ち切るエラーが報告された場合、
StreamException をスローします。
操作を打ち切らないエラーでは、例外をスローせず、診断エラーも発生させません。
StreamErrorMode::Silent は、
診断エラーを発生させず、例外もスローしません。
error_store オプションには
StreamErrorStore の case を指定し、
どのエラーを保持するかを選択します。
保持されたエラーは stream_last_errors() で取得できます。
デフォルトの StreamErrorStore::Auto では、
保持するエラーがエラーモードによって決まります:
| エラーモード | StreamErrorStore::Auto で保持されるエラー |
|---|---|
StreamErrorMode::Error |
なし |
StreamErrorMode::Exception |
操作を打ち切らないエラー |
StreamErrorMode::Silent |
すべてのエラー |
error_handler オプションには
callable を指定します。
このコールバックは、エラーが報告された操作ごとに呼び出され、
その操作で報告されたエラーを表す
StreamError オブジェクトの配列を受け取ります。
ただし、StreamException
がスローされた場合は呼び出されません。
注意:
stream_context_set_default() は、これらのオプションを受け付けません。 これらのオプションは、stream_context_create() で作成したコンテキストに設定し、 そのコンテキストを関数に渡すか、ストリームを開く際に指定する必要があります。
各エラーモードとエラーハンドラの例は、 ストリームコンテキストオプション を参照ください。