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() {
        // 現在の名前空間が修飾され問題なくインスタンスが生成される
        $car = new Car();

        // 名前空間が修飾されずクラスが見つからずエラー
        // Fatal error: Class 'Car' not found in /var/www/sample/...
        $className = 'Car';
        $car = new $className();
    }
}

このエラーを解決するには完全修飾形式でクラス名を設定するか、
Car クラスを別途 use 句で指定する必要があります。

解決方法

CarCreator.php

以下、完全修飾形式で $className を指定する場合の例です。

<?php
namespace SampleVendor\Entity
class CarCreator {
    public function create() {
        $className = __NAMESPACE__ . '\\' . 'Car';
        $car = new $className();
    }
}

__NAMESPACE__ 定数は現在の名前空間名の文字列なので、これを先頭に付与しておきます。

CakePHP3で現在のパスやURLを取得する

過去にCakePHP2でのURL取得方法をメモしましたが、CakePHP3では取得方法が変更されていましたのでメモしておきます。

View クラス(テンプレート上)で取得する場合

今までは HtmlHelper で取得していましたが、CakePHP3 では UrlHelper で取得できます。

// 絶対パスとして取得 (/controller/action/)
<?= $this->Url->build('/controller/action/') ?>

// フル URL として取得 (http://example.com/controller/action/)
<?= $this->Url->build('/controller/action/', true) ?>

通常は絶対パスで取得され、第二引数を true にすると URL として取得されます。

View 以外のクラスで取得する場合

Router クラスを使用しますが、use 句で使用することを宣言しておく必要があります。
UrlHelper::build() も最終的には同じメソッドが呼び出されるので引数の仕様は同じです。

use Cake\Routing\Router;

class HogeController extends AppController {
    public function index() {
        // フル URL として取得
        // (http://example.com/controller/action/)
        $path = Router::url('/controller/action/', true);
    }
}