exception.rst

Exception

Introduction

Exception provides several improvements over vanilla PHP exception class. The most significant change is introduction of parameters.

Parameters will store supplementary information that can help identify and resolve the problem. There are two ways to supply parameters, either during the constructor or using addMoreInfo()

The other option is to supply error is:

I must note that the reason for using parameters is so that the name of the actual exception could be localized easily.

The final step is to actually get all the information from your exception. Since the exception is backwards compatible, it will contain message, code and previous exception as any normal PHP exception would, but to get the parameters you would need to use:

Some param values may be objects.

Output Formatting

Exception (at least for now) contains some code to make the exception actually look good. This functionality may be removed in the later versions to facilitate use of proper loggers. For now:

Will return nice ANSI-colored exception that you can output to the console for user to see. This will include the error, parameters and backtrace. The code will also make an attempt to locate and highlight the code that have caused the problem.

Will return nice HTML-formatted exception that will rely on a presence of Semantic UI. This will include the error, parameters and backtrace. The code will also make an attempt to locate and highlight the code that have caused the problem.

Handling Exceptions in ATK Data and ATK UI

Sometimes you want your exceptions to be displayed nicely. There are several ways:

Try and Catch block

If you want, you can wrap your code inside try / catch block:

try {
    // some code..
} catch (\Atk4\Core\Exception $e) {
    // handle exception
}

The other option is to use automatic exception catching, (:php\Atk4\Ui\App::catchExceptions) which will automatically catch any unhandled exception then pass it to :php\Atk4\Ui\App::caughtException().

If you do not instantiate App, or set it up without automatic exception catching:

$app = new \Atk4\Ui\App(['catchExceptions' => false]);

then you might want to output message details yourself.

Use :phpException::getColorfulText or :phpException::getHtml:

try {
    // some code..
} catch (\Atk4\Core\Exception $e) {
    echo $e->getColorfulText();
} catch (\Exception $e) {
    echo $e->getMessage();
}

Although it's not advisable to output anything else other than the Message to user (in production), you can get values of additional parameters through:

$e->getParams();