Skip to content

Instantly share code, notes, and snippets.

@jtrascap

jtrascap/0-Debugging-ExpressionEngine.md

Forked from litzinger/0-Debugging-ExpressionEngine.md
Created May 23, 2017 09:50
Show Gist options
  • Save jtrascap/171c62ee6fae8598c1c55f5cec32029c to your computer and use it in GitHub Desktop.
Save jtrascap/171c62ee6fae8598c1c55f5cec32029c to your computer and use it in GitHub Desktop.
Download ZIP
How to show errors when you get a white screen in EE. Turning up the debugging will reveal PHP errors.
Raw
0-Debugging-ExpressionEngine.md

Overview

Below are two techniques to help debug the WSOD (white screen of death), usually a 500 server error, in an ExpressionEngine site. The Basic-Debugging option will be suitable in most cases and is specific to ExpressionEngine. The Advanced-Debugging is generic and applicable to any PHP based software. If the basic debugging does not work, try the advanced.

If you get a WSOD you will need to first get your site to reveal an error before reporting it to EllisLab or the add-on developer. Simply reporting "I get a white screen" does not give the developer enough information to assist you. An error message on the other hand will point the developer to the source of the issue.

Raw
1-Basic-Debugging.txt
In your config.php file, find $config['debug'] and set it to 2:
$config['debug'] = 2;
In your index.php and admin.php files, find $debug and set it to 1:
$debug = 1;
Raw
2-Advanced-Debugging.txt
<?php
// Taken from http://stackoverflow.com/questions/1475297/phps-white-screen-of-death/18208549#18208549
// Add this to the top of your index.php file.
ini_set('display_errors', 'On');
ini_set('html_errors', 0);
error_reporting(-1);
function ShutdownHandler()
{
if(@is_array($error = @error_get_last()))
{
return(@call_user_func_array('ErrorHandler', $error));
};
return(TRUE);
};
register_shutdown_function('ShutdownHandler');
function ErrorHandler($type, $message, $file, $line)
{
$_ERRORS = Array(
0x0001 => 'E_ERROR',
0x0002 => 'E_WARNING',
0x0004 => 'E_PARSE',
0x0008 => 'E_NOTICE',
0x0010 => 'E_CORE_ERROR',
0x0020 => 'E_CORE_WARNING',
0x0040 => 'E_COMPILE_ERROR',
0x0080 => 'E_COMPILE_WARNING',
0x0100 => 'E_USER_ERROR',
0x0200 => 'E_USER_WARNING',
0x0400 => 'E_USER_NOTICE',
0x0800 => 'E_STRICT',
0x1000 => 'E_RECOVERABLE_ERROR',
0x2000 => 'E_DEPRECATED',
0x4000 => 'E_USER_DEPRECATED'
);
if(!@is_string($name = @array_search($type, @array_flip($_ERRORS))))
{
$name = 'E_UNKNOWN';
};
return(print(@sprintf("%s Error in file %s at line %d: %s\n", $name, @basename($file), $line, $message)));
};
$old_error_handler = set_error_handler("ErrorHandler");
?>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment