PHP Conference Kansai 2026 (JAPAN)

エラー処理の設定

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() で作成したコンテキストに設定し、 そのコンテキストを関数に渡すか、ストリームを開く際に指定する必要があります。

各エラーモードとエラーハンドラの例は、 ストリームコンテキストオプション を参照ください。

+add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top