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

# Yaf_Dispatcher::catchException

(Yaf >=1.0.0)

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

### 説明

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

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() - エラーハンドラを設定する

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open