Com habilitar el mode de depuració de WordPress per corregir errors

Com podeu habilitar el mode de depuració a WordPress o obtenir més informació sobre els errors de WordPress que es mostren en un navegador web? Si sou un usuari o desenvolupador de WordPress i feu aquestes preguntes, heu arribat al recurs adequat. Aquesta guia us mostrarà com habilitar les funcions de depuració de WordPress.

WordPress ofereix diverses eines de depuració potents tant per a desenvolupadors com per a usuaris generals o no programadors, que podeu habilitar mitjançant les opcions de configuració disponibles. Aquestes opcions, un cop activades, us ajuden a trobar i resoldre errors ràpidament mostrant la informació detallada dels errors.

Demostrarem l'ús del següent error que hem trobat durant la configuració d'un lloc fictici amb finalitats de prova.

Quan observeu aquest error, no hi ha molta informació que l'acompanyi. Hi podria haver moltes causes: el servidor de la base de dades podria estar inactiu o la configuració de connexió de la base de dades (és a dir, el nom de la base de dades, l'usuari de la base de dades i la contrasenya de l'usuari) definida al fitxer de configuració wp-config.php podria ser incorrecta.

Aleshores, com podem obtenir més informació sobre l'error anterior? L'opció WP_DEBUG és una variable global permanent de PHP que activa el mode \debug a tot WordPress fent que es mostrin tots els errors, avisos i avisos de PHP al navegador.

Aquesta característica \debug es va afegir a la versió 2.3.1 de WordPress i està configurada a wp-config.php, un dels fitxers més importants de la vostra instal·lació de WordPress.

De manera predeterminada, la funció \debug està configurada com a fals en qualsevol instal·lació de WordPress. Per habilitar WP_DEBUG, configureu-la com a true.

Primer, aneu al directori d'instal·lació del vostre lloc web, per exemple, /var/www/html/mysite.com i, a continuació, obriu el fitxer wp-config.php amb el vostre editor de text preferit.

$ cd /var/www/html/mysite.com
$ sudo vim wp-config.php

Busca aquesta línia.

define( 'WP_DEBUG',  false );

i canviar-ho per

define( 'WP_DEBUG', true );

Deseu el fitxer i tanqueu-lo.

Ara s'ha activat el mode de depuració. Si tornem a carregar la pàgina que va mostrar l'error, podrem veure la informació detallada de l'error tal com es mostra a la captura de pantalla següent.

Hi ha opcions de depuració addicionals que amplien WP_DEBUG que són especialment útils per als desenvolupadors de WordPress que creen complements o temes, o qualsevol altre component. Són WP_DEBUG_LOG i WP_DEBUG_DISPLAY.

L'opció WP_DEBUG_LOG quan s'estableix com a true fa que tots els errors es desin en un fitxer de registre debug.log dins del directori /wp-content/ de manera predeterminada. Això és útil per a anàlisis o processaments posteriors.

define( 'WP_DEBUG_LOG', true );

Però podeu especificar un fitxer de registre personalitzat, per exemple, /var/log/nginx/mysite.com_wp-errors.log:

define( 'WP_DEBUG_LOG', '/var/log/nginx/mysite.com_wp-errors.log' );

I WP_DEBUG_DISPLAY controla si els missatges de depuració es mostren a l'HTML de les pàgines o no. De manera predeterminada, s'estableix en true. Per desactivar-lo, configureu-lo com a fals.

define( 'WP_DEBUG_DISPLAY', false );

Activeu el mode de depuració a WordPress mitjançant el connector

Si utilitzeu allotjament compartit, probablement no tingueu accés al backend del servidor per editar els vostres fitxers de WordPress, en aquest cas, el fitxer wp-config.php.

O si simplement preferiu canviar la configuració des del tauler d'administració, podeu instal·lar i utilitzar un connector anomenat Barra de depuració que us permet activar/desactivar WP_DEBUG des del tauler d'administració amb un sol clic a la barra d'eines.

La característica principal d'aquest connector és que és segur i intel·ligent, surt automàticament del mode WP_DEBUG en cas d'error.

Referència: Depuració en WordPress.