Zend_Controller_Action は、 モデル - ビュー - コントローラ (MVC) パターンにもとづいたウェブアプリケーションを作成する際に、 フロントコントローラで使用するアクションコントローラを実装するための抽象クラスです。

Zend_Controller_Action を使用するには、 実際のアクションコントローラクラス内でこのクラスのサブクラスを作成する必要があります (あるいは、作成したサブクラスをもとにしてアクションコントローラを作成します)。 基本的な使い方としては、まずサブクラスを作成し、 そしてあなたのサイト上で処理したいさまざまなアクションに対応する アクションメソッドを作成するという流れになります。 Zend_Controller は、このクラス内のメソッドで 'Action' という名前で終わるものを見つけると、 ルーティングやディスパッチの際にそれらを自動的にアクションとして扱います。

たとえば、次のようなクラスを見てみましょう。

class FooController extends Zend_Controller_Action
{
    public function barAction()
    {
        // 何かをします
    }

    public function bazAction()
    {
        // 何かをします
    }
}

この FooController クラス (foo コントローラ) では、ふたつのアクション bar および baz が定義されています。

もちろんこれ以外にもたくさんの機能があります。 たとえば初期化アクションを独自に作成したり、 アクションを指定しなかった (あるいは無効なアクションを指定した) 際にコールされるデフォルトのアクションを指定したり、 ディスパッチの前後に実行されるフックを指定したり、 さまざまなヘルパーメソッドを使用したりといったことができます。 この章では、アクションコントローラの機能の概要を説明します。

デフォルトの挙動

デフォルトでは、フロントコントローラ は ViewRenderer アクションヘルパーを有効にします。このヘルパーは、 ビューオブジェクトをコントローラに注入し、 ビューを自動的にレンダリングします。 アクションコントローラでこれを無効にするには、 以下のいずれかの方法を使用します。 <?php class FooController extends Zend_Controller_Action { public function init() { // このコントローラでのみ無効にします $this->_invokeArgs['noViewRenderer'] = true; // 全体で無効にします $this->_helper->removeHelper('viewRenderer'); // これも全体で無効にしますが、同時にローカルでも無効にしておく必要があります。 // これは、ローカルの設定を全体に伝播させる方法です。 Zend_Controller_Front::getInstance()->setParam('noViewRenderer', true); } } initView()、getViewScript()、 render() および renderScript() は、それぞれ ViewRenderer へのプロキシとなります。 ただしヘルパーブローカ内にこのヘルパーが登録されていない場合や noViewRenderer フラグが設定されている場合は除きます。 個々のビューのレンダリングを無効にするには、単純に ViewRenderer の noRender フラグを設定することもできます。 <?php class FooController extends Zend_Controller_Action { public function barAction() { // このアクションでの自動レンダリングを無効にします $this->_helper->viewRenderer->setNoRender(); } } ViewRenderer を無効にする場面として考えられるのは、 ビューオブジェクトを必要としない場合や ビュースクリプト経由でのレンダリングを行わない場合 (たとえば、アクションコントローラを使用して SOAP や XML-RPC、 REST といったウェブサービスプロトコルを扱う場合) です。ViewRenderer をグローバルで無効にすることはまずないでしょう。 無効にするとすれば、個々のコントローラやアクション単位で行うことになります。

アクションコントローラのコンストラクタをオーバーライドすることもできますが、 お勧めしません。Zend_Controller_Action::__construct() は、リクエストオブジェクトやレスポンスオブジェクトを登録するなどの重要な作業を行います。 また、フロントコントローラから渡された起動時引数の処理も行います。 コンストラクタをオーバーライドする場合は、必ずその中で parent::__construct($request, $response, $invokeArgs) をコールするようにしましょう。

初期化作業をカスタマイズするには、コンストラクタをオーバーライドするよりも init() メソッドを使うほうがお勧めです。これは、__construct() の中で最後にコールされます。たとえば、 初期化時にデータベースに接続したいなら次のようにします。

class FooController extends Zend_Controller_Action
{
    public function init()
    {
        $this->db = Zend_Db::factory('Pdo_Mysql', array(
            'host'     => 'myhost',
            'username' => 'user',
            'password' => 'XXXXXXX',
            'dbname'   => 'website'
        ));
    }
}

Zend_Controller_Action には、 リクエストされたアクションの前後にコールされるふたつのメソッドがあります。それが preDispatch() と postDispatch() です。 これらはさまざまな場面で活用できます。 たとえばアクションを実行する前に認証情報や ACL を調べたり (preDispatch() の中で _forward() をコールすると、 そのアクションの処理は飛ばされます)、 作成したコンテンツを (postDispatch() で) 全サイト共通のテンプレートに配置したりといったことが考えられます。

さまざまなオブジェクトや変数がオブジェクトに登録されており、 それぞれにアクセス用メソッドが用意されています。

Zend_Controller_Action では、 ビューの統合のためのちょっとした柔軟な仕組みを提供しています。 これを行うのは initView() と render() のふたつのメソッドです。前者のメソッドはパブリックプロパティ $view の遅延読み込みを行い、 後者のメソッドはアクションの要求にもとづいてビューをレンダリングします。 その際に、ディレクトリ階層をもとにスクリプトのパスを決定します。

applicationOrModule/
    controllers/
        IndexController.php
    views/
        scripts/
            index/
                index.phtml
        helpers/
        filters/

7.7.5.2. ビューのレンダリング

render() のシグネチャは次のとおりです。

<?php
string render(string $action = null, string $name = null, bool $noController = false);
?>

render() はビュースクリプトをレンダリングします。 引数を省略した場合は、[controller]/[action].phtml が指定されたものとみなします（.phtml は $viewSuffix プロパティの値です）。 $action を指定すると、[controller] ディレクトリにあるその名前のテンプレートをレンダリングします。 [controller] ディレクトリを使用しないようにするには、 $noController に true を指定します。 テンプレートをレンダリングした結果はレスポンスオブジェクトに格納されます。 レスポンスオブジェクトの中の、 特定の名前をつけた部分 に格納したい場合は、 $name の値を指定します。

	注意
	コントローラやアクションの名前には区切り文字 ('_' や '.'、'-') を含めることができるので、 render() はスクリプト名を決定する際にこれらの文字を '-' に正規化します。内部的には、 ディスパッチャで設定されている単語やパスの区切り文字を正規化時に用います。 したがって、/foo.bar/baz-bat へのリクエストの際に レンダリングされるスクリプトは foo-bar/baz-bat.phtml です。 アクションメソッド名が camelCase 方式の場合、 ビュースクリプトのファイル名では単語が '-' で区切られることに注意しましょう。

例を見てみましょう。

<?php
class MyController extends Zend_Controller_Action
{
    public function fooAction()
    {
        // my/foo.phtml をレンダリングします
        $this->render();

        // my/bar.phtml をレンダリングします
        $this->render('bar');

        // baz.phtml をレンダリングします
        $this->render('baz', null, true);

        // my/login.phtml をレンダリングし、レスポンスオブジェクトの 'form' の部分に返します
        $this->render('login', 'form');
        
        // site.phtml をレンダリングし、レスポンスオブジェクトの 'page' の部分に返します
        // 'my/' ディレクトリは使用しません
        $this->render('site', 'page', true);
    }

    public function bazBatAction()
    {
        // my/baz-bat.phtml をレンダリングします
        $this->render();
    }
}

アクセス用メソッドやビューの統合用メソッド以外にも、Zend_Controller_Action にはいくつかのユーティリティメソッドが用意されています。 これらを使用して、アクションメソッド (あるいはディスパッチ前後のフックメソッド) でのさまざまな作業を行います。

アクションコントローラを作成するには、必ず Zend_Controller_Action のサブクラスを作成しなければならないようになっています。 最低限、コントローラがコールするアクションメソッドを定義しなければなりません。

自分のウェブアプリケーション用に便利な機能を実装していく一方で、 同じような前処理やちょっとした処理をあちこちのコントローラで書いているといったことはありませんか？ そのような場合は、Zend_Controller_Action を継承した共通基底コントローラクラスを作成し、 共通処理をそこにまとめていくようにしましょう。

<?php
class MyController extends Zend_Controller_Action
{
    public function __call($method, $args)
    {
        if ('Action' == substr($method, -6)) {
            // アクションメソッドが見つからなかった場合は、エラー用のテンプレートをレンダリングします
            return $this->render('error');
        }

        // その他のメソッドの場合は例外をスローします
        throw new Exception('Invalid method "' . $method . '" called');
    }
}
?>

<?php
class MyController extends Zend_Controller_Action
{
    public function indexAction()
    {
        $this->render();
    }

    public function __call($method, $args)
    {
        if ('Action' == substr($method, -6)) {
            // アクションメソッドが見つからなかった場合は、index アクションに転送します
            return $this->_forward('index');
        }

        // その他のメソッドの場合は例外をスローします
        throw new Exception('Invalid method "' . $method . '" called');
    }
}
?>

__call() をオーバーライドするかわりに、 これまで説明してきた各種フックメソッドをオーバーライドしてコントローラをカスタマイズすることもできます。 たとえば、ビューオブジェクトをレジストリに保存したい場合は、 initView() メソッドを次のように書き換えることになるでしょう。

<?php
abstract class My_Base_Controller extends Zend_Controller_Action
{
    public function initView()
    {
        if (null === $this->view) {
            if (Zend_Registry::isRegistered('view')) {
                $this->view = Zend_Registry::get('view');
            } else {
                $this->view = new Zend_View();
                $this->view->setBasePath(dirname(__FILE__) . '/../views');
            }
        }

        return $this->view;
    }
}
?>

この章の情報をもとに、それぞれの機能の柔軟性をもとにして アプリケーションやサイトの要求に応じたコントローラを作成していくとよいでしょう。