【PHP8.x】codeプロパティの使い方

作成日: 更新日:

codeプロパティは、Errorクラスが表すエラーの種類を識別するための数値を保持するプロパティです。

このプロパティは、PHPスクリプトの実行中に何らかの深刻な問題が発生し、それがErrorオブジェクトとして捕捉された際に、そのエラーが具体的にどのような性質を持つのかを示すために用いられます。例えば、未定義の関数を呼び出した、型が異なる値を期待される場所に渡した、といった多岐にわたる内部的なエラーの種類を、それぞれ固有の数値コードで表現します。この数値コードは、PHPの内部で定義された特定のエラー状態に対応しています。

開発者は、try...catchブロックなどを用いた例外処理の中で、捕捉したErrorオブジェクトのcodeプロパティを参照することで、どのような種類のエラーが発生したのかをプログラム的に判断できます。これにより、エラーの種類に応じた適切な処理(例えば、ユーザーに分かりやすいメッセージを表示する、特定のログを記録する、またはプログラムの実行を安全に終了させるなど)を実行することが可能になります。

エラーコードを利用することは、エラーが発生した状況をより詳細に把握し、問題の原因を特定するデバッグ作業を効率化したり、システム全体の堅牢性を高めたりする上で非常に重要です。システムエンジニアを目指す上で、発生したエラーの種類を正確に理解し、それに応じた適切な処理を行う能力は、信頼性の高いソフトウェアを開発するために不可欠な知識となります。

基本的な使い方

構文(syntax)

1<?php
2$error = new Error("エラーメッセージ", 1001);
3echo $error->code;

引数(parameters)

戻り値(return)

int

Error クラスの code プロパティは、発生したエラーのコード番号を integer 型で返します。

【PHP8.x】codeプロパティの使い方 | いっしー@Webエンジニア