Depurar errores PHP en WordPress

📅 Publicado el 1 de agosto, 2026 · Por Equipo RedServicio

Si alguna vez te has encontrado con la famosa «Pantalla Blanca de la Muerte» o un mensaje de «Error Crítico», sabes que sensación produce. Es como si el sitio se cerrara en tu cara. Y claro, no saber qué está fallando es lo peor. Lo bueno es que depurar errores PHP en WordPress no es ciencia espacial si tienes las herramientas adecuadas. Ahí es donde entra el archivo wp-config.php, que tiene una función oculta diseñada justamente para sacarnos de este apuro.

Vamos a ver, paso a paso, cómo activar la depuración para dejar de adivinar y encontrar la causa raíz del problema. Ojo, antes de meterte a tocar código, asegúrate de tener un backup o un buen hosting; en RedServicio.net nos encargamos de que tus copias de seguridad estén al día por si las moscas.

¿Por qué hay que activar la depuración?

Por defecto, WordPress es bastante reservado. Oculta los errores técnicos y las advertencias de PHP a los visitantes. Tiene sentido: no queremos que cualquier usuario vea rutas de servidor o detalles de la base de datos. Pero cuando eres tú el que tiene que arreglar el sitio, ese silencio es tu peor enemigo.

Activar la depuración fuerza a WordPress a soltar la ropa y mostrar estos mensajes. Así podrás ver:

• Errores fatales: Normalmente por sintaxis mal escrita en plugins o temas.
• Advertencias (Warnings): El código funciona, pero está obsoleto o algo «huele mal».
• Avisos (Notices): Variables sin definir o pequeñas cosas que, si se acumulan, pueden dar dolores de cabeza.

Encontrar y editar wp-config.php

El primer paso para depurar errores PHP es ir al grano. El archivo wp-config.php vive en el directorio raíz de tu instalación, justo al mismo nivel que las carpetas /wp-content, /wp-admin y /wp-includes.

Cómo acceder

Tienes dos caminos principales para hacerlo:

1. Administrador de Archivos (cPanel / Plesk): Entra desde tu panel, ve a la carpeta public_html, haz clic derecho en wp-config.php y elige «Edit».
2. Cliente FTP (FileZilla, etc.): Baja el archivo a tu ordenador, ábrelo con un editor de texto plano (Notepad++, VS Code) y vuelve a subirlo.

Activar el modo WP_DEBUG

Con el archivo abierto, busca esta línea. Suelo encontrarla cerca de la parte superior, sobre la línea 80, justo antes del cartel que dice «¡Eso es todo, deja de editar!»:

define( 'WP_DEBUG', false );

Para encenderlo, cambia el false por true. Queda así:

define( 'WP_DEBUG', true );

Al guardar y recargar la página, los errores de PHP empezarán a aparecer en la pantalla. Arriba, abajo… depende de dónde falle el tema. Es la forma más rápida de saber qué plugin o tema está causando el lío.

Ajustes avanzados para un registro más limpio

Ver los errores en pantalla ayuda, pero en un sitio en vivo puede ser un desastre visual o romper el diseño. A veces, los errores de encabezado («Headers already sent») ni siquiera te dejan cargar la página si activas la depuración visual. Para eso, usamos un par de constantes extra que trabajan con WP_DEBUG.

Guardar todo en un archivo log (WP_DEBUG_LOG)

Esta opción es clave para producción. Hace que los errores se guarden en un archivo de texto dentro de /wp-content en vez de mostrárselos a la gente. Añade esta línea justo debajo de la que modificaste:

define( 'WP_DEBUG_LOG', true );

Con esto, cada vez que haya un fallo, WordPress escribirá los detalles en debug.log. Puedes verlo yendo a tudominio.com/wp-content/debug.log por FTP o gestor de archivos.

Ocultar errores de la pantalla (WP_DEBUG_DISPLAY)

Para completar el truco, asegúrate de que los errores no molesten a tus visitantes añadiendo esto:

define( 'WP_DEBUG_DISPLAY', false );

Así, tu web se ve normal para el usuario, pero tú revisas el debug.log a escondidas para diagnosticar el problema sin interrumpir el servicio.

Código final recomendado para wp-config.php

Para que te sea más fácil, aquí tienes el bloque de código completo que debes meter en tu wp-config.php. Copia y pega, revisando que no haya líneas duplicadas:

// Habilitar el modo de depuración de WP
define( 'WP_DEBUG', true );
// Guardar los errores en el archivo /wp-content/debug.log
define( 'WP_DEBUG_LOG', true );
// No mostrar errores en la pantalla (útil para sitios en producción)
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

Interpretando los resultados comunes

Una vez activado el modo depuración y provocado el error (recargando la página donde falla), verás mensajes específicos. Aquí te explico los que suelen aparecer más a menudo:

1. Fatal Error: Call to undefined function

Significa que estás intentando usar una función que no existe o no se ha cargado. Muy común después de actualizar un tema o plugin si el desarrollador borró algo que tu sitio personalizado estaba usando.

2. Syntax Error, unexpected T_STRING

Un error de escritura en el código PHP. Falta un punto y coma (;), un paréntesis de cierre ()) o hay una comilla mal puesta. Si esto pasó justo después de que editarás un archivo (como functions.php), revisa tu última edición con lupa.

3. Allowed memory size exhausted

Tu sitio web se ha quedado sin memoria RAM para ejecutar los procesos de PHP. Ocurre en sitios con muchos plugins o temas muy pesados. Para arreglarlo temporalmente, sube el límite de memoria en el wp-config.php añadiendo:

define( 'WP_MEMORY_LIMIT', '256M' );

4. Headers already sent

Este error aparece cuando hay espacios o líneas en blanco antes de la etiqueta de apertura <?php en algún archivo PHP, o después del cierre ?>. Revisa el archivo que menciona el error y borra cualquier espacio extra al principio o al final.

Consejos para la resolución de problemas

• Si el error menciona un plugin: Desactívalo renombrando la carpeta vía FTP (ponle «-old» al nombre) o desde el panel si puedes entrar.
• Si el error menciona un tema: Activa uno por defecto como Twenty Twenty-Four para ver si el error sigue ahí.
• Limpia el caché: Si usas plugins de caché como W3 Total Cache o WP Rocket, limpia todo después de arreglar el error, podrías estar viendo una versión vieja del sitio.

Conclusión

Saber manejar el wp-config.php para activar la depuración es una habilidad que todo administrador de WordPress debería tener. Transforma esos mensajes de error crípticos en guías claras que te dicen exactamente qué tocar. Aunque el mensaje asuste, la solución suele ser tan simple como corregir una línea de código o desactivar un complemento conflictivo.

Si después de esto los errores siguen ahí o no te sientes cómodo editando archivos del núcleo, recuerda que en RedServicio.net ofrecemos hosting de calidad con soporte técnico especializado 24/7. Nuestro equipo puede ayudarte a leer estos registros y asegurar que tu web funcione sin parones. ¡No dejes que un error de PHP frene tu proyecto!