CakePHP 3 における Controller, Table, Entity のネームスペース

Takahiro Iwasa (岩佐 孝浩)

2017年10月26日

2 min read

CakePHP

CakePHP 3 では、ネームスペースを使用して Controller, Model (Table/Entity) を分離することで、アプリケーションの構造を整理できます。

routes.php の prefix にネームスペースを追加するには、 App\Controller\<NAMESPACE> の形式を使用します。

$routes->connect('/employees', [
    'prefix'     => '<NAMESPACE>',
    'controller' => 'Employees',
    'action'     => 'index',
    '_method'    => ['GET'],
    '_ext'       => 'json',
]);

TableRegistry::get の引数を指定する際には、 ...Table を含む完全修飾名を指定してください。

$table = TableRegistry::get('App\Model\Table\<NAMESPACE>\EmployeesTable');

デフォルトでは、テーブルのエイリアスは完全修飾名です。エイリアスとして完全修飾名を使用したくない場合は、 initialize() メソッドをオーバーライドできます。

public function initialize(array $config)
{
    parent::initialize($config);
    $this->alias('Employees');
}

belongsTo, hasOne, hasMany, belongsToMany を使用して関連を定義する際には、 className に ...Table を含む完全修飾名を指定してください。

$this->belongsTo('Estimates', [
    'className'    => 'App\Model\Table\<NAMESPACE>\CompaniesTable',
    'propertyName' => 'company',
]);

エンティティクラスを指定するには、 Table->entityClass() を使用できます。 Table->entityClass() の引数を指定する際には、完全修飾名を指定してください。

$this->entityClass('App\Model\Entity\<NAMESPACE>\Employee');