Documentation

Difference between revisions of "Managing PHP errors"

Line 1: Line 1:
PHP errors are not displayed by default. If an error occurs, you will simply get a blank page. This is for security reasons: this way, an attacker doesn't know about possible vulnerabilities of your website. If you want to see PHP errors, you can log them to a file, or enable the display of errors.
+
PHP errors are not displayed by default. If an error occurs, you will simply get a blank page. This is for security reasons: this way, an attacker doesn't know about possible vulnerabilities of your website. If you want to see PHP errors, you can log them to a file, or enable the display of errors. Note that it can take up to 5 minutes for any of the options mentioned below to be detected.
  
 
= Logging errors to a file =
 
= Logging errors to a file =

Revision as of 22:19, 8 July 2020

PHP errors are not displayed by default. If an error occurs, you will simply get a blank page. This is for security reasons: this way, an attacker doesn't know about possible vulnerabilities of your website. If you want to see PHP errors, you can log them to a file, or enable the display of errors. Note that it can take up to 5 minutes for any of the options mentioned below to be detected.

Logging errors to a file

If your username is foobar, create a .user.ini file (for example: ~/www/.user.ini) with this content, if you are a regular user:

log_errors = on
error_log = "/home/user/foobar/php_error.log"

Or if you are an organization:

log_errors = on
error_log = "/home/org/foobar/php_error.log"

Displaying errors

Create a .user.ini file (for example: ~/www/.user.ini) with this content:

display_errors = on

Note that PHP errors may include sensitive information, and enabling display_errors will cause that to be visible to the entire internet. It is therefore advised to only enable display_errors when actively troubleshooting a problem. Instead use an error log as specified above.