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 が定義されています。

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

class FooController extends Zend_Controller_Action
{
    public function init()
    {
        // このコントローラでのみ無効にします。
        // 初期化時に読み込まれるので、全アクションに影響を及ぼします
        $this->_helper->viewRenderer->setNoRender(true);

        // 全体で無効にします
        $this->_helper->removeHelper('viewRenderer');

        // これも全体で無効にしますが、同時にローカルでも無効にしておく必要があります。
        // これは、ローカルの設定を全体に伝播させる方法です。
        Zend_Controller_Front::getInstance()
            ->setParam('noViewRenderer', true);
    }
}

class FooController extends Zend_Controller_Action
{
    public function barAction()
    {
        // このアクションでのみ自動レンダリングを無効にします
        $this->_helper->viewRenderer->setNoRender();
    }
}

アクションコントローラのコンストラクタをオーバーライドすることもできますが、 お勧めしません。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/

string render(string $action = null,
              string $name = null,
              bool $noController = false);

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 を継承した共通基底コントローラクラスを作成し、 共通処理をそこにまとめていくようにしましょう。

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',
                            500);
    }
}

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',
                            500);
    }
}

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

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;
    }
}

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