wp_debug_mode

函数
wp_debug_mode ( No parameters )
Access
Private
定义位置
相关方法
debug_fopendebug_fclosewp_recovery_modewp_video_shortcodewp_dashboard
引入
3.0.0
弃用
-

wp_debug_mode:此函数用于启用或禁用WordPress调试模式。启用调试模式后,WordPress将记录错误消息并将其显示在网站上。

根据WordPress的调试设置来设置PHP错误报告。

使用三个常量:`WP_DEBUG`, `WP_DEBUG_DISPLAY`, 和`WP_DEBUG_LOG`。所有这三个都可以在wp-config.php中定义。默认情况下,`WP_DEBUG`和`WP_DEBUG_LOG`被设置为false,而`WP_DEBUG_DISPLAY`被设置为true。

当`WP_DEBUG`为真时,所有的PHP通知都会被报告。WordPress也会显示内部通知:当使用了一个弃用的WordPress函数、函数参数或文件时。被弃用的代码可能会在以后的版本中被删除。

强烈建议插件和主题开发者在他们的开发环境中使用`WP_DEBUG`。

`WP_DEBUG_DISPLAY`和`WP_DEBUG_LOG`不执行任何功能,除非`WP_DEBUG`为真。

当`WP_DEBUG_DISPLAY`为真时,WordPress将强制显示错误。`WP_DEBUG_DISPLAY`默认为true。把它定义为null可以防止WordPress改变全局配置设置。将`WP_DEBUG_DISPLAY`定义为false将强制隐藏错误。

当`WP_DEBUG_LOG`为true时,错误将被记录到`wp-content/debug.log`: 当`WP_DEBUG_LOG`是一个有效的路径时,错误将被记录到指定的文件。

对于XML-RPC, REST, `ms-files.php`, 和Ajax请求,永远不会显示错误。

function wp_debug_mode() {
	/**
	 * Filters whether to allow the debug mode check to occur.
	 *
	 * This filter runs before it can be used by plugins. It is designed for
	 * non-web runtimes. Returning false causes the `WP_DEBUG` and related
	 * constants to not be checked and the default PHP values for errors
	 * will be used unless you take care to update them yourself.
	 *
	 * To use this filter you must define a `$wp_filter` global before
	 * WordPress loads, usually in `wp-config.php`.
	 *
	 * Example:
	 *
	 *     $GLOBALS['wp_filter'] = array(
	 *         'enable_wp_debug_mode_checks' => array(
	 *             10 => array(
	 *                 array(
	 *                     'accepted_args' => 0,
	 *                     'function'      => function() {
	 *                         return false;
	 *                     },
	 *                 ),
	 *             ),
	 *         ),
	 *     );
	 *
	 * @since 4.6.0
	 *
	 * @param bool $enable_debug_mode Whether to enable debug mode checks to occur. Default true.
	 */
	if ( ! apply_filters( 'enable_wp_debug_mode_checks', true ) ) {
		return;
	}

	if ( WP_DEBUG ) {
		error_reporting( E_ALL );

		if ( WP_DEBUG_DISPLAY ) {
			ini_set( 'display_errors', 1 );
		} elseif ( null !== WP_DEBUG_DISPLAY ) {
			ini_set( 'display_errors', 0 );
		}

		if ( in_array( strtolower( (string) WP_DEBUG_LOG ), array( 'true', '1' ), true ) ) {
			$log_path = WP_CONTENT_DIR . '/debug.log';
		} elseif ( is_string( WP_DEBUG_LOG ) ) {
			$log_path = WP_DEBUG_LOG;
		} else {
			$log_path = false;
		}

		if ( $log_path ) {
			ini_set( 'log_errors', 1 );
			ini_set( 'error_log', $log_path );
		}
	} else {
		error_reporting( E_CORE_ERROR | E_CORE_WARNING | E_COMPILE_ERROR | E_ERROR | E_WARNING | E_PARSE | E_USER_ERROR | E_USER_WARNING | E_RECOVERABLE_ERROR );
	}

	if (
		defined( 'XMLRPC_REQUEST' ) || defined( 'REST_REQUEST' ) || defined( 'MS_FILES_REQUEST' ) ||
		( defined( 'WP_INSTALLING' ) && WP_INSTALLING ) ||
		wp_doing_ajax() || wp_is_json_request() ) {
		ini_set( 'display_errors', 0 );
	}
}