Comment démarrer le mode débogage dans WordPress pour trouver la cause de l'erreur ?

Lorsqu'un site Web WordPress met à jour le programme de base du système, le thème d'arrière-plan ou le plug-in, le message "Ce site Web a un problème majeur" apparaît parfois, ce qui empêche le site Web de fonctionner normalement et parfois même le backend ne peut pas être connecté. . Les webmasters novices peuvent trouver cela assez effrayant. , à ce stade, vous pouvez démarrer le système de débogage intégré de WordPress (Debug Systems) pour comprendre où se produit le problème et le résoudre.

Introduction de base au mode de débogage Debug📂

Debug Systems est un système de débogage intégré pour WordPress, qui enregistre les erreurs système dans le fichier texte debug.log pour aider les webmasters à vérifier où se situent les problèmes un par un, généralement l'incompatibilité entre les programmes de base du système, les thèmes de thème et les plugins, mais le debug system, qui est désactivé par défaut, doit être activé pour déboguer le système.

Il y a un gros problème avec ce site.Veuillez vérifier la boîte de réception de votre webmaster pour obtenir des instructions.

En savoir plus sur le dépannage dans WordPress

Étapes de démarrage du mode débogage

Étape XNUMX : Trouvez le fichier de configuration wp-config.php

Dans le dossier d'installation de WordPress/public_html, recherchez le fichier de configuration principal de WordPress nommé "wp-config.php", et trouvez une ligne de paramètre "define('WP_DEBUG', false);", qui indique que le mode de débogage par défaut n'est pas activé.

define('WP_DEBUG', false);

Étape XNUMX : Modifier WP_DEBUG pour démarrer l'état

Modifiez les paramètres de configuration de wp-config.php, remplacez l'original "define('WP_DEBUG', false);" par la valeur de paramètre officielle, définissez le mode de débogage de démarrage, enregistrez le message d'erreur et arrêtez d'afficher l'écran d'avertissement en premier.

// Enable WP_DEBUG mode
define( 'WP_DEBUG', true );

// Enable Debug logging to the /wp-content/debug.log file
define( 'WP_DEBUG_LOG', true );

// Disable display of errors and warnings
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

// Use dev versions of core JS and CSS files (only needed if you are modifying these core files)
define( 'SCRIPT_DEBUG', true );

Étape XNUMX : Vérifiez l'enregistrement d'erreur de debug.log

Dans le dossier d'installation de WordPress public_html/wp-content, recherchez le fichier texte nommé "debug.log", ouvrez le fichier texte et vérifiez les messages d'erreur un par un, généralement le thème et le plug-in provoquent des erreurs d'exécution PHP.

[12-Aug-2022 14:01:51 UTC] PHP Fatal error:  Allowed memory size of 268435456 bytes exhausted (tried to allocate 20480 bytes)

Cas de solution du mode débogage

Le "problème majeur avec ce site Web" s'est produit cette fois, principalement en raison du passage de l'éditeur traditionnel à l'éditeur de blocs. Souvent, lors de l'ouverture ou de l'ajout d'un article, un écran d'erreur apparaît, qui est généralement résolu après avoir actualisé la page. , mais le même problème se produit souvent.

Après avoir démarré le mode de débogage, lorsque le même problème se reproduit, vérifiez immédiatement le contenu du fichier debug.log et le message "Erreur fatale PHP : taille de mémoire autorisée de 268435456 octets épuisée" apparaît. Il s'est avéré être un problème de mémoire lorsque écrire un article à l'aide de l'éditeur de blocs Le problème de l'insuffisance.

à cause de l'utilisationCloudwaysIl est très pratique d'augmenter la limite supérieure de la mémoire requise par PHP. Le "Setting & Packages" du serveur avancé (Servers) est défini sur la page, et la valeur par défaut de la "Memory Limit" est de 256 Mo, ce qui semble est tout à fait suffisant et n'a pas besoin d'être ajusté.

puis entrezCloudwaysSur l'écran Paramètres de l'application, cochez l'option "PHP FPM SETTINGS" dans la page de configuration "Application Settings". La valeur par défaut est [memory_limit] = 32 M. Après l'avoir augmentée à 64 M, continuez à vérifier si elle est suffisante.

;php_admin_flag[log_errors] = on
;php_admin_value[memory_limit] = 32M
;php_admin_value[max_execution_time] = 120
;php_admin_value[date.timezone] = Asia/Taipei

De plus, il est également possible de modifier directementphp.iniProfil, définissez la limite de mémoire de l'ensemble du serveur ou ajustezwp-config.phpFichier de configuration pour ajuster la limite de mémoire pour un seul site Web.

// 設定一般網頁的記憶體上限
define( 'WP_MEMORY_LIMIT', '128M' );

// 設定管理後台的記憶體上限
define( 'WP_MAX_MEMORY_LIMIT', '256M' );

Si modifiéphp.ini或wp-config.phpSi vous ne pouvez pas modifier la valeur du paramètre, vous devez modifier directement la valeur de configuration PHP, rechercher default-constants.php dans le chemin /public_html/wp-includes et modifier la limite de mémoire par défaut.

// Define memory limits.
	if ( ! defined( 'WP_MEMORY_LIMIT' ) ) {
		if ( false === wp_is_ini_value_changeable( 'memory_limit' ) ) {
			define( 'WP_MEMORY_LIMIT', $current_limit );
		} elseif ( is_multisite() ) {
			define( 'WP_MEMORY_LIMIT', '64M' );
		} else {
			define( 'WP_MEMORY_LIMIT', '40M' );
		}
	}

	if ( ! defined( 'WP_MAX_MEMORY_LIMIT' ) ) {
		if ( false === wp_is_ini_value_changeable( 'memory_limit' ) ) {
			define( 'WP_MAX_MEMORY_LIMIT', $current_limit );
		} elseif ( -1 === $current_limit_int || $current_limit_int > 268435456 /* = 256M */ ) {
			define( 'WP_MAX_MEMORY_LIMIT', $current_limit );
		} else {
			define( 'WP_MAX_MEMORY_LIMIT', '256M' );
		}
	}

Plug-in de débogage en mode débogage

Si vous n'êtes pas familier avec la modification du programme système WordPress, il est recommandé de l'installer directementDébogage WPLe programme plug-in peut activer directement le mode de débogage de WordPress.Le plug-in fournit également la fonction de visualisation du contenu de "debug.log", qui peut directement vérifier et résoudre le problème.