Empty Page (White Screen of Death)
If your website suddenly only shows a white page without any error messages, this is referred to as the White Screen of Death (WSoD). This usually indicates PHP errors or incorrect configurations.
Causes of White Pages¶
Typical reasons:
- PHP errors are suppressed (
display_errors
disabled) - Syntax errors in PHP or template files
- Faulty
.htaccess
rules - Database connection issues
- Missing file (e.g., autoload.php)
- File permissions (CHMOD)
Initial Troubleshooting Steps¶
1. Check Logs¶
Go to:
Websites & Domains > Logs
Or: via WebFTP or FTP client > logs/error_log
Look for clues such as:
PHP Fatal error: Uncaught Error...
2. Temporarily Enable display_errors
¶
Create or edit a .user.ini
or .htaccess
file in the root directory of your website:
display_errors = On
error_reporting = E_ALL
Or .htaccess
php_flag display_errors on
php_value error_reporting 32767
Warning
Do not leave this enabled permanently – only for troubleshooting!
Common Solutions¶
Problem | Solution |
---|---|
require(): Failed opening |
File missing – check path or autoload |
Class not found |
Composer autoload missing – run composer install via Composer Toolkit |
Too many redirects |
Loop caused by faulty .htaccess |
500 Internal Server Error |
Syntax or permission issue |
Recommendations¶
- Always check log files first
- Enable display errors only temporarily
- If necessary, start the application in debug mode (e.g., .env=development)