How to debug PHP code? What is debugging?

Debugging is a process to find and reduce number of bugs in your code. An unavoidable but not particularly fun part of building applications. There are multiple approaches to debugging available for PHP, but before that, you must set your development environment up in such a way as to be able to see meaningful errors.



Turn on error reporting and set the appropriately useful error reporting level, either in your development code, or better yet, in your php.ini file:

ini_set('display_errors', 'On');
error_reporting(E_ALL | E_STRICT);

Types of errors

Syntax errors

These are caused by a typo in your code. Examples include missing semicolons, quotation marks, incorrect variable definitions and so on.


Warnings will not break the execution of the script like syntax errors. Warnings are to notify you when you’ve made a mistake somewhere in your code but when the script can still execute.

Deprecated: mysql_connect(): The mysql extension is deprecated and will be removed in the future: use mysqli or PDO instead in /var/www/project/includes/ on line 2


Notices will not break the execution of the script (just like with Warnings), but they are important pieces of information for debugging your application.

Fatal errors

These errors are quite simple to debug, due to the script will cease execution when a fatal error occurs. Example of fatal errors include undefined functions, classes and so on.

Fatal error: Call to undefined function bootstrap() in /var/www/project/index.php on line 23


One of the most common and simple techiques for PHP debugging is using var_dump or print_r functions:

$date = '28. 04. 2015';
$start = DateTime::createFromFormat('d. m. Y', $date);

That way you can quickly end execution and check the variable when you want to know more.


Xdebug - A Swiss-Army knife of PHP, Xdebug is a debugger and profiler that can be used for more advanced debugging than simply using the var_dump or print_r functions. It is one of the most commonly used PHP debuggers. Numerous IDEs also utilize it to provide you with a PHP debugging environment.


Phpdbg is integrated in PHP since PHP 5.6.0. It is implemented and distributed as an SAPI module (just like the CLI interface).

Symfony VarDumper

You can debug better by using the dump() function of Symfony VarDumper component than is otherwise possible with using var_dump or print_r.


require __DIR__.'/vendor/autoload.php';
// create a variable, which could be anything!
$someVar = '...';


Zend Debugger

The Zend Debugger is a PHP extension that should be installed on your Web server in order to perform optimal remote debugging and profiling using Zend Studio.


FirePHP is a debugger that enables you to log to your Firebug Console using a simple PHP method call.


FB::log('Log message');
FB::info('Info message');
FB::warn('Warn message');
FB::error('Error message');
GitHub OctocatFound a typo? Something wrong with this content? Just fork and edit it.

Content of this work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. Code snippets in examples are published under the CC0 1.0 Universal (CC0 1.0). Thanks to all the contributors.