PHP Function Reference

PHP - Error Handling and Logging



These are functions dealing with error handling and logging. They allow us to define our own error handling rules, as well as modify the way the errors can be logged. This allows us to change and enhance error reporting to suit our needs.

With the logging functions, we can send messages directly to other machines, to an email, to system logs, etc., so we can selectively log and monitor the most important parts of your applications and websites.

The error reporting functions allow us to customize what level and kind of error feedback is given, ranging from simple notices to customized functions returned during errors.

Installation

There is no installation needed to use these functions. These functions are part of the PHP core.

Runtime Configuration

The behavior of these functions is affected by settings in php.ini. See Runtime Configuration.

PHP Error Handling and Logging Functions

FunctionsDescription
debug_backtrace() Generates a backtrace.
debug_print_backtrace() Prints a backtrace.
error_clear_last() Clears the most recent error.
error_get_last() Gets the last occurred error
error_log() Send an error message to the defined error handling routines.
error_reporting() Sets which PHP errors are reported.
restore_error_handler() Restores the previous error handler function.
restore_exception_handler() Restores the previously defined exception handler function.
set_error_handler() Generates a user-level error/warning/notice message.
set_exception_handler() Sets a user-defined exception handler function.
trigger_error() Sets a user-defined error handler function.
user_error() Generates a user-level error/warning/notice message. Alias of trigger_error() function.

PHP Errors and Logging Constants

The constants below are always available as part of the PHP core.

Note: These constant names can be used in php.ini but not outside of PHP, like in httpd.conf, where the bitmask values can be used instead.

ValueConstantTypeDescription
1E_ERRORIntegerFatal run-time errors. These indicate errors that can not be recovered from, such as a memory allocation problem. Execution of the script is halted.
2E_WARNINGIntegerRun-time warnings (non-fatal errors). Execution of the script is not halted.
4E_PARSEIntegerCompile-time parse errors. Parse errors should only be generated by the parser.
8E_NOTICEIntegerRun-time notices. Indicate that the script encountered something that could indicate an error, but could also happen in the normal course of running a script.
16E_CORE_ERRORIntegerFatal errors that occur during PHP's initial startup. This is like an E_ERROR, except it is generated by the core of PHP.
32E_CORE_WARNINGIntegerWarnings (non-fatal errors) that occur during PHP's initial startup. This is like an E_WARNING, except it is generated by the core of PHP.
64E_COMPILE_ERRORIntegerFatal compile-time errors. This is like an E_ERROR, except it is generated by the Zend Scripting Engine.
128E_COMPILE_WARNINGIntegerCompile-time warnings (non-fatal errors). This is like an E_WARNING, except it is generated by the Zend Scripting Engine.
256E_USER_ERRORIntegerUser-generated error message. This is like an E_ERROR, except it is generated in PHP code by using the PHP function trigger_error().
512E_USER_WARNINGIntegerUser-generated warning message. This is like an E_WARNING, except it is generated in PHP code by using the PHP function trigger_error().
1024E_USER_NOTICEInteger User-generated notice message. This is like an E_NOTICE, except it is generated in PHP code by using the PHP function trigger_error().
2048E_STRICTIntegerEnable to have PHP suggest changes to your code which will ensure the best interoperability and forward compatibility of your code.
4096E_RECOVERABLE_ERRORInteger Catchable fatal error. It indicates that a probably dangerous error occurred, but did not leave the Engine in an unstable state. If the error is not caught by a user defined handle (set by set_error_handler() function), the application aborts as it was an E_ERROR.
8192E_DEPRECATEDIntegerRun-time notices. Enable this to receive warnings about code that will not work in future versions.
16384E_USER_DEPRECATEDIntegerUser-generated warning message. This is like an E_DEPRECATED, except it is generated in PHP code by using the PHP function trigger_error().
32767E_ALLIntegerAll errors, warnings, and notices.

The above values (either numerical or symbolic) are used to build up a bitmask that specifies which errors to report. The bitwise operators can be used to combine these values or mask out certain types of errors.


5