Ocultar avisos de error PHP en WordPress: guía

Los avisos de error PHP en WordPress son mensajes técnicos que aparecen en el frontend de tu sitio cuando hay conflictos entre plugins, temas o el núcleo de WordPress. En esta guía te mostramos 4 métodos para ocultarlos y te explicamos cuándo vale la pena investigar la causa antes de simplemente apagarlos.

Si gestionas sitios de clientes, considera nuestro curso de mantenimiento y gestión de WordPress donde cubrimos estas situaciones con profundidad.

Tipos de errores PHP en WordPress

No todos los mensajes de error PHP son igual de graves. WordPress puede mostrar varios niveles:

Los Notice y Warning no impiden que el sitio cargue, pero son visibles para tus visitantes y degradan la apariencia del sitio. Los Fatal Error y Parse Error sí detienen la ejecución y pueden dejar el sitio inaccesible. Para estos últimos, ocultar el error no es suficiente — necesitas resolverlo.

¿Por qué es recomendable ocultar los avisos en producción?

Los errores PHP están diseñados para que los desarrolladores puedan depurar problemas. En un sitio en producción (visible para el público), mostrarlos tiene dos consecuencias negativas: empeoran la experiencia del usuario y pueden revelar información técnica de tu sitio (rutas de archivos, versiones de plugins) que facilita ataques de seguridad.

La regla general es: en desarrollo, activa los errores para verlos; en producción, ocúltalos del frontend y lógralos en un archivo.

Método 1: Editar wp-config.php (recomendado)

Este es el método más directo y el que más control te da. Antes de hacerlo, haz una copia de seguridad de tu sitio antes de continuar.

Localiza el archivo wp-config.php en la raíz de tu WordPress (vía FTP, cPanel File Manager o administrador de archivos del hosting). Busca la línea:

define('WP_DEBUG', true);

Y reemplázala por este bloque completo:

ini_set('display_errors', 'Off');
ini_set('error_reporting', E_ALL);
define('WP_DEBUG', false);
define('WP_DEBUG_DISPLAY', false);
define('WP_DEBUG_LOG', true);

La última línea (WP_DEBUG_LOG) hace que los errores se guarden en el archivo wp-content/debug.log en lugar de mostrarse. Así puedes revisarlos cuando necesites diagnosticar algo, sin que los vea el público.

Método 2: Desde el plugin File Manager (sin FTP)

Si no tienes acceso FTP, puedes usar el plugin gratuito WP File Manager directamente desde tu panel de WordPress para localizar y editar el archivo wp-config.php y aplicar el mismo cambio del Método 1.

Método 3: Editar php.ini desde el hosting

Algunos hostings te permiten personalizar la configuración de PHP a nivel de directorio mediante un archivo php.ini. Si tu hosting lo soporta (Hostinger, SiteGround, Kinsta, entre otros), puedes crear o editar el archivo php.ini en la raíz de tu WordPress y agregar:

display_errors = Off
error_reporting = E_ALL & ~E_NOTICE & ~E_DEPRECATED

La ventaja de este método es que la configuración aplica antes de que WordPress cargue, lo que puede ser útil si hay errores PHP muy tempranos en la inicialización que el wp-config.php no alcanza a capturar.

Método 4: Desde el cPanel o hPanel del hosting

En Hostinger (hPanel), puedes controlar la visualización de errores PHP directamente desde el panel sin tocar archivos:

1. Accede a tu hPanel → PHP Configuration (o «Configuración PHP»).
2. Busca la opción display_errors y cambia su valor a Off.
3. Guarda los cambios.

En cPanel clásico, el proceso es similar: busca la sección de MultiPHP INI Editor, selecciona el directorio de tu WordPress y ajusta el valor de display_errors.

¿Tienes un sitio comprometido o quieres prevenir vulnerabilidades? Revisa nuestro curso de seguridad WordPress para aprender a protegerlo desde la raíz.

Cuándo NO deberías solo ocultar el error

Ocultar un error sin investigar su causa es como tapar la luz del check del motor en tu auto. En estos casos es obligatorio investigar:

• Fatal Error o pantalla blanca (WSOD): el sitio no carga. Debes identificar el plugin o tema que lo causa desactivando en orden.
• Error repetitivo de deprecated function en un plugin crítico: puede indicar que el plugin ya no es compatible con la versión de PHP que usas. Actualizar PHP sin actualizar el plugin puede romper el sitio.
• Warning de «Cannot modify header information»: suele haber un espacio o BOM en el inicio de un archivo PHP. Es fácil de resolver una vez identificado el archivo.
• Notice de «Undefined variable» en tus propios archivos: si desarrollas plugins o temas, esto es una deuda técnica real que deberías corregir.

Cómo activar los errores para diagnosticar

Cuando necesitas ver los errores (en un entorno de desarrollo o staging), aplica el proceso inverso en wp-config.php:

define('WP_DEBUG', true);
define('WP_DEBUG_DISPLAY', true);
define('WP_DEBUG_LOG', false);

Para identificar qué plugin genera el error, desactiva los plugins de uno en uno desde el menú de administración y recarga la página después de cada desactivación hasta que el error desaparezca. Si no puedes acceder al admin, renombra la carpeta del plugin sospechoso vía FTP (por ejemplo, de plugin-x a plugin-x-disabled) para desactivarlo temporalmente.

Errores PHP y seguridad

Mostrar errores en producción expone información técnica valiosa para un atacante: rutas absolutas de archivos, nombres de tablas de la base de datos, versiones de plugins. Un aviso PHP típico puede revelar algo como:

Warning: file_get_contents(/home/usuario/dominios/miweb.com/public_html/wp-content/plugins/plugin-x/archivo.php): failed to open stream

Esa ruta exacta le dice a cualquiera dónde están tus archivos en el servidor. Por eso, independientemente de si el error es grave o no, mantener display_errors = Off en producción es una medida básica de seguridad.

Preguntas frecuentes sobre errores PHP en WordPress

¿El archivo debug.log crece sin límite?

Sí, si WP_DEBUG_LOG está activo y hay muchos errores, el archivo puede crecer rápidamente. Revísalo periódicamente y bórralo o rótalo. En sitios con mucho tráfico, considera desactivar el log en producción y solo activarlo en staging cuando necesites depurar.

¿Los avisos PHP afectan el SEO?

Indirectamente, sí. Si los errores aparecen en el HTML de la página, Google los puede ver y en casos extremos pueden romper el parseo del HTML. Además, un aviso que aparece antes de la respuesta HTTP puede generar errores de cabeceras ya enviadas, lo que afecta el funcionamiento de plugins y cachés.

¿Qué versión de PHP debo usar en WordPress?

WordPress recomienda PHP 8.1 o superior. PHP 8.x es más estricto con los avisos y warnings que PHP 7.x, por lo que al actualizar PHP puedes ver errores que antes no aparecían. Antes de actualizar PHP en producción, prueba siempre en un entorno de staging.

¿Por qué sigo viendo errores aunque cambié wp-config.php?

Puede haber una configuración de PHP a nivel de servidor que sobreescribe los valores de wp-config.php. En ese caso, el método más efectivo es editar el php.ini directamente desde el panel de tu hosting (Métodos 3 o 4 de esta guía).

Conclusión

Ocultar los avisos de error PHP en WordPress es una tarea de mantenimiento básica para cualquier sitio en producción. El método más recomendado es editar wp-config.php para desactivar la visualización pero mantener el log activo. Así mantienes el sitio limpio para los visitantes y conservas la capacidad de diagnosticar cuando necesites. Recuerda siempre hacer una copia de seguridad antes de editar cualquier archivo de configuración, y no te saltes el paso de investigar cuando el error es un Fatal Error o afecta el funcionamiento del sitio.

¿Quieres saber más sobre el mantenimiento profesional de sitios WordPress? Consulta nuestra guía de errores comunes de WordPress o accede a los tutoriales premium de UXDivi.