Namespace

PHPで動的にクラス名を指定するとオートロードできない件

PHP で動的にクラス名を指定する場合、現在いる名前空間が修飾されないため、
クラス名のみで名前空間内のクラスを指定して new するとクラスを見つけられず致命的なエラーになります。

エラーになる例

クラスファイルのパス構成

例えば PSR-0 規約に準拠して以下のような構成で Car クラスと CarCreator クラスを配置していたとします。

  • /var/www/sample/Vendor/SampleVendor/Entity
    • Car.php
    • CarCreator.php

Car.php

SampleVendor\Entity の名前空間に Car クラスを定義します。

<?php
namespace SampleVendor\Entity

class Car {}

CarCreator.php

この状態で Car クラスと同じ名前空間の CarCreator クラスから Car クラスのインスタンスを生成してみます。（autoload.php は既に読み込まれている状態とします。）

<?php
namespace SampleVendor\Entity

class CarCreator {
    public function create() {
        // 🙆🏻‍♀️ OKパターン:
        // 暗黙的に現在の名前空間が修飾され、問題なくインスタンスの生成ができる
        $car = new Car();

        // 🙅‍♀️ NGパターン:
        // 名前空間が修飾されずクラスが見つからないためエラー
        // Fatal error: Class 'Car' not found in /var/www/...
        $className = 'Car';
        $car = new $className();
    }
}

このエラーを解決するにはどうすればいいでしょうか？

解決方法

完全修飾形式（名前空間まで含めた完全な指定）でクラスを指定するか、Car クラスを別途 use 句で指定することで解決できます。

以下は完全修飾形式でクラスを指定する場合の例です。

<?php
namespace SampleVendor\Entity

class CarCreator {
    public function create() {
        $className = __NAMESPACE__ . '\\' . 'Car';
        $car = new $className();
    }
}

マジック定数の __NAMESPACE__ で現在の名前空間名の文字列を取得できるので、これを先頭に付けてクラスを指定します。