PHPのコンストラクタ：__constructとプロパティの昇格

PHPのコンストラクタは__construct()という名前のメソッドです。new ClassName(...)と書くとPHPが自動で呼び出し、括弧の中の引数がその引数になるので、オブジェクトは値がすでに設定された状態で作られます。

<?php
class User
{
    public string $name;
    public int $age;

    public function __construct(string $name, int $age)
    {
        $this->name = $name;
        $this->age = $age;
    }
}

$ada = new User('Ada', 36);
echo "{$ada->name} is {$ada->age}\n";

コンストラクタがなければ、空のオブジェクトを作ってから各プロパティを設定することになり、1つ設定し忘れても何も止めてくれません。コンストラクタがあれば、引数なしのnew User()はArgumentCountErrorになります。

コンストラクタでのプロパティの昇格

プロパティを宣言し、引数として並べ、$this->name = $nameと代入すると、各名前を3回繰り返すことになります。PHP 8.0以降は、コンストラクタの引数の前にアクセス修飾子を付けると、その3つを一度に行えます。

<?php
class User
{
    public function __construct(
        public string $name,
        public int $age,
        private string $email = '',
    ) {}

    public function contact(): string
    {
        return $this->email !== '' ? $this->email : 'no email';
    }
}

$u = new User('Grace', 45, 'grace@example.com');
echo $u->name, ', ', $u->age, ', ', $u->contact(), "\n";

$v = new User('Linus', 28);
echo $v->name, ', ', $v->contact(), "\n";

昇格した引数はreadonlyにもでき（public readonly string $id）、不変の値オブジェクトをいちばん短く書く方法です。昇格した引数と普通の引数は混ぜられ、コンストラクタの本体には、昇格したプロパティが代入されたあとに実行されるコードも書けます。

デフォルト値と名前付き引数

コンストラクタの引数は、ほかの関数と同じようにデフォルト値を持てます。デフォルト値付きの引数は必須の引数のあとに置きます。名前付き引数（PHP 8.0）を使えば、呼び出し側は前にあるデフォルト値をすべて繰り返さずに、欲しいオプションまで飛ばせます。

<?php
class Button
{
    public function __construct(
        public string $label,
        public string $color = 'blue',
        public string $size = 'medium',
        public bool $disabled = false,
    ) {}

    public function render(): string
    {
        $attr = $this->disabled ? ' disabled' : '';
        return "<button class=\"{$this->color} {$this->size}\"{$attr}>{$this->label}</button>";
    }
}

echo (new Button('Save'))->render(), "\n";
echo (new Button('Delete', 'red'))->render(), "\n";
echo (new Button('Wait', disabled: true))->render(), "\n";

実行してください。出力にはHTMLが含まれるので、Pageタブには描画された3つのボタンが、OutputタブにはPHPが出力したタグが表示されます。(new Button('Save'))->render()の括弧に注目してください。PHP 8.4以降は省略できますが、PHP 8.3では必要です。

コンストラクタで引数を検証する

コンストラクタはfalseやエラーコードを返せません。返したものは無視されるからです。不正な入力を拒否するには例外を投げます。そうすればオブジェクトは作られないので、プログラムのほかの部分は受け取るTemperatureをすべて信頼できます。

<?php
class Temperature
{
    public function __construct(public readonly float $celsius)
    {
        if ($celsius < -273.15) {
            throw new InvalidArgumentException("Below absolute zero: $celsius");
        }
    }

    public function fahrenheit(): float
    {
        return $this->celsius * 9 / 5 + 32;
    }
}

echo (new Temperature(21.5))->fahrenheit(), "\n";

try {
    $t = new Temperature(-300);
} catch (InvalidArgumentException $e) {
    echo 'Rejected: ', $e->getMessage(), "\n";
}

これらの例外のキャッチについては、try catchのページで詳しく扱っています。

静的ファクトリーメソッドで複数のコンストラクタ

PHPにはコンストラクタのオーバーロードがなく、1つのクラスに__constructは1つです。オブジェクトを別々の入力（日付の文字列、配列、タイムスタンプ）から作れるようにするには、引数を準備してnew static(...)を呼ぶ名前付きの静的メソッドを追加します。コンストラクタをprivateにすれば、全員がファクトリーを通すよう強制できます。

<?php
class Color
{
    private function __construct(
        public readonly int $r,
        public readonly int $g,
        public readonly int $b,
    ) {}

    public static function fromRgb(int $r, int $g, int $b): static
    {
        return new static($r, $g, $b);
    }

    public static function fromHex(string $hex): static
    {
        [$r, $g, $b] = sscanf(ltrim($hex, '#'), '%02x%02x%02x');
        return new static($r, $g, $b);
    }

    public function css(): string
    {
        return "rgb({$this->r}, {$this->g}, {$this->b})";
    }
}

echo Color::fromRgb(255, 128, 0)->css(), "\n";
echo Color::fromHex('#1e90ff')->css(), "\n";

これでクラスの外からnew Color(1, 2, 3)とするとError（「Call to private Color::__construct() from global scope」）が投げられます。ここでnew selfではなくnew staticを使う理由はstaticのページで説明しています。

parent::__constructで親のコンストラクタを呼ぶ

子クラスが自分のコンストラクタを定義すると、親のコンストラクタは自動では実行されません。子が自分のプロパティを加える前に親のプロパティが設定されるよう、parent::__construct(...)を（たいてい最初に）呼びます。

<?php
class Vehicle
{
    public function __construct(
        protected string $brand,
        protected int $wheels = 4,
    ) {}

    public function describe(): string
    {
        return "{$this->brand} with {$this->wheels} wheels";
    }
}

class Truck extends Vehicle
{
    public function __construct(string $brand, private int $capacityKg)
    {
        parent::__construct($brand, 6);
    }

    public function describe(): string
    {
        return parent::describe() . ", carries {$this->capacityKg} kg";
    }
}

echo (new Vehicle('Fiat'))->describe(), "\n";
echo (new Truck('Volvo', 18000))->describe(), "\n";

子にコンストラクタがまったくなければPHPは親のものを使うので、new Truck('Volvo')は引数をそのままVehicle::__constructに渡します。詳しくは継承を参照してください。

parent::__constructの書き忘れ

このミスは、起きた行ではエラーになりません。子のコンストラクタは実行され、親の型付きプロパティは未初期化のまま残り、最初に読まれたところであとからプログラムが失敗します。

<?php
class Model
{
    protected array $attributes;

    public function __construct()
    {
        $this->attributes = ['created' => '2026-03-14'];
    }

    public function get(string $key): mixed
    {
        return array_key_exists($key, $this->attributes) ? $this->attributes[$key] : null;
    }
}

class Post extends Model
{
    public function __construct(public string $title)
    {
        // parent::__construct() is missing
    }
}

$post = new Post('Hello');
try {
    echo $post->get('created'), "\n";
} catch (Error $e) {
    echo $e->getMessage(), "\n";
}

Post::__constructの最初の行にparent::__construct();を加えてもう一度実行すると、日付が表示されます。関連するメソッドの__destruct()は、オブジェクトへの最後の参照がなくなったときかスクリプトが終わるときに実行されます。PHPは各リクエストの終わりに自分でファイルを閉じてメモリを解放するので、日常的なコードで必要になることはまれです。