【PHP8.x】T_PROTECTED_SET定数の使い方

Copy
1<?php
2
3/**
4 * protected アクセス修飾子の使用例を示します。
5 *
6 * protected は、クラスのメンバー（プロパティやメソッド）が、
7 * そのクラス自身と、そのクラスを継承した子クラスからのみアクセス可能であることを示します。
8 * クラスの外部からは直接アクセスできません。
9 */
10
11// 親クラスを定義
12class ParentClass
13{
14    // protected プロパティ: このクラスと子クラスからのみアクセス可能
15    protected string $protectedProperty = "親クラスのprotectedプロパティです。";
16
17    // protected メソッド: このクラスと子クラスからのみアクセス可能
18    protected function protectedMethod(): string
19    {
20        return "親クラスのprotectedメソッドが呼び出されました。";
21    }
22
23    // public メソッド: protected メンバーに内部からアクセスする例
24    public function accessProtectedInternally(): void
25    {
26        echo "親クラス内から protectedProperty: " . $this->protectedProperty . "\n";
27        echo "親クラス内から protectedMethod: " . $this->protectedMethod() . "\n";
28    }
29}
30
31// 子クラスを定義し、ParentClassを継承
32class ChildClass extends ParentClass
33{
34    // public メソッド: protected メンバーに子クラスからアクセスする例
35    public function accessProtectedFromChild(): void
36    {
37        echo "子クラス内から protectedProperty: " . $this->protectedProperty . "\n";
38        echo "子クラス内から protectedMethod: " . $this->protectedMethod() . "\n";
39    }
40
41    // protected メソッドをオーバーライドする例 (アクセスレベルは維持または緩和可能)
42    protected function protectedMethod(): string
43    {
44        return "子クラスでオーバーライドされたprotectedメソッドが呼び出されました。";
45    }
46}
47
48// --- クラスの利用例 ---
49
50echo "--- ParentClass の操作 --- \n";
51$parent = new ParentClass();
52$parent->accessProtectedInternally(); // public メソッドを通じて protected メンバーにアクセス
53
54// 以下はエラーになります（コメントアウトを外すと実行時エラーが発生）
55// echo $parent->protectedProperty; // エラー: Cannot access protected property ParentClass::$protectedProperty
56// $parent->protectedMethod();      // エラー: Call to protected method ParentClass::protectedMethod() from global scope
57
58echo "\n--- ChildClass の操作 --- \n";
59$child = new ChildClass();
60$child->accessProtectedFromChild(); // public メソッドを通じて protected メンバーにアクセス
61
62// 以下はエラーになります（コメントアウトを外すと実行時エラーが発生）
63// echo $child->protectedProperty; // エラー: Cannot access protected property ParentClass::$protectedProperty
64// $child->protectedMethod();      // エラー: Call to protected method ChildClass::protectedMethod() from global scope
65
66?>

PHPのprotectedは、クラスのメンバー（プロパティやメソッド）にアクセス範囲を制限するためのキーワードです。これはアクセス修飾子の一つで、そのメンバーが定義されたクラス自身と、そのクラスを継承した子クラスからのみアクセス可能であることを示します。クラスの外部や、関連のない他のクラスからは直接アクセスできません。

このサンプルコードでは、ParentClassにprotectedなプロパティとメソッドが定義されています。ParentClass内のpublicメソッドからは、これらのprotectedメンバーに問題なくアクセスできます。また、ParentClassを継承したChildClassからも、親クラスのprotectedなプロパティやメソッドにアクセスできることが示されています。子クラスでは親クラスのprotectedメソッドをオーバーライドすることも可能です。

一方で、クラスのインスタンスを生成し、その外部からprotectedなプロパティやメソッドに直接アクセスしようとすると、PHPは実行時エラーを発生させます。これは、protected修飾子が意図した通りに外部からのアクセスを制限していることを示しており、クラス内部の特定の情報を隠蔽し、コードの安全性と保守性を高める役割があります。

protectedというキーワード自体は、プロパティやメソッドに適用される修飾子であり、それ自体が引数や戻り値を持つことはありません。

Copy
1<?php
2
3/**
4 * T_PROTECTED_SET トークンに関連する PHP 8 の readonly プロパティの動作を示すクラス。
5 *
6 * T_PROTECTED_SET は、PHP 8.1 で導入された readonly プロパティへの
7 * 不正な再代入を検出する際に、PHP 内部で用いられるトークンです。
8 * 通常のアプリケーションコードでこの定数を直接使うことはありませんが、
9 * PHP のエラーハンドリングや内部動作の理解に役立ちます。
10 *
11 * キーワード T_STRING は、PHP コードを構成する識別子（変数名、関数名、クラス名など）
12 * やキーワードの大部分を指します。例えば、'Product', 'name', 'tryChangeName' などは
13 * T_STRING に分類されます。
14 */
15class Product
16{
17    // PHP 8.1 で導入された readonly プロパティ。
18    // このプロパティは一度初期化されると、その後の変更はできません。
19    public readonly string $name;
20
21    /**
22     * Product クラスのコンストラクタ。
23     * readonly プロパティはここで一度だけ初期化されます。
24     */
25    public function __construct(string $name)
26    {
27        // readonly プロパティの初期化はコンストラクタ内で許可されています。
28        $this->name = $name;
29        echo "製品が初期化されました: " . $this->name . "\n";
30    }
31
32    /**
33     * readonly プロパティの値を変更しようと試みるメソッド。
34     *
35     * この操作は許可されていないため、実行時に PHP の Error をスローします。
36     * PHP 内部では、このような不正な代入を検出するために T_PROTECTED_SET のような
37     * トークンが関連付けられています。
38     */
39    public function tryChangeName(string $newName): void
40    {
41        echo "名前を '{$this->name}' から '{$newName}' に変更しようと試みます...\n";
42        // PHP 8.1 以降では、この行で Error がスローされます。
43        // readonly プロパティは初期化後に再代入できません。
44        $this->name = $newName;
45        echo "名前が変更されました: " . $this->name . "\n"; // この行は実行されません
46    }
47}
48
49// 製品のインスタンスを作成し、readonly プロパティを初期化します。
50$myProduct = new Product("Modern Gadget");
51
52// 現在の製品名を表示します。
53echo "現在の製品名: " . $myProduct->name . "\n";
54
55// readonly プロパティを変更しようと試みます。
56// この操作は PHP の Error を引き起こすため、try-catch ブロックで捕捉します。
57try {
58    $myProduct->tryChangeName("Advanced Device");
59} catch (Error $e) {
60    echo "--- エラーをキャッチしました ---\n";
61    echo "エラーメッセージ: " . $e->getMessage() . "\n";
62    echo "readonly プロパティは一度設定されると変更できないため、このエラーが発生しました。\n";
63    echo "PHP の内部では、このような不正な操作を検出するために T_PROTECTED_SET のようなトークンが使われます。\n";
64}
65
66// エラー後もプロパティの値は変更されていないことを確認します。
67echo "エラー後の製品名 (変更なし): " . $myProduct->name . "\n";

このPHPコードは、PHP 8.1で導入された「readonlyプロパティ」の挙動とその内部的な関連性を示すものです。Productクラスの$nameプロパティはreadonlyとして宣言されており、これは一度値が設定されると、その後は変更できないことを意味します。コンストラクタではこのプロパティが初期化され、その後のtryChangeNameメソッド内で変更を試みると、PHPは「Error」を発生させます。これはreadonlyプロパティの性質によるものです。

このような不正なプロパティへの再代入をPHPが検出する際、内部的に「T_PROTECTED_SET」というトークンが用いられています。このトークンは拡張機能の一部として定義される定数であり、引数や戻り値を持たず、開発者が直接利用するものではなく、PHPの内部動作を司るものです。また、コード中のクラス名「Product」やプロパティ名「name」、メソッド名「tryChangeName」などの識別子は、PHPコードの基本的な要素である「T_STRING」キーワードに分類されます。このサンプルは、readonlyプロパティの利用方法と、その背後にあるPHPの内部メカニズムを理解するのに役立ちます。