Yaf_Dispatcher::catchException

例外のキャッチのオン/オフを切り替える

説明

public Yaf_Dispatcher Yaf_Dispatcher::catchException(bool $flag = ?)

application.dispatcher.throwException が On (あるいは Yaf_Dispatcher::throwException(TRUE) で有効にした) 場合、Yaf でエラーが発生したときに例外をスローします。

そのとき、 Yaf_Dispatcher::catchException を有効にする (あるいは application.dispatcher.catchException で有効にする) と、もし ErrorController::error を定義していればキャッチしなかった例外はすべて ErrorController::error に送られます。

パラメータ

flag: bool

戻り値

例

例1 Yaf_Dispatcher::catchException の例

/* 次のような ErrorController を定義しているものとします */
<?php
class ErrorController extends Yaf_Controller_Abstract {
     /** 
      * Yaf_Request_Abstract::getException を呼んで
      * 未処理の例外を取得します
      */
     public function errorAction($exception) {
        /* エラーが発生した */
        switch ($exception->getCode()) {
            case YAF_ERR_NOTFOUND_MODULE:
            case YAF_ERR_NOTFOUND_CONTROLLER:
            case YAF_ERR_NOTFOUND_ACTION:
            case YAF_ERR_NOTFOUND_VIEW:
                echo 404, ":", $exception->getMessage();
                break;
            default :
                $message = $exception->getMessage();
                echo 0, ":", $exception->getMessage();
                break;
        }
     } 
}
?>

上の例の出力は、たとえば以下のようになります。

/* now if some error occur, assuming access a non-exists controller(or you can throw a exception yourself): */
404:Could not find controller script **/application/controllers/No-exists-controller.php

参考

Yaf_Dispatcher::throwException
Yaf_Dispatcher::setErrorHandler