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

Copy
1<?php
2
3/**
4 * PHP 8のコンストラクタプロパティプロモーションを示すサンプルクラスです。
5 *
6 * この機能により、クラスのプロパティ宣言とコンストラクタでの初期化を同時に行うことができます。
7 * システムエンジニアを目指す初心者の方にとって、PHP 8でコードをより簡潔に書くための
8 * 便利な機能として理解することができます。
9 */
10class UserProfile
11{
12    // PHP 8では、コンストラクタの引数にアクセス修飾子（public, protected, private）を付けることで、
13    // その引数が自動的に同じ名前のプロパティとして宣言され、初期化されます。
14    public function __construct(
15        public int $id,           // publicプロパティとして宣言され、初期化される
16        public string $name,      // publicプロパティとして宣言され、初期化される
17        private string $email     // privateプロパティとして宣言され、初期化される
18    ) {
19        // コンストラクタの本体は、必要であれば追加のロジック（例: バリデーション）を記述できます。
20        // $this->id = $id; のようにプロパティを明示的に初期化する必要はありません。
21    }
22
23    /**
24     * ユーザーのフルネームを取得します。
25     *
26     * @return string ユーザーのフルネーム
27     */
28    public function getName(): string
29    {
30        return $this->name;
31    }
32
33    /**
34     * ユーザーのメールアドレスを取得します。
35     * privateなプロパティへのアクセスは、通常このようにアクセサメソッドを通じて行います。
36     *
37     * @return string ユーザーのメールアドレス
38     */
39    public function getEmail(): string
40    {
41        return $this->email;
42    }
43
44    /**
45     * ユーザーのIDを取得します。
46     *
47     * @return int ユーザーID
48     */
49    public function getId(): int
50    {
51        return $this->id;
52    }
53}
54
55// UserProfileクラスのインスタンスを作成
56// コンストラクタに値を渡すだけで、プロパティが自動的に設定されます。
57$user = new UserProfile(101, "Alice Smith", "alice.smith@example.com");
58
59// プロパティに直接アクセス（publicなプロパティのみ）
60echo "ユーザーID: " . $user->id . PHP_EOL;
61echo "ユーザー名: " . $user->name . PHP_EOL;
62
63// メソッドを通じてプロパティにアクセス（privateなプロパティも含む）
64echo "ユーザー名 (メソッド経由): " . $user->getName() . PHP_EOL;
65echo "ユーザーメールアドレス (メソッド経由): " . $user->getEmail() . PHP_EOL;
66
67// 存在しないプロパティやprivateなプロパティに直接アクセスしようとするとエラーになります。
68// echo $user->email; // Fatal error: Uncaught Error: Cannot access private property UserProfile::$email
69?>

このサンプルコードは、PHP 8で導入された「コンストラクタプロパティプロモーション」の機能を示しています。この機能は、クラスのプロパティ宣言と、オブジェクト生成時の初期化を同時に行うことを可能にします。システムエンジニアを目指す初心者の方にとって、PHP 8でコードをより簡潔に記述するための重要な機能として理解できます。

UserProfileクラスでは、__constructメソッド（コンストラクタ）の引数にpublicやprivateといったアクセス修飾子を付与しています。これにより、クラス本体でのプロパティ宣言を省略し、引数名と同じ名前のプロパティが自動的に宣言され、渡された値で初期化されます。例えば、public int $idと記述するだけで、idというパブリックなプロパティが定義され、オブジェクト生成時に渡されたID値が設定されます。

__constructメソッドは、新しいオブジェクト（インスタンス）が作成される際に自動的に呼び出され、オブジェクトの初期状態を設定するための特別なメソッドです。引数（$id, $name, $email）はオブジェクト作成時に必要な初期値を受け取ります。このメソッドは、オブジェクトの内部状態を整える役割を担い、値を返すことはありません（戻り値なし）。

この機能により、UserProfileクラスのインスタンスをnew UserProfile(101, "Alice Smith", "alice.smith@example.com")のように引数を渡して生成するだけで、id、name、emailといったプロパティが自動的に設定されます。idやnameのようなpublicなプロパティには直接アクセスできますが、emailのようなprivateなプロパティにはgetEmail()のような専用のアクセサメソッドを通じてアクセスするのが一般的です。これにより、コードの記述量を減らし、クラスの構造をより簡潔に保つことができます。

Copy
1<?php
2
3/**
4 * 親クラスの例。
5 * コンストラクタ (__construct) を持ち、プロパティを初期化します。
6 */
7class ParentClass
8{
9    protected string $parentMessage;
10
11    /**
12     * ParentClass のコンストラクタ。
13     * クラスの新しいインスタンスが作成されるときに自動的に呼び出されます。
14     *
15     * @param string $message 親クラスの初期メッセージ
16     */
17    public function __construct(string $message)
18    {
19        $this->parentMessage = $message;
20        echo "ParentClass::__construct が呼び出されました。メッセージ: " . $this->parentMessage . PHP_EOL;
21    }
22
23    /**
24     * 親クラスのメッセージを取得します。
25     *
26     * @return string
27     */
28    public function getParentMessage(): string
29    {
30        return $this->parentMessage;
31    }
32}
33
34/**
35 * 子クラスの例。
36 * ParentClass を継承し、自身のコンストラクタで親クラスのコンストラクタを呼び出します。
37 */
38class ChildClass extends ParentClass
39{
40    private string $childMessage;
41
42    /**
43     * ChildClass のコンストラクタ。
44     *
45     * @param string $parentMessage 親クラスに渡すメッセージ
46     * @param string $childMessage  子クラス自身のメッセージ
47     */
48    public function __construct(string $parentMessage, string $childMessage)
49    {
50        // 親クラスのコンストラクタを明示的に呼び出します。
51        // これにより、ParentClass で定義された初期化処理が実行されます。
52        // 子クラスのコンストラクタで親クラスのプロパティを初期化する場合に必要です。
53        parent::__construct($parentMessage);
54
55        $this->childMessage = $childMessage;
56        echo "ChildClass::__construct が呼び出されました。メッセージ: " . $this->childMessage . PHP_EOL;
57    }
58
59    /**
60     * 子クラスのメッセージを取得します。
61     *
62     * @return string
63     */
64    public function getChildMessage(): string
65    {
66        return $this->childMessage;
67    }
68}
69
70// -------------------------------------------------------------------
71// サンプルコードの実行
72// -------------------------------------------------------------------
73
74echo "--- ParentClass のインスタンス化 ---" . PHP_EOL;
75$parentObject = new ParentClass("私は親クラスのメッセージです");
76echo "取得した親のメッセージ: " . $parentObject->getParentMessage() . PHP_EOL;
77echo PHP_EOL;
78
79echo "--- ChildClass のインスタンス化 ---" . PHP_EOL;
80// ChildClass のインスタンスを作成すると、まず親クラスのコンストラクタが呼び出され、
81// その後で子クラス自身のコンストラクタが実行されます。
82$childObject = new ChildClass("これは親へ渡すメッセージです", "そして、これが子クラスのメッセージです");
83echo "取得した親のメッセージ (子クラス経由): " . $childObject->getParentMessage() . PHP_EOL;
84echo "取得した子のメッセージ: " . $childObject->getChildMessage() . PHP_EOL;

PHPにおける__constructは、クラスの新しいインスタンスが作成される際に自動的に呼び出される特別なメソッドです。これは「コンストラクタ」と呼ばれ、クラスのプロパティを初期化したり、インスタンスが使用可能になる前に必要な初期設定を行うために利用されます。コンストラクタには引数を定義することができ、インスタンス作成時にそれらの引数を使ってプロパティを初期化することが可能です。

クラスが他のクラスを継承している場合、子クラスが自身のコンストラクタを持つと、親クラスのコンストラクタは自動的には呼び出されません。このため、子クラスのコンストラクタ内でparent::__construct()を明示的に呼び出すことで、親クラスの初期化処理を実行し、親クラスのプロパティを適切に設定する必要があります。特に親クラスの初期化に必須の引数がある場合に重要です。__constructメソッドは、オブジェクトの初期化を行う役割を持つため、戻り値は定義しません。このサンプルコードでは、親クラスと子クラスにおけるコンストラクタの役割と、parent::__constructを用いた親クラスの初期化方法が示されています。