【PHP8.x】ReflectionClass::IS_FINAL定数の使い方

Copy
1<?php
2
3// final キーワードで宣言されたクラスは継承できません。
4// これがキーワード「php is declared final and cannot be doubled」の「doubled」（拡張・上書き）できない制約です。
5final class MyFinalClass
6{
7    public function getStatus(): string
8    {
9        return "私は final クラスです。";
10    }
11}
12
13// 通常のクラスは継承可能です。
14class MyNormalClass
15{
16    public function getStatus(): string
17    {
18        return "私は通常のクラスです。";
19    }
20}
21
22/**
23 * 指定されたクラスが final であるかを確認し、その状態を出力します。
24 * ReflectionClass::IS_FINAL 定数を使用して、クラスの修飾子をビット演算でチェックします。
25 *
26 * @param string $className 確認したいクラスの完全修飾名（例: MyFinalClass::class）
27 * @return void
28 */
29function displayClassFinalStatus(string $className): void
30{
31    try {
32        // クラスの情報を取得するための ReflectionClass オブジェクトを作成します。
33        $reflectionClass = new ReflectionClass($className);
34
35        // クラスの修飾子（final, abstract など）を整数値として取得します。
36        $modifiers = $reflectionClass->getModifiers();
37
38        // 取得した修飾子と ReflectionClass::IS_FINAL 定数をビットAND演算子 (&) で比較し、
39        // final クラスであるかを確認します。
40        // ビット演算の詳細を初心者が理解するのは難しい場合があるため、
41        // 判定の式をそのまま使用することで、必要な動作を把握してもらいます。
42        if (($modifiers & ReflectionClass::IS_FINAL) === ReflectionClass::IS_FINAL) {
43            echo "クラス '{$className}' は final として宣言されています。\n";
44            echo "  -> final クラスは継承できません。\n";
45        } else {
46            echo "クラス '{$className}' は final ではありません。\n";
47            echo "  -> このクラスは継承可能です。\n";
48        }
49        echo "-----------------------------------------\n";
50
51    } catch (ReflectionException $e) {
52        // 指定されたクラスが存在しない場合の例外処理
53        echo "エラー: クラス '{$className}' は見つかりませんでした。\n";
54        echo "-----------------------------------------\n";
55    }
56}
57
58// 各クラスの final 宣言の状態を確認し、結果を表示します。
59displayClassFinalStatus(MyFinalClass::class);
60displayClassFinalStatus(MyNormalClass::class);
61displayClassFinalStatus('NonExistentClass'); // 存在しないクラスの例

このPHPコードは、あるクラスが「final」として宣言されているかプログラム的に確認する方法を示しています。finalキーワードで定義されたクラスは、他のクラスによる継承（拡張）を禁止し、その構造の「二重化」を防ぐことで、設計の安定性を保証します。

ReflectionClassは、プログラム実行中にPHPのクラス情報を動的に取得する機能です。そのgetModifiers()メソッドは、クラスがfinalやabstractなどの修飾子を持つかを整数値で返します。ReflectionClass::IS_FINAL定数は、引数も戻り値も持たない単なる数値で、getModifiers()が返す整数値の中からfinal修飾子が付いているかどうかを判定する際に使用します。

サンプルコードでは、この定数とgetModifiers()の結果を組み合わせることで、クラスがfinalであるかを正確に判別し、継承可否のメッセージを表示しています。