This document is for a version of CakePHP that is no longer supported. Please upgrade to a newer release!
コントローラー (Controller) は MVC の 'C' です。ルーティングが適用されて適切なコントローラーが見つかった後、 コントローラーのアクションが呼ばれます。コントローラーはリクエストを解釈して、適切なモデルが 呼ばれるのを確認して、正しいレスポンスまたはビューを書き出します。コントローラーはモデルとビューの 中間層とみなすことができます。コントローラーは薄くシンプルに、モデルを大きくしましょう。 そうすれば、あなたの書いたコードはより簡単に再利用できるようになり、そしてより簡単にテストできるでしょう。
一般的に、コントローラーはひとつのモデルのロジックを管理するために使われます。 たとえば、オンラインベーカリーのサイトを構築しようとしている場合、レシピやその材料を管理する RecipesController と IngredientsController を作るでしょう。 コントローラーは複数のモデルを扱う場合でも問題なく動作しますが、CakePHP では 主に操作するモデルにちなんで、コントローラーの名前が付けられます。
アプリケーションのコントローラーは AppController
クラスを継承し、そしてそれは
Controller
クラスを継承しています。 AppController
クラスは
src/Controller/AppController.php に定義し、アプリケーションのコントローラー全体で
共有されるメソッドを含めるようにしましょう。
コントローラーは、リクエストを操作するための アクション と呼ばれるいくつかのメソッドを提供します。 デフォルトで、コントローラー上のすべての public メソッドはアクションとなり、URL からアクセスができます。 アクションはリクエストを解釈してレスポンスを返す役割があります。 普通、レスポンスは描画されたビューの形式となっていますが、同様のレスポンスを作成する方法は他にもあります。
冒頭で述べたように、 AppController
クラスはアプリケーションのすべてのコントローラーの
親クラスとなります。 AppController
はそれ自身、CakePHP のコアライブラリーに含まれる
Cake\Controller\Controller
クラスを継承しています。
AppController
は src/Controller/AppController.php に次のように定義されます。
namespace App\Controller;
use Cake\Controller\Controller;
class AppController extends Controller
{
}
AppController
で作られたクラス変数とメソッドはそれを継承するすべてのコントローラーで
有効となります。コンポーネント (あとで学びます) は多くのコントローラー
(必ずしもすべてのコントローラーとは限りません) で使われるコードをまとめるのに使われます。
アプリケーション中のすべてのコントローラーで使われるコンポーネントを読み込むために
AppController
を使うことができます。CakePHP はこうした用途のために、 Controller
のコンストラクターの最後で呼び出される initialize()
メソッドを提供します。
namespace App\Controller;
use Cake\Controller\Controller;
class AppController extends Controller
{
public function initialize()
{
// CSRF コンポーネントを常に有効にします。
$this->loadComponent('Csrf');
}
}
initialize()
メソッドに加えて、旧来の $components
プロパティーでも
どのコンポーネントが読まれるべきかを定義することができます。
通常のオブジェクト指向の継承ルールが適用されますが、
コントローラーで使用されるコンポーネントとヘルパーは特別に扱われます。
これらの場合、 AppController
のプロパティーの値は、子コントローラーの配列の値とマージされます。
常に子クラスの値が AppController
の値を上書きします。
CakePHP アプリケーションへのリクエストが生じると、 CakePHP の Cake\Routing\Router
と Cake\Routing\Dispatcher
クラスは正しいコントローラーを見つけて、
インスタンスを作成するために ルートを接続 を使用します。
リクエストデータはリクエストオブジェトに中にカプセル化されています。
CakePHP はすべての重要なリクエスト情報を $this->request
プロパティーの中に格納します。
CakePHP のリクエストオブジェクトについてのより詳しい情報は リクエスト の章を参照してください。
コントローラーのアクションは、リクエストパラメーターを、要求を送ってきたブラウザーやユーザーに対する レスポンスに変換する役割があります。CakePHP は規約に則ることで、このプロセスを自動化し、 本来であればあなたが書かなければならなかったコードを省いてくれます。
CakePHP は規約に従って、アクション名のビューを描画します。オンラインベーカリーの例に戻りますが、
RecipesController は view()
、 share()
、 search()
アクションを持つかもしれません。
このコントローラーは src/Controller/RecipesController.php にあり、
次のようなコードになっています。
// src/Controller/RecipesController.php
class RecipesController extends AppController
{
public function view($id)
{
// アクションの処理をここで行います。
}
public function share($customerId, $recipeId)
{
// アクションの処理をここで行います。
}
public function search($query)
{
// アクションの処理をここで行います。
}
}
これらのアクションのテンプレートファイルは src/Template/Recipes/view.ctp 、 src/Template/Recipes/share.ctp 、そして src/Template/Recipes/search.ctp になります。 規約に従ったビューのファイル名は、アクション名を小文字にしてアンダースコアーでつないだものです。
通常、コントローラーのアクションは View
クラスがビュー層の描画で使う
コンテキストを作るために set()
を使います。
CakePHP の規約に従うと、手動でビューを描画したり生成したりする必要はありません。
代わりに、コントローラーのアクションが完了すると、CakePHP はビューの描画と送信をします。
もし何らかの理由でデフォルトの動作をスキップさせたければ、完全にレスポンスを作成して、
アクションから Cake\Http\Response
オブジェクトを返すこともできます。
アプリケーションでコントローラーを効率的に使うために、CakePHP のコントローラーから提供される いくつかのコアな属性やメソッドを説明しましょう。
コントローラーはビューといくつかの方法でお互いに作用しあっています。最初に、コントローラーは
Controller::set()
を使って、ビューにデータを渡すことができます。
コントローラーからどのビュークラスを使うか、どのビューを描画すべきか、を決めることもできます。
Controller::set()
メソッドはコントローラーからビューへデータを渡すための主な方法です。
Controller::set()
を使った後は、その変数はビュー内でアクセスできるようになります。
// まずコントローラーからデータを渡します
$this->set('color', 'pink');
// すると、ビューでそのデータを利用できます
?>
You have selected <?= h($color) ?> icing for the cake.
Controller::set()
メソッドは最初のパラメーターに連想配列も指定できます。
この方法はデータのかたまりを簡単にビューに割り当てる方法としてよく使われます。
$data = [
'color' => 'pink',
'type' => 'sugar',
'base_price' => 23.95
];
// $color 、 $type 、および $base_price を作成し
// ビューで使用できるようになります
$this->set($data);
もしビュークラスや、レイアウト/テンプレートのパス、
ビューの描画時に使われるヘルパーやテーマをカスタマイズしたければ、
ビルダーを得るために viewBuilder()
メソッドを使います。
このビルダーは、ビューが作成される前にビューのプロパティーを設定するために使われます。
$this->viewBuilder()
->helpers(['MyCustom'])
->theme('Modern')
->className('Modern.Admin');
上記は、どのようにしてカスタムヘルパーを読み込み、テーマを設定し、 カスタムビュークラスを使用できるかを示しています。
バージョン 3.1 で追加: ViewBuilder は 3.1 で追加されました
Controller::render()
メソッドは各アクションの最後に自動的に呼ばれます。
このメソッドは (Controller::set()
で渡したデータを使って)
すべてのビューロジックを実行し、ビューを View::$layout
内に配置し、
エンドユーザーに表示します。
render に使用されるデフォルトのビューファイルは、規約によって決定されます。
RecipesController の search()
アクションがリクエストされたら、
src/Template/Recipes/search.ctp のビューファイルが描画されます。
namespace App\Controller;
class RecipesController extends AppController
{
// ...
public function search()
{
// src/Template/Recipes/search.ctp のビューを描画します
$this->render();
}
// ...
}
CakePHP は ($this->autoRender
に false
をセットしない限り) アクションの後に
自動的に描画メソッドを呼び出しますが、 Controller::render()
メソッドの第一引数に
ビュー名を指定することで、別のビューファイルを指定することができます。
$view
が '/' で始まっていれば、ビューまたはエレメントのファイルが src/Template
フォルダーからの相対パスであると見なします。これはエレメントを直接描画することができ、
AJAX 呼び出しではとても有用です。
// src/Template/Element/ajaxreturn.ctp のエレメントを描画します
$this->render('/Element/ajaxreturn');
Controller::render()
の第二引数 $layout
はビューが描画されるレイアウトを指定することができます。
コントローラーで、規約に従ったものではなく、別のビューを描画したいことがあるかもしれません。
これは Controller::render()
を直接呼び出すことで可能です。一度 Controller::render()
を呼び出すと、CakePHP は再度ビューを描画することはありません。
namespace App\Controller;
class PostsController extends AppController
{
public function my_action()
{
$this->render('custom_file');
}
}
これは src/Template/Posts/my_action.ctp の代わりに src/Template/Posts/custom_file.ctp を描画します。
また、次のような書式で、プラグイン内のビューを描画することもできます。
$this->render('PluginName.PluginController/custom_file')
。
例:
namespace App\Controller;
class PostsController extends AppController
{
public function my_action()
{
$this->render('Users.UserDetails/custom_file');
}
}
これは plugins/Users/src/Template/UserDetails/custom_file.ctp を描画します。
もっともよく使う、フロー制御のメソッドは Controller::redirect()
です。
このメソッドは最初の引数に、CakePHP の相対 URL を受け取ります。
ユーザーが正常に注文を出した時、レシート画面にリダイレクトさせたいかもしれません。
public function place_order()
{
// 注文終了のためのロジック
if ($success) {
return $this->redirect(
['controller' => 'Orders', 'action' => 'thanks']
);
}
return $this->redirect(
['controller' => 'Orders', 'action' => 'confirm']
);
}
このメソッドは適切なヘッダーが設定されたレスポンスのインスタンスを返します。 ビューの描画を抑制し、ディスパッチャーが実際にリダイレクトを行えるようにするために このレスポンスのインスタンスを return すべきです。
$url 引数に相対 URL または絶対 URL を指定することもできます。
return $this->redirect('/orders/thanks');
return $this->redirect('http://www.example.com');
アクションにデータを渡すこともできます。
return $this->redirect(['action' => 'edit', $id]);
Controller::redirect()
の第二引数では、リダイレクトに伴う
HTTP ステータスコードを定義することができます。リダイレクトの性質によっては、
301 (moved parmanently) または 303 (see other) を使ったほうが良いでしょう。
リファラーのページにリダイレクトする必要があれば、次のようにできます。
return $this->redirect($this->referer());
クエリー文字列とハッシュを使う例は次のようになります。
return $this->redirect([
'controller' => 'Orders',
'action' => 'confirm',
'?' => [
'product' => 'pizza',
'quantity' => 5
],
'#' => 'top'
]);
生成される URL はこのようになります。
http://www.example.com/orders/confirm?product=pizza&quantity=5#top
もし、現在のアクションを 同じ コントローラーの異なるアクションにフォワードする必要があれば、
リクエストオブジェクトを更新し、描画されるビューテンプレートを変更し、そして
指定のアクションに実行をフォワードするために Controller::setAction()
を使用します。
// delete アクションから、更新後の一覧ページを描画することができます。
$this->setAction('index');
loadModel
関数は、コントローラーのデフォルト以外のモデルを使う必要がある時に便利です。
// コントローラーのメソッドの中で。
$this->loadModel('Articles');
$recentArticles = $this->Articles->find('all', [
'limit' => 5,
'order' => 'Articles.created DESC'
]);
もしも組み込み ORM 以外のテーブルプロバイダーを使いたければ、 ファクトリーメソッドに接続することで、そのテーブルシステムを CakePHP のコントローラーに紐づけることができます。
// コントローラーのメソッドの中で。
$this->modelFactory(
'ElasticIndex',
['ElasticIndexes', 'factory']
);
テーブルファクトリーを登録した後は、インスタンスを読み出すために
loadModel
を使うことができます。
// コントローラーのメソッドの中で。
$this->loadModel('Locations', 'ElasticIndex');
注釈
組み込みの ORM の TableRegistry は既定では 'Table' プロバイダーとして 接続されています。
このメソッドはモデルから取得した結果をページ分けするために使われます。 ページサイズやモデルの検索条件などを指定できます。 paginate() のより詳しい使い方は ページネーション の章を参照してください。
$paginate
属性は paginate()
がどうふるまうかを簡単にカスタマイズする方法を提供します。
class ArticlesController extends AppController
{
public $paginate = [
'Articles' => [
'conditions' => ['published' => 1]
]
];
}
コントローラーの initialize()
メソッドの中で、読み込みたいコンポーネントや、
その設定データを定義することができます。
public function initialize()
{
parent::initialize();
$this->loadComponent('Csrf');
$this->loadComponent('Comments', Configure::read('Comments'));
}
コントローラーの $components
プロパティーでは、コンポーネントの設定ができます。
設定されたコンポーネントとそれに依存するコンポーネントは CakePHP によって構築されます。
より詳しい情報は コンポーネントの設定 の章を参照してください。先に述べたように、
$components
プロパティーはコントローラーの各親クラスで定義されたプロパティーとマージされます。
追加で利用する MVC クラスをどうやって CakePHP のコントローラーに伝えるのかを見てみましょう。
class RecipesController extends AppController
{
public $helpers = ['Form'];
}
これらの変数はそれぞれ、継承された値とマージされます。したがって、たとえば
FormHelper
を、あるいは AppController
で宣言されている他のクラスを、
再度宣言する必要はありません。
バージョン 3.0 で非推奨: コントローラーからのヘルパーの読み込みは後方互換のために提供しています。 ヘルパーをどう読み込むかについては ヘルパーの設定 を参照してください。
CakePHP のコントローラーはリクエストのライフサイクル周りにロジックを挿入できる いくつかのイベント/コールバックを呼び出します。
Controller.initialize
Controller.startup
Controller.beforeRedirect
Controller.beforeRender
Controller.shutdown
コントローラーでメソッドが実装されていれば、 既定では以下のコールバックメソッドが関連するイベントに接続されます。
コントローラーの各アクションの前に発動する Controller.initialize
イベント中に呼ばれます。アクティブなセッションのチェックや、
ユーザーの権限の調査に適した場所です。
注釈
beforeFilter() メソッドはアクションが存在しない場合でも呼ばれます。
beforeFilter
メソッドからレスポンスを返した場合であっても、
同イベントの他のリスナ―が呼ばれるのを抑制することはしません。
明示的に イベントを停止 しなければなりません。
コントローラーのアクションロジックの後、ビューが描画される前に発動する
Controller.beforeRender
イベント中に呼ばれます。
このコールバックはそれほど使われませんが、もしアクション終了前に
render()
を手動で呼んでいれば
必要になるかもしれません。
コントローラーの各アクションの後、ビューの描画が完了した後に発動される
Controller.shutdown
イベント中に呼ばれます。
これが最後に走るコントローラーのメソッドです。
コントローラーのライフサイクルのコールバックに加えて、 コンポーネント も似たようなコールバックの一式を提供します。
最良の結果を得るために、子コントローラーのコールバック中で
AppController
のコールバックを呼ぶのを忘れないでください。
//use Cake\Event\Event;
public function beforeFilter(Event $event)
{
parent::beforeFilter($event);
}