【PHP8.x】getCodeメソッドの使い方

getCodeメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

『getCodeメソッドは、スローされたInvalidArgumentExceptionインスタンスに設定されている例外コードを取得するメソッドです。このメソッドは、PHPの基本的な例外クラスであるExceptionから継承されており、InvalidArgumentExceptionでも同様に使用することができます。例外コードは、人間が読むための例外メッセージとは別に、エラーの種類をプログラム上で識別するために用いられる整数値です。開発者は、InvalidArgumentExceptionnewキーワードで生成する際に、コンストラクタの第二引数として任意の整数コードを渡すことが可能です。そして、try-catchブロックでこの例外を捕捉した際に、getCodeメソッドを呼び出すことで設定したコードを取得できます。取得したコードを利用して、switch文などでエラーの種類に応じた分岐処理を実装するなど、より柔軟で詳細なエラーハンドリングを実現するために役立ちます。もし例外の生成時にコードが指定されなかった場合、このメソッドはデフォルトで0を返します。』

構文(syntax)

1<?php
2try {
3    // 例外をスローする際に、第2引数で例外コードを指定します。
4    throw new InvalidArgumentException("引数が無効です。", 1001);
5} catch (InvalidArgumentException $e) {
6    // getCode() メソッドで例外コードを取得します。
7    $code = $e->getCode();
8    echo $code; // 1001 が出力されます。
9}
10?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

int|string

このメソッドは、例外が生成された際に設定されたエラーコードを返します。エラーコードは整数または文字列として保持されている場合があります。

関連コンテンツ