Private Access Private Access
This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness.
Summery Summery
Set PHP error reporting based on WordPress debug settings.
Syntax Syntax
Description Description
Uses three constants: WP_DEBUG
, WP_DEBUG_DISPLAY
, and WP_DEBUG_LOG
. All three can be defined in wp-config.php. By default, WP_DEBUG
and WP_DEBUG_LOG
are set to false, and WP_DEBUG_DISPLAY
is set to true.
When WP_DEBUG
is true, all PHP notices are reported. WordPress will also display internal notices: when a deprecated WordPress function, function argument, or file is used. Deprecated code may be removed from a later version.
It is strongly recommended that plugin and theme developers use WP_DEBUG
in their development environments.
WP_DEBUG_DISPLAY
and WP_DEBUG_LOG
perform no function unless WP_DEBUG
is true.
When WP_DEBUG_DISPLAY
is true, WordPress will force errors to be displayed. WP_DEBUG_DISPLAY
defaults to true. Defining it as null prevents WordPress from changing the global configuration setting. Defining WP_DEBUG_DISPLAY
as false will force errors to be hidden.
When WP_DEBUG_LOG
is true, errors will be logged to wp-content/debug.log
. When WP_DEBUG_LOG
is a valid path, errors will be logged to the specified file.
Errors are never displayed for XML-RPC, REST, and Ajax requests.
Source Source
File: wp-includes/load.php
* * @since 0.71 * * @global float $timestart Seconds from when timer_start() is called. * @global float $timeend Seconds from when function is called. * * @param int|bool $display Whether to echo or return the results. Accepts 0|false for return, * 1|true for echo. Default 0|false. * @param int $precision The number of digits from the right of the decimal to display. * Default 3. * @return string The "second.microsecond" finished time calculation. The number is formatted * for human consumption, both localized and rounded. */ function timer_stop( $display = 0, $precision = 3 ) { global $timestart, $timeend; $timeend = microtime( true ); $timetotal = $timeend - $timestart; $r = ( function_exists( 'number_format_i18n' ) ) ? number_format_i18n( $timetotal, $precision ) : number_format( $timetotal, $precision ); if ( $display ) { echo $r; } return $r; } /** * Set PHP error reporting based on WordPress debug settings. * * Uses three constants: `WP_DEBUG`, `WP_DEBUG_DISPLAY`, and `WP_DEBUG_LOG`. * All three can be defined in wp-config.php. By default, `WP_DEBUG` and * `WP_DEBUG_LOG` are set to false, and `WP_DEBUG_DISPLAY` is set to true. * * When `WP_DEBUG` is true, all PHP notices are reported. WordPress will also * display internal notices: when a deprecated WordPress function, function * argument, or file is used. Deprecated code may be removed from a later * version. * * It is strongly recommended that plugin and theme developers use `WP_DEBUG` * in their development environments. * * `WP_DEBUG_DISPLAY` and `WP_DEBUG_LOG` perform no function unless `WP_DEBUG` * is true. * * When `WP_DEBUG_DISPLAY` is true, WordPress will force errors to be displayed. * `WP_DEBUG_DISPLAY` defaults to true. Defining it as null prevents WordPress * from changing the global configuration setting. Defining `WP_DEBUG_DISPLAY` * as false will force errors to be hidden.
Advertisement
Changelog Changelog
Version | Description |
---|---|
5.1.0 | WP_DEBUG_LOG can be a file path. |
3.0.0 | Introduced. |