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

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

作成日: 2025年09月11日更新日: 2025年10月14日

基本的な使い方

『getCodeメソッドは、DivisionByZeroErrorオブジェクトに設定された例外コードを取得するために実行するメソッドです。このメソッドは、PHPの基本的なエラー処理機構を提供するErrorクラスから継承されています。DivisionByZeroErrorは、計算処理においてゼロによる除算が行われた際にスローされるエラーです。プログラム中でtry...catchブロックを使用してDivisionByZeroErrorを捕捉した場合、そのエラーオブジェクトのインスタンスからgetCodeメソッドを呼び出すことができます。これにより、エラー発生時に設定された整数値のコードが返されます。例外コードは、エラーの種類をプログラムで識別し、その値に応じて処理を分岐させるような場合に役立ちます。DivisionByZeroErrorがPHPの実行エンジンによって自動的にスローされた場合、通常は特定のコードが設定されていないため、このメソッドの戻り値はデフォルト値である0となります。』

構文(syntax)


1<?php
2
3try {
4    $result = 1 % 0;
5} catch (DivisionByZeroError $e) {
6    // DivisionByZeroErrorオブジェクトからエラーコードを取得します。
7    $errorCode = $e->getCode();
8    echo $errorCode;
9}
10
11?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

int

DivisionByZeroErrorクラスのgetCodeメソッドは、ゼロ除算エラーが発生した際の内部的なエラーコードを整数型（int）で返します。

サンプルコード

PHP DivisionByZeroErrorのエラーコードを取得する


1<?php
2
3try {
4    // 0で除算を試みる
5    $result = 10 / 0;
6} catch (DivisionByZeroError $e) {
7    // DivisionByZeroErrorが発生した場合、エラーコードを取得する
8    $errorCode = $e->getCode();
9
10    // エラーコードを表示する
11    echo "エラーコード: " . $errorCode . PHP_EOL;
12}

このサンプルコードは、PHP 8におけるDivisionByZeroErrorクラスのgetCodeメソッドの使い方を示しています。DivisionByZeroErrorは、0で除算しようとした際に発生する例外です。

サンプルコードでは、まずtry-catchブロックを使用して、0で除算する可能性のある処理を囲んでいます。$result = 10 / 0;の部分が0で除算を試みる箇所です。

もし0で除算が発生し、DivisionByZeroError例外が投げられると、catchブロックが実行されます。catch (DivisionByZeroError $e)は、DivisionByZeroError型の例外オブジェクトを $e という変数で受け取ります。

$e->getCode() は、DivisionByZeroError例外オブジェクト $e の getCode メソッドを呼び出しています。getCodeメソッドは引数を取りません。このメソッドは、例外に関連付けられたエラーコードを整数値(int)として返します。多くの場合、エラーの種類を識別するために使用されます。

サンプルコードでは、取得したエラーコードを $errorCode 変数に格納し、echo文を使って画面に表示しています。PHP_EOLは改行コードを表し、出力を見やすくするために追加しています。

この例では、getCodeメソッドが例外の発生原因に関する情報を数値として提供し、エラー処理に役立つことを示しています。システムエンジニアを目指す方は、例外処理とエラーコードの活用を学ぶ上で、この例が参考になるでしょう。

DivisionByZeroError クラスの getCode メソッドは、例外が発生した際のエラーコード（整数値）を取得します。PHP 8 以降では、0 で除算しようとすると DivisionByZeroError が発生するようになりました。try-catch ブロックで例外を捕捉し、getCode メソッドを使ってエラーコードを取得できます。getCode は引数を必要としません。通常、このエラーコードは 0 を返します。しかし、将来の PHP バージョンで異なるエラーコードが設定される可能性もあるため、getCode の戻り値を常に 0 と決めつけないように注意が必要です。例外処理を適切に行い、エラーコードに基づいて適切な処理を行うように心がけてください。

PHP DivisionByZeroError getCode()でエラーコードを取得する


1<?php
2
3/**
4 * DivisionByZeroError の getCode メソッドのサンプルコード
5 */
6try {
7    $result = 10 / 0;
8} catch (DivisionByZeroError $e) {
9    // DivisionByZeroError のエラーコードを取得
10    $errorCode = $e->getCode();
11
12    // エラーコードを表示
13    echo "エラーコード: " . $errorCode . PHP_EOL;
14}
15
16?>

PHP 8における DivisionByZeroError クラスの getCode メソッドは、発生した算術エラーのエラーコードを整数値で取得するために使用されます。このメソッドは引数を必要とせず、int型の値を返します。

サンプルコードでは、try-catchブロックを使用し、0で除算しようとした際に発生する DivisionByZeroError を捕捉しています。tryブロック内で 10 / 0 を実行することで、意図的にゼロ除算エラーを発生させています。catchブロックでは、DivisionByZeroError オブジェクト $e を受け取り、$e->getCode() を呼び出すことで、エラーコードを取得しています。

取得されたエラーコードは、$errorCode 変数に格納され、echo ステートメントを使って画面に出力されます。PHP_EOL は改行文字を表し、出力結果を見やすくするために使用されています。

getCode メソッドを利用することで、発生したゼロ除算エラーの種類を特定し、エラーの種類に応じた適切な処理を行うことができます。この例では、エラーコードを単純に表示していますが、実際には、エラーコードに基づいてログ出力やエラーハンドリングルーチンを呼び出すなど、より複雑な処理を行うことが一般的です。DivisionByZeroError は、例外処理のメカニズムを通じて、プログラムの安定性を向上させるために役立ちます。

DivisionByZeroErrorのgetCodeメソッドは、例外発生時のエラーコード（整数値）を取得します。PHP 8以降、0で除算した場合にこの例外が発生するようになりました。サンプルコードでは、try-catchブロックで例外を捕捉し、getCodeメソッドでエラーコードを取得しています。

注意点として、getCodeメソッドは例外の種類によって異なるエラーコードを返す可能性があります。DivisionByZeroErrorの場合、通常は0が返されますが、例外の種類によっては異なる値を返すため、ドキュメントを確認するようにしてください。

また、エラーコードは例外の種類を特定する手がかりになりますが、エラーの詳細な原因を特定するには、getMessageメソッドなど他のメソッドと組み合わせて使用する必要があります。エラー処理においては、getCodeだけでなく、例外オブジェクト全体を適切に調査し、適切な対応を行うことが重要です。