Depurar errores en WordPress

WordPress permite configurar la depuración en wp-config.php. Para investigar un fallo en una web pública, envía los detalles a un registro privado y mantén oculta la salida de errores.

Realiza estas pruebas preferiblemente en una copia de staging. En producción no muestres errores en pantalla: pueden revelar rutas, consultas y datos internos a cualquier visitante.

Registrar los errores sin mostrarlos

Crea un directorio de registros fuera de public_html, asegúrate de que PHP pueda escribir en él y aplica permiso 0600 al fichero cuando el sistema lo permita. Añade temporalmente estas líneas a wp-config.php, sustituyendo CPANEL_USUARIO. Colócalas antes de que se cargue wp-settings.php, normalmente antes del comentario que indica que se deje de editar. Si alguna constante ya existe, cambia su valor en lugar de declararla por segunda vez:

define('WP_DEBUG', true);
define('WP_DEBUG_DISPLAY', false);
define('WP_DEBUG_LOG', '/home/CPANEL_USUARIO/logs/wordpress-debug.log');
@ini_set('display_errors', '0');

No uses wp-content/debug.log en una web pública salvo que el servidor bloquee expresamente su descarga. Reproduce una sola vez el fallo, anota la hora y conserva el primer error de esa petición con unas pocas líneas de contexto. Revisa que no contenga contraseñas, tokens ni datos personales antes de compartir extractos.

Visualizo una pantalla en blanco

Si el registro de WordPress no recoge el fallo, activa temporalmente el registro de PHP desde cPanel y consulta la misma hora, o pide a soporte que lo revise. Mantén siempre display_errors desactivado en producción.

Desactivar y limpiar

Al terminar, restaura los valores anteriores de WP_DEBUG, WP_DEBUG_LOG y WP_DEBUG_DISPLAY, retira la línea temporal de ini_set y borra el fichero cuando ya no sea necesario. La depuración no debe quedar activa de forma indefinida en producción.

Si no aparece la entrada esperada

Comprueba que editaste el wp-config.php utilizado por esa instalación y que PHP puede escribir en la ruta elegida. Usa los valores booleanos true y false sin comillas: el texto 'false' no equivale al booleano falso.

WP_DEBUG amplía los niveles de error y puede generar muchos avisos que no causan el fallo. Relaciona el primer error relevante con la petición y su hora. Si hay un error de sintaxis antes de que WordPress cargue estas opciones, consulta el registro PHP del servidor. La guía oficial de depuración detalla el alcance de cada constante.