Debugging

• Debug mode
• var_dump
• Bugs

Debug mode

Kirby honours your PHP error logging settings by default. If you've switched off error logging, you won't get any errors and might end up with a white screen.

Especially on your local machine, we recommend to switch on error logging in your php.ini. Kirby has also a built-in option, which tries to enforce this:

c::set('debug', true);

Add this to /site/config/config.php in order to show errors immediately.

Please make sure though to switch this off in production! Displaying PHP errors on a public server can be a security issue

var_dump

If you need to inspect one of Kirby's objects, such as $site, $page or any $file, we recommend to use var_dump:

var_dump($page);

It's a bit like PHP's equivalent of console.log.

The output of var_dump will be massively improved if you have Xdebug installed on your machine. Xdebug is most likely pre-installed if you use MAMP.

Bugs

If you run into an issue, which you simple can't fix yourself and which seems like a Kirby bug, please post it on the forum in the issues category. We will take it from there and either try to help you out or move it to our official issue tracker on Github, if it really turns out to be a bug.