wp_debug_mode() │ WP 3.0.0

Встановлює налаштування обробки помилок у PHP на основі того, які константи вказані wp-config.php файлі WordPress.

Ця функція викликається в ядрі на ранньому етапі (до підключення багатьох файлів і до хука mu_plugin_loaded ). Вона не призначена для прямого використання будь-де.

Використовує три константи:

  • WP_DEBUG (за промовчанням false )
  • WP_DEBUG_DISPLAY (за умовчанням true )
  • WP_DEBUG_LOG (за промовчанням false )

Усі вони визначаються ранньою функцією wp_initial_constants() і можуть бути визначені у файлі wp-config.php .

WP_DEBUG

Якщо увімкнути WP_DEBUG (вказати значення true), то всі PHP помилки (нотатки та попередження) будуть виводитися на екран. WordPress також показує внутрішні нотатки, які створюються самим WordPress, коли використовуються застарілі функції або застарілі змінні функцій або коли змінні використовуються неправильно. Застарілі функції можуть бути видалені у пізніх версіях WordPress.

Важливо! Вимкнений WP_DEBUG не відключає показ усіх видів помилок! Тобто. при відключеному WP_DEBUG будуть показані (оброблені) такі типи помилок:

  • E_CORE_ERROR
  • E_CORE_WARNING
  • E_COMPILE_ERROR
  • E_ERROR
  • E_WARNING
  • E_PARSE
  • E_USER_ERROR
  • E_USER_WARNING
  • E_RECOVERABLE_ERROR

Так, якщо наприклад на сервер по дефолту вказано показувати помилки і при цьому WP_DEBUG вимкнений, то ви все одно будите бачити помилки вказаних вище типів, наприклад WARNING.

Увімкнення WP_DEBUG не змінює значення інших констант. Тобто. якщо вимкнути WP_DEBUG, то WP_DEBUG_DISPLAY та WP_DEBUG_LOG збережуть свої дефолтні значення і на основі цих значень будуть виставлені PHP налаштування показу та логування помилок.

Розробникам настійно рекомендується включати WP_DEBUG під час створення тем і плагінів.

Докладніше про WP_DEBUG .

WP_DEBUG_DISPLAY

Коли WP_DEBUG_DISPLAY = true , WordPress показує помилку екрану.

Якщо вказати у wp-config.php :

  • define( 'WP_DEBUG_DISPLAY', true )— (за замовчуванням) WP виводить (показуватиме) помилки на екран.
  • define( 'WP_DEBUG_DISPLAY', null );– то WP взагалі не вказуватиме значення для PHP опції display_errors, тобто. буде використано глобальне налаштування PHP (сервера).
  • define( 'WP_DEBUG_DISPLAY', false );— показ помилок буде відключений.

Показ помилок завжди відключається для запитів REST, AJAX або XML-RPC. Для них спрацьовує такий код ini_set( ‘display_errors’, 0 ) , але значення константи WP_DEBUG_DISPLAY не змінюється!

WP_DEBUG_LOG

Якщо увімкнути WP_DEBUG_LOG , помилки будуть записуватися у файл debug.log у папці контенту, зазвичай це wp-content .

З версії 5.1 значення цієї константи можна передати шлях до файлу лога, куди потрібно записувати помилки.

Хуки з функції
wp_debug_mode();

Приклади

0

#1 Прикладів немає.

Ця функція використовується ядром для керування помилками і не призначена для використання в розробці.

список змін

З версії 3.0.0Введено.
З версії 5.1.0WP_DEBUG_LOG може бути файлом path.

Код wp_debug_mode() WP 6.0.2

wp-includes/load.php 
function wp_debug_mode() {
	/**
	 * Filters whether to allow the debug mode check to occur.
	 *
	 * Цей filtr runs before it can be used by plugins. It is designed for
	 * non-web runtimes. Returning false causa the `WP_DEBUG` and related
	 * constants to not be checked and default PHP values ​​for errors
	 * will be used unless you take care до update them yourself.
	 *
	 * Для цього файлу ви повинні 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);
	}
}

debug (дебаг)

Залишити відповідь

Ваша e-mail адреса не оприлюднюватиметься. Обов’язкові поля позначені *