array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'uk', ), 'this' => array ( 0 => 'yaf-dispatcher.catchexception.php', 1 => 'Yaf_Dispatcher::catchException', 2 => 'Switch on/off exception catching', ), 'up' => array ( 0 => 'class.yaf-dispatcher.php', 1 => 'Yaf_Dispatcher', ), 'prev' => array ( 0 => 'yaf-dispatcher.autorender.php', 1 => 'Yaf_Dispatcher::autoRender', ), 'next' => array ( 0 => 'yaf-dispatcher.construct.php', 1 => 'Yaf_Dispatcher::__construct', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/yaf/yaf_dispatcher/catchexception.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Yaf_Dispatcher::catchException

(Yaf >=1.0.0)

Yaf_Dispatcher::catchException — Switch on/off exception catching

Опис

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

While application.dispatcher.throwException is on (which can also be enabled by calling Yaf_Dispatcher::throwException()), Yaf throws exceptions when errors occur instead of triggering errors.

If exception catching is additionally enabled via this method (or via application.dispatcher.catchException), all uncaught exceptions are caught and dispatched to ErrorController::error, if one is defined.

Параметри

flag

Whether Yaf should catch uncaught exceptions and dispatch them to ErrorController::error.

Зауваження:

Since Yaf 2.2.0, if this parameter is not given, the current state is returned instead.

Значення, що повертаються

Returns the Yaf_Dispatcher object itself when flag is given, or a bool indicating whether exception catching is enabled when it is not.

Приклади

Приклад #1 Yaf_Dispatcher::catchException() example

<?php
/* if you defined an ErrorController like following */
class ErrorController extends Yaf_Controller_Abstract {
     /**
      * you can also call Yaf_Request_Abstract::getException to get the
      * uncaught exception.
      */
     public function errorAction($exception) {
        /* an error occurred */
        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 occurs, assuming accessing a non-existent controller
   (or you can throw an exception yourself): */
404:Could not find controller script **/application/controllers/No-exists-controller.php

Прогляньте також