{"id":1465,"date":"2026-01-07T21:58:51","date_gmt":"2026-01-07T20:58:51","guid":{"rendered":"https:\/\/zaccararoberto.eu\/?p=1465"},"modified":"2026-06-09T16:51:19","modified_gmt":"2026-06-09T15:51:19","slug":"wordpress-debug-mode-post","status":"publish","type":"post","link":"https:\/\/zaccararoberto.eu\/index.php\/blog\/wordpress-debug-mode-post\/","title":{"rendered":"WordPress &#8211; debug mode"},"content":{"rendered":"\n<h4 class=\"wp-block-heading\">Cos&#8217;\u00e8 la modalit\u00e0 di debug in WordPress?<\/h4>\n\n\n\n<div class=\"wp-block-group is-layout-constrained wp-block-group-is-layout-constrained\">\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-7387b849 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<p class=\"wp-block-paragraph\">La <strong>modalit\u00e0 debug<\/strong> in WordPress \u00e8 uno strumento fondamentale per programmatori e amministratori di siti web. Permette di visualizzare gli errori nascosti (come avvisi di PHP, funzioni depresse o errori fatali) che altrimenti potrebbero mostrare una schermata bianca (la famosa &#8220;schermata bianca della morte&#8221;) o non essere rilevati. Ti permette d&#8217; individuare dov&#8217; \u00e8 il problema con precisione, che si tratti di un conflitto di un plugin, un errore di sintassi nel codice o una questione con un tema, questa modalit\u00e0 ti aiuta anche a risolverlo.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ecco come attivarla, spiegato in modo sintetico e gestirla in modo sicuro.  A met\u00e0 pagina la spiegazione approfondita per neofiti.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">1. Come attivare il Debug in WordPress (in sintesi)<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Per attivare il debug devi modificare il file <strong><code>wp-config.php<\/code><\/strong>, che si trova nella cartella principale (root) della tua installazione di WordPress. Puoi farlo tramite il pannello di controllo del tuo hosting (File Manager) o tramite un client FTP (come FileZilla).<\/p>\n\n\n\n<ol start=\"1\" class=\"wp-block-list\">\n<li>Apri il file <code>wp-config.php<\/code>.<\/li>\n\n\n\n<li>Scorri verso il basso fino a trovare questa riga: -&gt; <code>define( 'WP_DEBUG', false );<\/code><\/li>\n\n\n\n<li>Cambia il valore da <code>false<\/code> a <code>true<\/code>: -&gt; <code>define( 'WP_DEBUG', true );<\/code><\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">Se questa riga non esiste, puoi semplicemente aggiungerla subito prima della riga che dice <code>\/* Finito, interrompere le modifiche! Buon blogging. *\/<\/code>.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">2. Configurazione avanzata (Consigliata)<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Lasciare solo <code>WP_DEBUG<\/code> attivo mostrer\u00e0 gli errori direttamente sulle pagine del tuo sito. <strong>Questo \u00e8 pericoloso per un sito in produzione<\/strong>, perch\u00e9 i visitatori (e i malintenzionati) potrebbero vedere informazioni sensibili sulla struttura dei tuoi file.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Per risolvere questo problema, puoi combinare altre costanti:<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Salvare gli errori in un file di log (Invisibile agli utenti)<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Questo comando dice a WordPress di non mostrare gli errori sullo schermo, ma di salvarli in un file segreto chiamato <code>debug.log<\/code> all&#8217;interno della cartella <code>\/wp-content\/<\/code>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">PHP<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>define( 'WP_DEBUG', true );\ndefine( 'WP_DEBUG_LOG', true );\ndefine( 'WP_DEBUG_DISPLAY', false );\n@ini_set( 'display_errors', 0 );\n<\/code><\/pre>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong><code>WP_DEBUG_LOG<\/code><\/strong>: Crea il file di log.<\/li>\n\n\n\n<li><strong><code>WP_DEBUG_DISPLAY<\/code><\/strong>: Impedisce a WordPress di mostrare gli errori nel codice HTML della pagina.<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">3. Riepilogo delle opzioni principali<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><td><strong>Costante<\/strong><\/td><td><strong>Valore<\/strong><\/td><td><strong>Descrizione<\/strong><\/td><\/tr><\/thead><tbody><tr><td><strong><code>WP_DEBUG<\/code><\/strong><\/td><td><code>true<\/code> \/ <code>false<\/code><\/td><td>Attiva o disattiva il sistema di debug generale.<\/td><\/tr><tr><td><strong><code>WP_DEBUG_LOG<\/code><\/strong><\/td><td><code>true<\/code> \/ <code>false<\/code><\/td><td>Salva gli errori nel file <code>\/wp-content\/debug.log<\/code>.<\/td><\/tr><tr><td><strong><code>WP_DEBUG_DISPLAY<\/code><\/strong><\/td><td><code>true<\/code> \/ <code>false<\/code><\/td><td>Mostra o nasconde gli errori a schermo durante la navigazione.<\/td><\/tr><tr><td><strong><code>SCRIPT_DEBUG<\/code><\/strong><\/td><td><code>true<\/code> \/ <code>false<\/code><\/td><td>Forza WordPress a usare le versioni non\u7e54 compresse (<code>.js<\/code> e <code>.css<\/code>) dei file interni (utile se stai modificando script core).<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p class=\"wp-block-paragraph\">\u26a0\ufe0f <strong>Nota di sicurezza:<\/strong> Una volta terminata la ricerca del guasto o lo sviluppo del sito, ricordati sempre di reimpostare <code>WP_DEBUG<\/code> su <code>false<\/code> per garantire la massima sicurezza e performance del tuo sito web.<\/p>\n<\/div>\n\n\n\n<div style=\"height:100px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h5 class=\"wp-block-heading\">Viene sotto riportato come attivare la modalit\u00e0 di debug del cms WordPress per individuare eventuali errori e risolverli, per evitare l&#8217; arresto forzato del software (schermo bianco). <\/h5>\n\n\n\n<h3 id=\"aioseo-method-1-enable-wordpress-debug-mode-using-a-plugin\" class=\"wp-block-heading\">Metodo 1: Abilita la modalit\u00e0 di debug di WordPress utilizzando un plugin<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Un modo semplice per abilitare la modalit\u00e0 di debug \u00e8 utilizzare il plugin&nbsp;<a href=\"https:\/\/wordpress.org\/plugins\/wp-debugging\/\" target=\"_blank\" rel=\"noreferrer noopener\">WP Debugging<\/a>. Questo metodo \u00e8 consigliato ai principianti per coloro che non si sentono a proprio agio a lavorare con i file del sito web.<\/p>\n\n\n\n<div class=\"wp-block-media-text has-media-on-the-right is-stacked-on-mobile\"><div class=\"wp-block-media-text__content\">\n<p class=\"wp-block-paragraph\">WP Debugging \u00e8 un plugin gratuito per WordPress che funziona subito. Utilizzando questo plugin, eviti di modificare manualmente i file. Aggiungi e attiva il plugin&nbsp;<em>WP Debugging<\/em>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Dopo averlo l&#8217;attivato vai su&nbsp;<strong>Strumenti \u00bb WP Debugging<\/strong>&nbsp;dalla bacheca di WordPress ed assicurati che l&#8217;opzione <em>&#8216;Imposta WP_DEBUG su true&#8217;<\/em> sia abilitata.<\/p>\n<\/div><figure class=\"wp-block-media-text__media\"><img loading=\"lazy\" decoding=\"async\" width=\"680\" height=\"374\" src=\"https:\/\/zaccararoberto.eu\/wp-content\/uploads\/2026\/01\/view-the-wp-debugging-settings-1.png\" alt=\"view-the-wp-debugging-settings-1-foto\" class=\"wp-image-2421 size-full\" srcset=\"https:\/\/zaccararoberto.eu\/wp-content\/uploads\/2026\/01\/view-the-wp-debugging-settings-1.png 680w, https:\/\/zaccararoberto.eu\/wp-content\/uploads\/2026\/01\/view-the-wp-debugging-settings-1-300x165.png 300w\" sizes=\"auto, (max-width: 680px) 100vw, 680px\" \/><\/figure><\/div>\n\n\n\n<div class=\"wp-block-media-text is-stacked-on-mobile\"><figure class=\"wp-block-media-text__media\"><img loading=\"lazy\" decoding=\"async\" width=\"680\" height=\"247\" src=\"https:\/\/zaccararoberto.eu\/wp-content\/uploads\/2026\/01\/click-view-file-in-debug-mode.png\" alt=\"\" class=\"wp-image-2423 size-full\" srcset=\"https:\/\/zaccararoberto.eu\/wp-content\/uploads\/2026\/01\/click-view-file-in-debug-mode.png 680w, https:\/\/zaccararoberto.eu\/wp-content\/uploads\/2026\/01\/click-view-file-in-debug-mode-300x109.png 300w\" sizes=\"auto, (max-width: 680px) 100vw, 680px\" \/><\/figure><div class=\"wp-block-media-text__content\">\n<p class=\"wp-block-paragraph\">Successivamente, vedrai un&#8217;opzione &#8216;Debug Quick Look&#8217; aggiunta alla tua barra di amministrazione in alto. Vai avanti, passaci sopra con il mouse e poi fai clic sull&#8217;opzione &#8216;Visualizza file&#8217;. Questo aprir\u00e0 il file di log con tutti gli errori sul tuo sito web. Potrai quindi scoprire cosa sta causando problemi sul tuo sito e risolverli rapidamente. Quando hai finito di eseguire il debug, non dimenticare di disabilitare il plugin, se desideri dopo lo puoi rimuovere.<\/p>\n<\/div><\/div>\n\n\n\n<div style=\"height:33px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h3 id=\"aioseo-method-2-manually-enable-wordpress-debug-mode\" class=\"wp-block-heading\">Metodo 2: Abilita manualmente la modalit\u00e0 di debug di WordPress<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Il secondo metodo per abilitare la modalit\u00e0 di debug di WordPress \u00e8 modificare i file <em>wp-config.php<\/em>. Questo metodo \u00e8 pi\u00f9 avanzato e adatto agli utenti che si sentono a proprio lavorare con i file. Ti consigliamo di&nbsp;<a href=\"https:\/\/www.wpbeginner.com\/it\/plugins\/how-to-backup-restore-your-wordpress-site-with-updraftplus\/\">creare un backup<\/a>&nbsp;del tuo ambiente di lavoro prima di modificare i file. In questo modo, potrai ripristinare facilmente il tutto se qualcosa va storto, ti consiglio di usare uno di questi tre plugin:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>UpdraftPlus<\/strong>&nbsp;\u2013 Perfetto per chi vuole sfruttare gli spazi gratuiti di Dropbox, S3, Google Drive e altro ancora. C\u2019\u00e8 anche una versione gratuita.<\/li>\n\n\n\n<li><strong>BackWPup<\/strong>&nbsp;\u2013 Altra certezza per chi cerca estensioni in grado di salvare il tuo sito. Aspetto importante: puoi fare anche backup del database.<\/li>\n\n\n\n<li><strong>All-in-One WP Migration<\/strong>&nbsp;\u2013 Per chi vuole salvare il sito prima di una migrazione importante e ritrovare tutto al proprio posto, anche il database.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Ci sono diverse possibilit\u00e0 ma tutte con lo stesso fine: modificare il file wp-config.php, cosa che fa anche il plugin WP Debugging. Analizziamo in dettaglio queste possibilit\u00e0:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>WP File Manager <\/strong>\u2013 Perfetto per chi vuole sfruttare un plugin che permette di modificare i file di WordPress, creare file, eliminare file, leggere il loro contenuto. E&#8217; gratuito. <\/li>\n\n\n\n<li><strong>FTP Client <\/strong>&nbsp;\u2013 Collegandovi al server FTP installato dove avere caricato WordPress, ammesso che sia stato caricato il serve Ftp, potete individuare il file da modificare e apportare le modifiche. Sotto il dettaglio delle operazioni da fare. <\/li>\n\n\n\n<li><strong>CLI\/GUI<\/strong> \u2013 Per chi pu\u00f2 accedere direttamente alla console dei comandi pu\u00f2 individuare e modificare il file indicato, consiglio di fare prima un backup, come illustrato sotto.<\/li>\n<\/ul>\n\n\n\n<div class=\"wp-block-media-text is-stacked-on-mobile\"><figure class=\"wp-block-media-text__media\"><img loading=\"lazy\" decoding=\"async\" width=\"680\" height=\"348\" src=\"https:\/\/zaccararoberto.eu\/wp-content\/uploads\/2026\/01\/download-the-wp-config-file.png\" alt=\"download-the-wp-config-file-foto\" class=\"wp-image-2427 size-full\" srcset=\"https:\/\/zaccararoberto.eu\/wp-content\/uploads\/2026\/01\/download-the-wp-config-file.png 680w, https:\/\/zaccararoberto.eu\/wp-content\/uploads\/2026\/01\/download-the-wp-config-file-300x154.png 300w\" sizes=\"auto, (max-width: 680px) 100vw, 680px\" \/><\/figure><div class=\"wp-block-media-text__content\">\n<p class=\"wp-block-paragraph\">Scelto un metodo tra quelli sopra elencati individua la cartella&nbsp;<strong>public_html<\/strong>, raggiungi il file <em>\u2018wp-config.php<\/em>\u2019 posizionato verso il basso. Crea una copia di backup per sicurezza oppure effettua il download sul vostro pc. Una volta aperto il file, individua, verso il fondo la seguente dicitura: \u2018<code>That's all, stop editing! Happy publishing<\/code>\u2018 ed aggiungi il seguente codice prima di essa:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>define( &#8216;WP_DEBUG&#8217;, true);<\/li>\n\n\n\n<li>define( &#8216;WP_DEBUG_LOG&#8217;, true);<\/li>\n\n\n\n<li>define(&#8216;WP_DEBUG_DISPLAY&#8217;, false);<\/li>\n\n\n\n<li>@ini_set( &#8216;display_errors&#8217;, 0 );<\/li>\n<\/ul>\n<\/div><\/div>\n\n\n\n<div class=\"wp-block-group is-layout-constrained wp-block-group-is-layout-constrained\">\n<div style=\"height:59px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n<\/div>\n\n\n\n<div class=\"wp-block-media-text is-stacked-on-mobile\"><figure class=\"wp-block-media-text__media\"><img loading=\"lazy\" decoding=\"async\" width=\"680\" height=\"371\" src=\"https:\/\/zaccararoberto.eu\/wp-content\/uploads\/2026\/01\/save-the-wp-config-file.png\" alt=\"save-the-wp-config-file-foto\" class=\"wp-image-2429 size-full\" srcset=\"https:\/\/zaccararoberto.eu\/wp-content\/uploads\/2026\/01\/save-the-wp-config-file.png 680w, https:\/\/zaccararoberto.eu\/wp-content\/uploads\/2026\/01\/save-the-wp-config-file-300x164.png 300w\" sizes=\"auto, (max-width: 680px) 100vw, 680px\" \/><\/figure><div class=\"wp-block-media-text__content\">\n<p class=\"wp-block-paragraph\">Fai come vedi nell&#8217; immagine a lato, dove sono state abilitate solo due delle funzioni disponibili. Non ti dimenticare di salvare il file prima di chiuderlo, altrimenti dovrai ripetere l&#8217; operazione di modifica del file <em>wp-config.php<\/em>.<\/p>\n<\/div><\/div>\n\n\n\n<div style=\"height:59px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<div class=\"wp-block-media-text is-stacked-on-mobile\"><figure class=\"wp-block-media-text__media\"><img loading=\"lazy\" decoding=\"async\" width=\"680\" height=\"377\" src=\"https:\/\/zaccararoberto.eu\/wp-content\/uploads\/2026\/01\/view-the-debug-log-file.png\" alt=\"view-the-debug-log-file-foto\" class=\"wp-image-2432 size-full\" srcset=\"https:\/\/zaccararoberto.eu\/wp-content\/uploads\/2026\/01\/view-the-debug-log-file.png 680w, https:\/\/zaccararoberto.eu\/wp-content\/uploads\/2026\/01\/view-the-debug-log-file-300x166.png 300w\" sizes=\"auto, (max-width: 680px) 100vw, 680px\" \/><\/figure><div class=\"wp-block-media-text__content\">\n<p class=\"wp-block-paragraph\">Per visualizzare gl&#8217; errori presenti cerca il file .log sul server navigando fino al percorso&nbsp;<strong>public_html\/wp-content\/debug.log<\/strong>. Scaricalo e visualizzalo utilizzando il software Blocco note\/TextEdit per identificare dov&#8217;\u00e8 il problema. Una volta terminato con il debug ti consiglio di disabilitare questa funzione: itera quanto fatto per abilitare rimuovendo il codice che hai aggiunto al file wp-config.php oppure modifica il seguente codice da <em>true<\/em> a <em>false<\/em>:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><code>define( 'WP_DEBUG', false);<\/code><\/p>\n<\/div><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">\ud83d\udd0e\u2728\ud83e\udde0\ud83d\udccc\u2b50\ud83d\uded2\ud83e\uddd1\u27531\ufe0f\u20e32\ufe0f\u20e33\ufe0f\u20e34\ufe0f\u20e3\ud83d\udc4d\u2705\ud83d\udc64\ud83e\udded\ud83e\uddea\u27a1\ufe0f\u2714 \ud83d\ude0a\ud83d\udd25\ud83d\ude80\ud83c\udfaf\u26a0\ufe0f\ud83d\ude97\ud83c\udfcd\ufe0f\ud83d\ude9a\ud83e\udd9c\ud83e\uddbf\ud83d\udedd\ud83e\udde9\ud83c\udf2c\ufe0f\ud83d\udca1\ud83d\udee0\ufe0f\ud83d\udcac\ud83d\udd04\ufe0f\ud83c\udf7e\ud83d\udc49<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Cos&#8217;\u00e8 la modalit\u00e0 di debug in WordPress? La modalit\u00e0 debug in WordPress \u00e8 uno strumento fondamentale per programmatori e amministratori di siti web. Permette di visualizzare gli errori nascosti (come avvisi di PHP, funzioni depresse o errori fatali) che altrimenti potrebbero mostrare una schermata bianca (la famosa &#8220;schermata bianca della morte&#8221;) o non essere rilevati. [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_sitemap_exclude":false,"_sitemap_priority":"","_sitemap_frequency":"","_themeisle_gutenberg_block_has_review":false,"footnotes":""},"categories":[31],"tags":[],"class_list":["post-1465","post","type-post","status-publish","format-standard","hentry","category-wordpress"],"_links":{"self":[{"href":"https:\/\/zaccararoberto.eu\/index.php\/wp-json\/wp\/v2\/posts\/1465","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/zaccararoberto.eu\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/zaccararoberto.eu\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/zaccararoberto.eu\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/zaccararoberto.eu\/index.php\/wp-json\/wp\/v2\/comments?post=1465"}],"version-history":[{"count":47,"href":"https:\/\/zaccararoberto.eu\/index.php\/wp-json\/wp\/v2\/posts\/1465\/revisions"}],"predecessor-version":[{"id":2493,"href":"https:\/\/zaccararoberto.eu\/index.php\/wp-json\/wp\/v2\/posts\/1465\/revisions\/2493"}],"wp:attachment":[{"href":"https:\/\/zaccararoberto.eu\/index.php\/wp-json\/wp\/v2\/media?parent=1465"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/zaccararoberto.eu\/index.php\/wp-json\/wp\/v2\/categories?post=1465"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/zaccararoberto.eu\/index.php\/wp-json\/wp\/v2\/tags?post=1465"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}