PHP : Custom error handler – handling parse & fatal errors

by

Actually you can handle parse and fatal errors. It is true that the error handler function you defined with set_error_handler() will not be called. The way to do it is by defining a shutdown function with register_shutdown_function(). Here is what I have working in my website:

File prepend.php (this file will be prepended to all php scripts automatically). See below for tips on prepending files to PHP.

set_error_handler("errorHandler");
register_shutdown_function("shutdownHandler");

function errorHandler($error_level, $error_message, $error_file, $error_line, $error_context)
{
$error = "lvl: " . $error_level . " | msg:" . $error_message . " | file:" . $error_file . " | ln:" . $error_line;
switch ($error_level) {
    case E_ERROR:
    case E_CORE_ERROR:
    case E_COMPILE_ERROR:
    case E_PARSE:
        mylog($error, "fatal");
        break;
    case E_USER_ERROR:
    case E_RECOVERABLE_ERROR:
        mylog($error, "error");
        break;
    case E_WARNING:
    case E_CORE_WARNING:
    case E_COMPILE_WARNING:
    case E_USER_WARNING:
        mylog($error, "warn");
        break;
    case E_NOTICE:
    case E_USER_NOTICE:
        mylog($error, "info");
        break;
    case E_STRICT:
        mylog($error, "debug");
        break;
    default:
        mylog($error, "warn");
}
}

function shutdownHandler() //will be called when php script ends.
{
$lasterror = error_get_last();
switch ($lasterror['type'])
{
    case E_ERROR:
    case E_CORE_ERROR:
    case E_COMPILE_ERROR:
    case E_USER_ERROR:
    case E_RECOVERABLE_ERROR:
    case E_CORE_WARNING:
    case E_COMPILE_WARNING:
    case E_PARSE:
        $error = "[SHUTDOWN] lvl:" . $lasterror['type'] . " | msg:" . $lasterror['message'] . " | file:" . $lasterror['file'] . " | ln:" . $lasterror['line'];
        mylog($error, "fatal");
}
}

function mylog($error, $errlvl)
{
...do whatever you want...
}

PHP will call function errorHandler() if he catches an error in any of the scripts. If the error forces the script to shutdown immediately, the error is handled by function shutdownHandler().

This is working on the site I have under development. I haven’t yet tested it in production. But it is currently catching all errors I find while developing it.

I believe there is a risk of catching the same error twice, once by each function. This could happen if an error that I am handling in the function shutdownHandler() was also caught by function errorHandler().

TODO’s:

1 – I need to work on a better log() function to handle errors gracefully. Because I am still in development, I am basically logging the error to a database and echoing it to the screen.

2 – Implement error handling for all MySQL calls.

3 – Implement error handling for my javascript code.

IMPORTANT NOTES:

1 – I am using the following line in my php.ini to automatically prepend the above script to all php scripts:

auto_prepend_file = "/homepages/45/d301354504/htdocs/hmsee/cgi-bin/errorhandling.php"

it works well.

2 – I am logging and resolving all errors, including E_STRICT errors. I believe in developing a clean code. During development, my php.ini file has the following lines:

track_errors = 1
display_errors = 1
error_reporting = 2147483647
html_errors = 0

When I go live, I will change display_errors to 0 to reduce the risk of my users seeing ugly PHP error messages.

I hope this helps someone.

More Related Contents:

  1. Handle fatal errors in PHP using register_shutdown_function()
  2. set_error_handler() doesn’t work for FATAL error
  3. How can I get useful error messages in PHP?
  4. How do I catch a PHP fatal (`E_ERROR`) error?
  5. How to squeeze error message out of PDO? [duplicate]
  6. PHP Fatal error: Using $this when not in object context
  7. How do I log errors and warnings into a file?
  8. Parse error: Syntax error, unexpected end of file in my PHP code
  9. How can I get useful error messages in PHP?
  10. Weird PHP error: ‘Can’t use function return value in write context’
  11. PHP Fatal error: Cannot redeclare class
  12. Fastest way to check if a string is JSON in PHP?
  13. PHP: exceptions vs errors?
  14. How do I turn off PHP Notices?
  15. How to catch this error: “Notice: Undefined offset: 0”
  16. Fatal error: Using $this when not in object context
  17. MYSQLi error: User already has more than ‘max_user_connections’ active connections [duplicate]
  18. relative path in require_once doesn’t work
  19. Good error handling with file_get_contents [duplicate]
  20. How to do error logging in CodeIgniter (PHP)
  21. How can I catch a “catchable fatal error” on PHP type hinting?
  22. Disabling Strict Standards in PHP 5.4
  23. How to handle error for duplicate entries?
  24. Fatal error: Declaration of .. must be compatible with .. PHP
  25. PHP constructor to return a NULL
  26. Best way to handle errors on a php page?
  27. Error handling in PHP
  28. Request exceeded the limit of 10 internal redirects
  29. Apache’s ErrorDocument directive does not redirect
  30. PHP Version 5.2.14 / Parse error: syntax error, unexpected T_FUNCTION, expecting ‘)’

Leave a Comment