コントローラやアクションが存在しない場合に発生するエラー

アクションコントローラ内で発生するエラー

パラメータ useDefaultControllerAlways を設定します。

フロントコントローラかディスパッチャのいずれかで、 以下のディレクティブを追加します。

<?php
$front->setParam('useDefaultControllerAlways', true);

// あるいは
$dispatcher->setParam('useDefaultControllerAlways', true);

このフラグを設定すると、 ディスパッチャは例外をスローせず、 かわりにデフォルトのコントローラとアクションを使用するようになります。 この方式の欠点は、ユーザがサイトのアドレスを打ち間違えた際にも ホームページが表示されてしまうことです。これは サーチエンジン最適化を台無しにしてしまう可能性があります。

dispatch() がスローする例外は Zend_Controller_Dispatcher_Exception で、この中には 'Invalid controller specified' というテキストが含まれます。 先ほどの節 でとりあげられているメソッドのいずれかでこの例外を捕捉し、 共通のエラーページあるいはホームページにリダイレクトします。

Zend_Controller_Action のサブクラスを作成し、 __call() メソッドをオーバーライドします。 たとえば次のようになります。

<?php
class My_Controller_Action extends Zend_Controller_Action
{
    public function __call($method, $args)
    {
        if ('Action' == substr($method, -6)) {
            $controller = $this->getRequest()->getControllerName();
            $url = '/' . $controller . '/index';
            return $this->_redirect($url);
        }

        throw new Exception('Invalid method');
    }
}

上の例は、未定義のアクションメソッドがコールされた場合にそれをすべて受け取り、 そのコントローラのデフォルトアクションにリダイレクトします。

Zend_Controller_Dispatcher のサブクラスを作成し、 getAction() メソッドをオーバーライドして、 アクションが存在するかどうかを調べます。 たとえば次のようになります。

<?php
class My_Controller_Dispatcher extends Zend_Controller_Dispatcher
{
    public function getAction($request)
    {
        $action = $request->getActionName();
        if (empty($action)) {
            $action = $this->getDefaultAction();
            $request->setActionName($action);
            $action = $this->formatActionName($action);
        } else {
            $controller = $this->getController();
            $action     = $this->formatActionName($action);
            if (!method_exists($controller, $action)) {
                $action = $this->getDefaultAction();
                $request->setActionName($action);
                $action = $this->formatActionName($action);
            }
        }

        return $action;
    }
}

上のコードは、指定したアクションが そのコントローラクラスに存在するかどうかを調べます。 存在しない場合は、デフォルトのアクションにリセットします。

この方式の利点は、最終的にディスパッチが行われる前に 透過的にアクションを変更できるとうことです。しかしこれは、 URL を打ち間違えた際にも正しくディスパッチされてしまうということでもあります。 これは、サーチエンジン最適化のためにはあまりよくありません。

Zend_Controller_Action::preDispatch() あるいは Zend_Controller_Plugin_Abstract::preDispatch() を使用して、無効なアクションを判別します。

Zend_Controller_Action のサブクラスを作成して preDispatch() を変更することで、 実際にアクションをディスパッチする前に コントローラ内で別のアクションに転送したり リダイレクトしたりすることが可能となります。 このコードは、先ほど説明した __call() をオーバーライドするコードと似たものになります。

もうひとつの方法としては、 この情報をグローバルプラグインで調べることもできます。 この方式の利点は、アクションコントローラとは独立しているというところです。 アプリケーション内でさまざまなアクションコントローラを使用しているとしましょう。 それらがすべて同一のクラスを継承しているとは限りません。 そのような場合にこの方式を使用すると、 さまざまなクラスに対して一貫した処理を行うことができます。

たとえば次のようになります。

<?php
class My_Controller_PreDispatchPlugin extends Zend_Controller_Plugin_Abstract
{
    public function preDispatch(Zend_Controller_Request_Abstract $request)
    {
        $dispatcher = Zend_Controller_Front::getInstance()->getDispatcher();
        $controller = $dispatcher->getController($request);
        if (!$controller) {
            $controller = $dispatcher->getDefaultControllerName($request);
        }
        $action     = $dispatcher->getAction($request);

        if (!method_exists($controller, $action)) {
            $defaultAction = $dispatcher->getDefaultAction();
            $controllerName = $request->getControllerName();
            $response = Zend_Controller_Front::getInstance()->getResponse();
            $response->setRedirect('/' . $controllerName . '/' . $defaultAction);
            $response->sendHeaders();
            exit;
        }
    }
}

この例では、 リクエストされたアクションがそのコントローラに存在するかどうかを調べます。 存在しない場合は、そのコントローラのデフォルトアクションにリダイレクトします。 そしてそこでスクリプトの実行を終了します。