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

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

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

基本的な使い方

__constructメソッドは、PHP 8で導入されたAttributeクラスのインスタンスが生成される際に、その初期化処理を実行するメソッドです。Attributeクラスは、プログラムの要素（クラス、メソッド、プロパティ、関数、定数など）に対して、構造に関する追加情報（メタデータ）を付与するために使用される「属性」を定義するための基底クラスとなります。この__constructメソッドは、開発者が作成するカスタム属性が利用される際、その属性に渡される引数を受け取り、属性オブジェクトの初期状態を設定する役割を担います。

例えば、#[MyAttribute(param: "value")]のように属性が宣言された場合、MyAttributeクラスの__constructメソッドがparam: "value"という情報を受け取り、属性が保持すべき値を内部的に設定します。これにより、属性は単なる目印としてだけでなく、具体的なデータを持つオブジェクトとして機能し、そのデータに基づいてプログラムの動作に影響を与えることが可能になります。この機能は、フレームワークの自動設定や、静的解析ツールへのヒント提供など、さまざまな場面で活用されます。

構文(syntax)


1<?php
2
3use Attribute;
4
5#[Attribute]
6class CustomAttributeName
7{
8    public function __construct(string $parameter1, mixed $parameter2 = null)
9    {
10    }
11}

引数(parameters)

int $flags

int $flags: 属性の動作を制御するためのフラグを指定する整数

戻り値(return)

戻り値なし

戻り値はありません

サンプルコード

PHP Attributeの__constructで属性を初期化する


1<?php
2
3#[Attribute(Attribute::TARGET_CLASS)]
4class MyAttribute
5{
6    public function __construct(
7        public int $flags
8    ) {
9        // フラグに基づいて初期化処理を実行できます。
10    }
11}
12
13#[MyAttribute(flags: 1)]
14class MyClass
15{
16    // MyClass の定義
17}
18
19// 属性の情報を取得する例
20$reflection = new ReflectionClass(MyClass::class);
21$attributes = $reflection->getAttributes();
22
23foreach ($attributes as $attribute) {
24    $instance = $attribute->newInstance();
25    echo "Flags: " . $instance->flags . PHP_EOL; // 出力: Flags: 1
26}

PHP 8のAttributeクラスの__constructメソッドは、アトリビュート（属性）を定義する際に使用されるコンストラクタです。このコンストラクタは、アトリビュートに渡す引数を定義するために使用されます。

サンプルコードでは、MyAttributeというカスタムアトリビュートを定義しています。#[Attribute(Attribute::TARGET_CLASS)]は、このアトリビュートがクラスに対して使用できることを示しています。__constructメソッドは、int $flagsという引数を受け取ります。この$flagsは整数型のフラグを表し、アトリビュートの初期化時に値を設定できます。

#[MyAttribute(flags: 1)]は、MyClassクラスにMyAttributeアトリビュートを適用し、$flags引数に1という値を渡しています。

コード後半では、Reflection APIを使ってアトリビュートの情報を取得しています。ReflectionClassでMyClassの情報を取得し、getAttributes()メソッドでアトリビュートの一覧を取得します。取得したアトリビュートのインスタンスをnewInstance()で生成し、$instance->flagsで__constructで設定した$flagsの値にアクセスできます。この例では、Flags: 1が出力されます。

このように、__constructメソッドは、アトリビュートに引数を渡し、アトリビュートの初期化処理を行うための重要な役割を果たします。

Attributeクラスの__constructは、属性定義時に値を設定するために使われます。引数の$flagsは整数型で、属性の挙動を制御するフラグとして利用可能です。サンプルコードでは、MyAttributeをクラスに付与する際にflagsに1を設定しています。

属性の値を取得する際は、リフレクションを使用します。newInstance()で属性のインスタンスを生成することで、$flagsなどのプロパティにアクセスできます。

__construct内で複雑な処理を行う場合、パフォーマンスに影響を与える可能性があるため注意が必要です。また、属性はメタデータとして扱われるため、実行時のロジックに深く依存させることは避けるべきです。属性の利用は、クラスの特性を宣言的に記述する目的で使用することを推奨します。

PHP 8 Attribute コンストラクタとプロパティプロモーション


1<?php
2
3/**
4 * Attribute クラスのコンストラクタの例。
5 * プロパティプロモーションを使用しています。
6 */
7class MyAttribute extends Attribute
8{
9    public function __construct(
10        public int $flags
11    ) {
12        // コンストラクタ内で特に処理は不要な場合、空のままで構いません。
13    }
14
15    public function getFlags(): int
16    {
17        return $this->flags;
18    }
19}
20
21/**
22 * 上記で定義したAttributeを使用する例
23 */
24#[MyAttribute(flags: 1)]
25class MyClass
26{
27    // クラス定義
28}
29
30// Attributeのインスタンスを作成して利用する例
31$attribute = new MyAttribute(flags: 2);
32echo $attribute->getFlags(); // Output: 2

PHP 8のAttributeクラスにおける__constructメソッドは、属性（Attribute）がインスタンス化される際に実行されるコンストラクタです。このコンストラクタは、属性の初期化処理を担います。

引数としてint $flagsを受け取ります。$flagsは整数型の引数であり、属性の動作を制御するためのフラグ値を設定するために使用されます。このフラグ値によって、属性の持つ意味や適用範囲を定義できます。

サンプルコードでは、MyAttributeクラスがAttributeクラスを継承し、コンストラクタ内でプロパティプロモーションを利用しています。プロパティプロモーションを用いることで、コンストラクタの引数として渡された$flagsの値が、自動的にクラスのプロパティとして定義され、初期化されます。これにより、コードの記述量を減らし、可読性を向上させることができます。

コンストラクタの処理が特に必要ない場合、サンプルコードのように空のままでも問題ありません。getFlagsメソッドは、設定された$flagsの値を取得するためのものです。

属性は、#[MyAttribute(flags: 1)]のように、クラスやメソッドなどの宣言の上に付与することで利用できます。属性を使用することで、クラスやメソッドにメタデータを付与し、実行時の動作を制御したり、追加の情報を提供したりすることができます。

サンプルコードの最後の部分では、MyAttributeクラスのインスタンスを直接作成し、getFlagsメソッドを通じてフラグの値を取得しています。これにより、属性が持つ値を実行時に確認したり、利用したりすることが可能です。

PHP 8のAttributeクラスのコンストラクタ__constructは、属性の初期化を行います。引数$flagsは整数型で、属性の設定に使用されます。プロパティプロモーションを使用すると、コンストラクタ内でpublic int $flagsのように引数とプロパティの定義を同時に行えます。これにより、コードが簡潔になります。

属性を使用する際は、#[MyAttribute(flags: 1)]のように、クラスやメソッドの前に記述します。new MyAttribute()でインスタンスを作成することも可能ですが、これは属性として使用する場合とは異なります。属性の値を外部から取得する場合は、別途getterメソッド（例：getFlags()）を定義する必要があります。Attributeクラス自体を直接インスタンス化することは通常ありません。