Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

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

T_PROTECTED定数の使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

T_PROTECTED定数は、PHPのソースコードにおいて、キーワードprotectedを表す定数です。この定数は、PHP言語の内部処理、特にPHPスクリプトを構成する個々の要素(トークン)に分解する「トークン化」の際に用いられます。

具体的には、token_get_all()関数などでPHPのソースコードを解析した場合、コード内に記述されたprotectedというキーワードは、T_PROTECTEDという数値で識別されます。このprotectedキーワードは、クラスのプロパティやメソッドのアクセス権(可視性)を定義するために使用されます。protectedと宣言されたメンバーは、定義されたクラス自身とそのクラスを継承した子クラスからアクセス可能であることを意味します。

T_PROTECTED定数は、PHPのパーサーや、PHPコードを静的に解析するツールなどが、ソースコード内でprotectedキーワードを正確に認識し、その意味を解釈するための目印として機能します。通常のアプリケーション開発において、開発者が直接この定数を扱う機会は稀ですが、PHPの内部的な動作を理解するためや、PHPコードの構文解析に基づいたツール(例えば、IDEのシンタックスハイライト機能やコード整形ツールなど)を開発する際には、重要な役割を果たす定数の一つです。PHPがどのようにソースコードを読み解いているかを知る上で役立ちます。

構文(syntax)

1<?php
2echo T_PROTECTED;

引数(parameters)

引数なし

引数はありません

戻り値(return)

int

T_PROTECTED定数は、PHPの字句解析器(Lexer)によって生成されるトークンタイプを表す整数値です。この値は、コード内のprotectedキーワードを識別するために使用されます。

サンプルコード

PHPのprotectedとT_PROTECTEDを解説する

1<?php
2
3/**
4 * このスクリプトは、PHPの'protected'アクセス修飾子の概念と、
5 * それに対応するトークナイザー定数 T_PROTECTED の役割をデモンストレーションします。
6 *
7 * 'protected'キーワードは、クラスのプロパティやメソッドが
8 * そのクラス自身と、その子クラスからのみアクセス可能であることを定義します。
9 * 外部のコードからは直接アクセスできません。
10 *
11 * T_PROTECTED 定数は、PHPの内部でソースコードを解析(トークン化)する際、
12 * この'protected'キーワードを識別するためのユニークな整数値です。
13 * システムエンジニアを目指す初心者の方へ:
14 * PHPコードを解析するツール(例:シンタックスハイライター、静的解析ツールなど)を開発する際に、
15 * T_PROTECTEDのようなトークン定数を使用して、コード内の特定のキーワードや構造を検出します。
16 */
17
18// 'protected'キーワードを含むPHPクラスのサンプルコードを文字列として定義します。
19// この文字列をPHPのトークナイザーが解析します。
20$phpCodeString = <<<'PHP_CODE'
21<?php
22class UserAccount {
23    // protectedなプロパティは、このクラスとその子クラスからのみアクセス可能です。
24    protected string $passwordHash;
25
26    // protectedなメソッドも、このクラスとその子クラスからのみ呼び出し可能です。
27    protected function generateHash(string $password): string {
28        return password_hash($password, PASSWORD_BCRYPT);
29    }
30
31    public function __construct(string $password) {
32        $this->passwordHash = $this->generateHash($password);
33    }
34
35    public function verifyPassword(string $password): bool {
36        return password_verify($password, $this->passwordHash);
37    }
38}
39
40class AdminAccount extends UserAccount {
41    public function __construct(string $password) {
42        parent::__construct($password);
43    }
44
45    // protectedなメソッドは子クラスから呼び出し可能です。
46    public function changePassword(string $newPassword): void {
47        $this->passwordHash = $this->generateHash($newPassword);
48        echo "管理者パスワードが更新されました。\n";
49    }
50}
51
52// 外部から直接 protected メンバーにアクセスしようとすると、PHPはエラーを発生させます。
53// 例えば、以下の行はコメントアウトを外すと実行時エラーになります。
54// $user = new UserAccount("mysecretpassword");
55// echo $user->passwordHash; // Fatal error: Cannot access protected property UserAccount::$passwordHash
56// echo $user->generateHash("anotherpassword"); // Fatal error: Call to protected method UserAccount::generateHash()
57PHP_CODE;
58
59// token_get_all() 関数を使用して、PHPコード文字列を個々のトークン(要素)に分割します。
60// 各トークンは、キーワード、変数名、演算子、文字列などを表します。
61$tokens = token_get_all($phpCodeString);
62
63echo "PHPの 'protected' キーワードと T_PROTECTED 定数のデモンストレーション:\n\n";
64
65// T_PROTECTED 定数の整数値を出力します。
66// この値はPHPのバージョンによって異なりますが、常に一意の整数値です。
67echo "T_PROTECTED 定数の値: " . T_PROTECTED . " (例: 328)\n\n";
68
69echo "サンプルコード内で 'protected' キーワードが検出された場所:\n";
70// 分割されたトークンをループし、T_PROTECTED トークンを探します。
71foreach ($tokens as $token) {
72    // is_array($token) は、トークンが [ID, 文字列値, 行番号] の形式であるかを確認します。
73    // そのIDが T_PROTECTED と一致する場合、それは'protected'キーワードです。
74    if (is_array($token) && $token[0] === T_PROTECTED) {
75        // token_name() 関数は、トークンID(整数)を人間が読める文字列(例: "T_PROTECTED")に変換します。
76        echo "- トークンID: " . token_name($token[0]) . "\n";
77        echo "  キーワード文字列: '" . $token[1] . "'\n";
78        echo "  検出行番号: " . $token[2] . "\n\n";
79    }
80}
81
82// 実際のクラス動作の簡易的なデモンストレーション
83// (eval()はセキュリティリスクがあるため、本番環境での使用は避けるべきです。)
84eval(substr($phpCodeString, 5)); // "<?php" タグを除いてコードを実行
85
86$admin = new AdminAccount("initial_admin_pass");
87echo "AdminAccountの初期パスワードを検証: " . ($admin->verifyPassword("initial_admin_pass") ? "成功" : "失敗") . "\n";
88$admin->changePassword("new_admin_pass");
89echo "AdminAccountの新しいパスワードを検証: " . ($admin->verifyPassword("new_admin_pass") ? "成功" : "失敗") . "\n";
90
91?>

PHPのT_PROTECTEDは、PHPソースコードを解析する「トークナイザー」という仕組みで使われる特別な定数です。これは、プログラミング言語PHPの内部で、コード中の特定のキーワードを識別するために用意されています。T_PROTECTEDは引数を取らず、PHPのprotectedキーワードを表すユニークな整数値を返します。

protectedキーワードは、PHPのクラスにおいて、そのプロパティ(変数)やメソッド(関数)へのアクセス権限を制御するためのアクセス修飾子の一つです。具体的には、protectedが指定されたメンバーは、そのクラス自身と、そのクラスを継承した子クラスからのみアクセスできます。外部のコードから直接アクセスしようとするとエラーが発生し、プログラムが意図しない動作をするのを防ぎます。

T_PROTECTED定数は、このようなprotectedキーワードがソースコード内のどこにあるかをPHPが識別するために利用されます。例えば、PHPコードを分析して構文をハイライト表示するエディタや、コードの誤りを発見する静的解析ツールなどを開発する際に、token_get_all()関数と組み合わせてT_PROTECTEDのようなトークン定数を使用し、protectedキーワードを検出して処理を行います。これにより、PHPコードの構造を正確に理解し、様々なツールでの活用が可能になります。

このサンプルコードは、protected修飾子がクラス自身とその子クラスからのアクセスに限定されることを示しています。外部から直接アクセスしようとするとFatal Errorが発生するため、クラス設計において、意図しない外部からの変更を防ぐ重要な役割を果たします。T_PROTECTED定数は、PHPのソースコードを解析する際にprotectedキーワードを識別するための内部的な整数値であり、通常、PHPプログラムの記述中に直接使用する場面は稀です。また、サンプルコード中のeval()関数は、文字列としてPHPコードを実行する機能ですが、セキュリティ上の重大なリスク(コードインジェクションなど)を伴います。そのため、本番環境での使用は極力避け、信頼できない文字列を実行しないよう特に注意し、代替手段の検討をお勧めします。

PHP protectedの親から子へのアクセス

1<?php
2
3/**
4 * 親クラス: protectedプロパティとメソッドの使用例を示します。
5 */
6class ParentClass
7{
8    /**
9     * @var string protectedプロパティ。このクラスと、このクラスを継承した子クラスからアクセス可能です。
10     */
11    protected string $name;
12
13    /**
14     * コンストラクタ。
15     *
16     * @param string $name 名前を設定します。
17     */
18    public function __construct(string $name)
19    {
20        // `$this` を使用して、自身のprotectedプロパティにアクセスします。
21        $this->name = $name;
22    }
23
24    /**
25     * protectedメソッド。このクラスと子クラスからのみ呼び出し可能です。
26     *
27     * @return string 名前を返します。
28     */
29    protected function getProtectedName(): string
30    {
31        // `$this` を使用して、自身のprotectedプロパティにアクセスします。
32        return $this->name;
33    }
34
35    /**
36     * publicメソッド。外部から呼び出し可能です。
37     * protectedメソッドを呼び出すことで、名前を安全に公開します。
38     */
39    public function showName(): void
40    {
41        echo "Parent Name (via public method): " . $this->getProtectedName() . "\n";
42    }
43}
44
45/**
46 * 子クラス: 親クラスのprotectedメンバへのアクセス方法を示します。
47 */
48class ChildClass extends ParentClass
49{
50    /**
51     * @var string プライベートプロパティ。このクラスからのみアクセス可能です。
52     */
53    private string $nickname;
54
55    /**
56     * コンストラクタ。
57     *
58     * @param string $name 親クラスの名前。
59     * @param string $nickname 子クラスのニックネーム。
60     */
61    public function __construct(string $name, string $nickname)
62    {
63        // 親クラスのコンストラクタを呼び出し、protectedプロパティ `$name` を初期化します。
64        parent::__construct($name);
65        $this->nickname = $nickname;
66    }
67
68    /**
69     * 子クラス独自のメソッド。
70     * 親クラスのprotectedプロパティやメソッドにアクセスできることを示します。
71     */
72    public function showChildInfo(): void
73    {
74        // `$this` を使用して、親クラスのprotectedプロパティ `$this->name` にアクセスしています。
75        echo "Child Nickname: " . $this->nickname . ", Inherited Name: " . $this->name . "\n";
76
77        // `$this` を使用して、親クラスのprotectedメソッド `$this->getProtectedName()` にアクセスしています。
78        echo "Child Info (via inherited protected method): " . $this->getProtectedName() . "\n";
79    }
80}
81
82// --- コードの実行部分 ---
83
84// 親クラスのインスタンスを生成
85$parent = new ParentClass("Alice");
86$parent->showName(); // OK: publicメソッド経由でprotectedメンバにアクセス
87
88// 以下はエラーになります(コメントアウト解除すると実行時エラーが発生)
89// echo $parent->name;          // Fatal error: Cannot access protected property ParentClass::$name
90// $parent->getProtectedName(); // Fatal error: Call to protected method ParentClass::getProtectedName()
91
92echo "---------------------\n";
93
94// 子クラスのインスタンスを生成
95$child = new ChildClass("Bob", "Bobby");
96$child->showName();      // OK: 親クラスのpublicメソッドを呼び出し
97$child->showChildInfo(); // OK: 子クラス内で親のprotectedメンバにアクセス
98
99// 以下はエラーになります(コメントアウト解除すると実行時エラーが発生)
100// echo $child->name;           // Fatal error: Cannot access protected property ParentClass::$name
101// $child->getProtectedName();  // Fatal error: Call to protected method ParentClass::getProtectedName()

PHPのT_PROTECTED定数は、PHP言語の内部でprotectedキーワードを識別するために使われる整数値です。この定数自体を直接コードで使用することは稀ですが、その基となるprotectedキーワードは、オブジェクト指向プログラミングにおける重要なアクセス修飾子です。

protectedキーワードは、クラスのプロパティ(変数)やメソッド(関数)に付与されます。これにより、そのプロパティやメソッドは「そのクラス自身」と「そのクラスを継承した子クラス」からのみアクセス可能となり、クラスの外部からは直接アクセスできません。これは、クラスの内部実装を保護し、誤った操作を防ぐためのカプセル化の原則に基づいています。

サンプルコードでは、ParentClassがprotectedなプロパティ$nameとメソッドgetProtectedName()を持っています。クラスの内部では、$thisキーワードが現在のオブジェクト自身を指し、$this->nameのようにプロパティに、また$this->getProtectedName()のようにメソッドにアクセスしています。ParentClassのpublicメソッドであるshowName()は、このprotectedメソッドを呼び出すことで、安全に名前を外部に公開する役割を果たします。

ChildClassはParentClassを継承しており、その内部ではshowChildInfo()メソッドのように、親クラスのprotectedプロパティ$this->nameやprotectedメソッド$this->getProtectedName()に直接アクセスできます。これはprotectedメンバが継承クラスからもアクセス可能であることを示しています。

しかし、クラスのインスタンスを外部から操作する際、例えば$parentや$childの外部からprotectedなメンバに直接アクセスしようとすると、PHPはエラーを発生させます。外部からのアクセスは、$parent->showName()のようなpublicなメソッドを介して行う必要があります。

このようにprotectedキーワードと$thisを用いることで、クラスの内部を保護しつつ、継承関係にあるクラス間でデータや処理を共有することが可能になります。T_PROTECTED定数は引数を取らず、整数値を返します。

protectedは、定義したクラス自身と、それを継承した子クラスからのみアクセスが許可されるメンバー(プロパティやメソッド)に適用されます。クラスの外部から直接アクセスしようとすると、プログラムがエラーで停止するため十分注意してください。$thisは、現在操作しているオブジェクト自身を指す特別な変数であり、クラス内部から自身のプロパティやメソッドにアクセスする際に必ず使用します。親クラスでprotectedに設定されたメンバーも、子クラス内からならば$thisを通じて利用できますが、子クラスの外部からは直接アクセスできません。このアクセス制御は、オブジェクト指向における情報隠蔽(カプセル化)を実現し、コードの安全性と保守性を高める上で非常に重要です。

関連コンテンツ

関連IT用語

関連プログラミング言語