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

Copy
1<?php
2
3/**
4 * PHP 8 Example demonstrating the 'static' keyword for properties and methods,
5 * and its difference from non-static members and the usage of '$this'.
6 * Also includes information about the T_STATIC constant.
7 */
8class MyStaticExample
9{
10    // A static property belongs to the class itself, not to any specific object instance.
11    // It is shared across all instances (and accessible even without any instance).
12    public static string $classNameInfo = "This is a static property of MyStaticExample class.";
13
14    // A non-static (instance) property belongs to a specific object instance.
15    public string $instanceName;
16
17    /**
18     * Constructor for MyStaticExample.
19     * Initializes the non-static '$instanceName' property for each new object.
20     *
21     * @param string $name The unique name for this specific object instance.
22     */
23    public function __construct(string $name)
24    {
25        $this->instanceName = $name;
26    }
27
28    /**
29     * A static method can be called directly on the class using MyStaticExample::methodName().
30     * Inside a static method, '$this' is NOT available because there is no object instance
31     * associated with the call context.
32     * To access static properties or methods from within the same class, use 'self::' or 'static::'.
33     *
34     * @return string The value of the static property $classNameInfo.
35     */
36    public static function getClassNameInfo(): string
37    {
38        // Accessing a static property within a static method using 'self::'.
39        return self::$classNameInfo;
40    }
41
42    /**
43     * A non-static method requires an object instance to be called (e.g., $object->methodName()).
44     * Inside a non-static method, '$this' refers to the current object instance,
45     * allowing access to its specific properties and methods.
46     *
47     * @return string The name of this specific object instance.
48     */
49    public function getInstanceName(): string
50    {
51        // Accessing a non-static property using '$this'.
52        return $this->instanceName;
53    }
54}
55
56// --- Demonstrating Usage of Static vs. Non-Static Members ---
57
58echo "--- Static Members (Class-level) ---" . PHP_EOL;
59
60// 1. Accessing Static Properties:
61// Static properties are accessed directly via the class name using '::'.
62echo "Initial static property: " . MyStaticExample::$classNameInfo . PHP_EOL;
63
64// 2. Calling Static Methods:
65// Static methods are called directly via the class name using '::'.
66echo "Output from static method: " . MyStaticExample::getClassNameInfo() . PHP_EOL;
67
68// Changing a static property:
69// Any change to a static property affects its value for all subsequent accesses
70// directly via the class or from any instance (though accessing it via an instance directly is discouraged).
71MyStaticExample::$classNameInfo = "The static class information has been updated!";
72echo "Updated static property: " . MyStaticExample::getClassNameInfo() . PHP_EOL;
73
74echo PHP_EOL;
75
76echo "--- Non-Static Members (Instance-level) ---" . PHP_EOL;
77
78// 1. Creating Object Instances:
79// Non-static members require an object instance to be created first.
80$instance1 = new MyStaticExample("First Instance Object");
81$instance2 = new MyStaticExample("Second Instance Object");
82
83// 2. Accessing Non-Static Properties and Methods:
84// Non-static members are accessed via an object instance using '->'.
85echo "Instance 1's name: " . $instance1->getInstanceName() . PHP_EOL;
86echo "Instance 2's name: " . $instance2->getInstanceName() . PHP_EOL;
87
88// Modifying a non-static property only affects that specific instance.
89$instance1->instanceName = "Updated Name for First Instance";
90echo "Instance 1's new name: " . $instance1->getInstanceName() . PHP_EOL;
91echo "Instance 2's name remains: " . $instance2->getInstanceName() . PHP_EOL; // Instance 2 is unaffected.
92
93echo PHP_EOL;
94
95// --- Understanding T_STATIC Constant ---
96echo "--- T_STATIC Constant Information ---" . PHP_EOL;
97
98// T_STATIC is a predefined PHP constant that represents the 'static' keyword token.
99// It's an internal constant primarily used by PHP's parser (e.g., with token_get_all())
100// to identify the 'static' keyword when analyzing PHP source code.
101// It is not used in application code to define or implement static behavior itself.
102// Its value is an integer.
103echo "Constant Name: T_STATIC" . PHP_EOL;
104echo "Type: int" . PHP_EOL;
105echo "Example Value (PHP 8): " . T_STATIC . PHP_EOL;

PHPのstaticキーワードは、プロパティやメソッドが特定のオブジェクトインスタンスではなく、クラス全体に属し、すべてのインスタンスで共有されることを示します。サンプルコードのstaticプロパティ$classNameInfoやstaticメソッドgetClassNameInfo()は、オブジェクトを作成しなくてもMyStaticExample::のようにクラス名を使って直接アクセスできます。staticメソッド内では、特定のオブジェクトを指す$thisは利用できず、代わりにself::などを用いて同じクラスのstaticメンバーにアクセスします。

一方、staticが付かない非staticなプロパティ$instanceNameやメソッドgetInstanceName()は、オブジェクトを作成し、それぞれのインスタンスに固有のデータや機能を提供します。これらは$instance1->のようにオブジェクト変数を通じてアクセスされ、$thisは現在のオブジェクト自身を指して、そのオブジェクトの持つプロパティやメソッドを利用するために使われます。

T_STATICはPHPの内部定数で、staticキーワードがソースコード中に現れた際に、PHPのパーサーがそれをint型の数値として識別するために利用されます。これはアプリケーション開発者が直接コード中でstaticな振る舞いを定義するために使用するものではなく、PHPの解析機構が裏側で利用するものです。

Copy
1<?php
2
3/**
4 * PHPのT_STATIC定数、staticキーワード、traitの使用例を示すサンプルコード。
5 *
6 * T_STATICはPHPの内部的なトークン定数であり、
7 * PHPパーサがコード内の'static'キーワードを識別する際に使用されます。
8 * 通常、開発者が直接使うことは稀ですが、コード解析ツールなどで利用されます。
9 *
10 * このコードでは、traitとstaticキーワードの基本的な使い方をまず示し、
11 * その後、このコード自身のソースを解析してT_STATICトークンを探すことで、
12 * その存在と意味を具体的に理解できるようにします。
13 */
14
15/**
16 * staticプロパティとメソッドを持つTraitの定義。
17 * traitは複数のクラスでコードを再利用するための仕組みです。
18 */
19trait MyStaticUtilityTrait
20{
21    // staticプロパティ: このプロパティはインスタンスごとではなく、traitを使用するすべてのクラスで共有されます。
22    public static int $callCount = 0;
23
24    /**
25     * staticメソッド: インスタンスを生成せずに直接クラス名から呼び出すことができます。
26     * このメソッドは、MyStaticUtilityTraitを使用するすべてのクラスで共有されます。
27     */
28    public static function incrementAndLogCall(): void
29    {
30        self::$callCount++; // trait内で自身のstaticプロパティにアクセス
31        echo "Trait utility method called. Current count: " . self::$callCount . PHP_EOL;
32    }
33}
34
35/**
36 * 上記のMyStaticUtilityTraitを使用するクラスの定義。
37 */
38class ServiceProcessor
39{
40    use MyStaticUtilityTrait; // traitを使用する宣言
41
42    public function process(): void
43    {
44        echo "Processing data in " . __CLASS__ . "." . PHP_EOL;
45        // traitから提供されたstaticメソッドをクラス内で呼び出す
46        self::incrementAndLogCall();
47    }
48}
49
50// --- staticキーワードとtraitの動作確認 ---
51
52echo "--- Demonstrating 'static' with 'trait' ---" . PHP_EOL;
53
54// 1. traitのstaticメソッドを直接呼び出す
55MyStaticUtilityTrait::incrementAndLogCall();
56
57// 2. traitを使用したクラスのインスタンスを通じてstaticメソッドを呼び出す
58$processor1 = new ServiceProcessor();
59$processor1->process(); // この呼び出しもMyStaticUtilityTrait::$callCountをインクリメントする
60
61$processor2 = new ServiceProcessor();
62$processor2->process(); // 別のインスタンスだが、staticプロパティは共有されている
63
64// 3. staticプロパティの最終値を直接確認
65echo "Final static call count (from trait): " . MyStaticUtilityTrait::$callCount . PHP_EOL;
66echo "Final static call count (from class): " . ServiceProcessor::$callCount . PHP_EOL; // traitのstaticプロパティはクラス経由でもアクセス可能
67
68// --- T_STATIC定数の使用例 ---
69
70echo PHP_EOL . "--- Demonstrating 'T_STATIC' constant ---" . PHP_EOL;
71
72// 現在のスクリプトの内容を読み込む
73$currentScriptContent = file_get_contents(__FILE__);
74
75// PHPコードをトークンに分解する
76// token_get_all() は、PHPコードを解析してトークンの配列を返します。
77// 各トークンは、その種類 (T_STATIC, T_CLASS, T_FUNCTIONなど)、文字列値、行番号を含む配列です。
78$tokens = token_get_all($currentScriptContent);
79
80echo "Searching for T_STATIC tokens in this script..." . PHP_EOL;
81$foundCount = 0;
82
83foreach ($tokens as $token) {
84    // トークンが配列形式の場合（トークンID、文字列値、行番号）
85    if (is_array($token)) {
86        // トークンIDがT_STATICであるかチェック
87        if ($token[0] === T_STATIC) {
88            echo sprintf(
89                "Found T_STATIC keyword: Value = '%s', Line = %d%s",
90                $token[1], // 'static'というキーワードの文字列
91                $token[2], // そのキーワードが見つかった行番号
92                PHP_EOL
93            );
94            $foundCount++;
95        }
96    }
97}
98
99echo "Total 'static' keywords (T_STATIC tokens) found: " . $foundCount . PHP_EOL;
100
101?>

このサンプルコードは、PHPのT_STATIC定数と、staticキーワード、traitの連携について説明します。

T_STATICはPHPの内部的なトークン定数で、PHPパーサがコード中のstaticキーワードを識別するために使用します。この定数には引数はなく、戻り値は整数型のIDです。通常、開発者が直接利用する機会は少なく、コード解析などの特殊な用途で使われます。

まず、traitはPHPにおいて複数のクラスで共通のコードを再利用するための仕組みです。このコードではMyStaticUtilityTraitというtraitを定義し、その中にstaticプロパティとstaticメソッドを配置しています。staticキーワードが付いたプロパティやメソッドは、クラスのインスタンスではなく、クラス自体に紐付きます。そのため、インスタンスを生成せずに直接アクセスでき、staticプロパティはtraitを使用するすべてのクラスで共有されます。サンプルコードでは、ServiceProcessorクラスがこのtraitを使用し、提供されたstaticメソッドを呼び出しています。これにより、複数のServiceProcessorインスタンスがメソッドを呼び出しても、共有された$callCountプロパティが正確にインクリメントされることが確認できます。

最後に、このコード自身のソースをtoken_get_all()関数で解析し、T_STATICトークンを検出しています。これにより、コード中のstaticという文字列が、PHP内部ではT_STATICという特定の整数値で識別されていることを具体的に示しており、T_STATIC定数の役割をより深く理解いただけます。