Mostrar errores PHP para detectar y solucionar

Por Felipe

Publicado en:

Para mostrar los errores de PHP puedes activar la directiva display_errors en la configuración del servidor, agregar unas líneas de código a una página concreta o, si usas WordPress, habilitar el modo de depuración WP_DEBUG en el archivo wp-config.php. Así detectas y solucionas los fallos que afectan el rendimiento y la seguridad de tu sitio.

¿Por qué conviene mostrar los errores de PHP?

El desarrollo web es una disciplina en la que se utilizan diversos lenguajes de programación, siendo los más habituales JavaScript y PHP, junto al lenguaje de marcado HTML y las hojas de estilo CSS. Cuando se escribe código es normal que aparezcan errores que pueden pasar desapercibidos para el programador si no se muestran en tiempo de ejecución, algo que ocurre por defecto en PHP.

Mostrar los errores de PHP es una opción muy interesante para detectar esos problemas que deben resolverse y que, de lo contrario, pueden permanecer ocultos durante mucho tiempo, disminuyendo el rendimiento y la seguridad de tu sitio web. Activar esta función durante el desarrollo o el mantenimiento te permite encontrar la raíz de las fallas con rapidez y corregirlas antes de que afecten a tus visitantes.

Ventajas (y un riesgo) de mostrar errores PHP

En PHP, no mostrar los errores resulta muy cómodo porque evita los continuos avisos o warnings que pueden volverse molestos. Sin embargo, esa comodidad tiene un precio: los problemas quedan escondidos y pueden ir acumulándose. La gran ventaja de activar la visualización de errores es que dispones siempre de información actualizada sobre cuántos errores hay y dónde se encuentran, lo que facilita enormemente el mantenimiento.

El riesgo que debes tener presente es que, cuando se activa la opción de mostrar errores, tanto los desarrolladores como los usuarios pueden ver esos mensajes. Por eso es fundamental usar esta función de manera temporal, idealmente en un entorno de pruebas, y desactivarla en producción para no arruinar la experiencia de usuario ni exponer información sensible.

Cómo mostrar errores PHP paso a paso

1. Activar display_errors en el servidor

La forma más general es habilitar la directiva display_errors en la configuración de PHP (por ejemplo, en el archivo php.ini). Al activarla, se mostrará en todas las URLs de la web un mensaje con los errores detectados. Es la opción ideal cuando quieres revisar el sitio completo durante una etapa de desarrollo.

2. Mostrar errores solo en una página

Si prefieres activar el aviso de errores únicamente en una URL determinada, puedes añadir el siguiente código PHP a la cabecera de esa página:

ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);

Con esto evitas que los errores de PHP se muestren en todas las páginas de la web y limitas su aparición solo a las URLs donde agregues este código, lo que te da un control mucho más fino durante la depuración.

3. Mostrar errores PHP en WordPress

WordPress es un CMS programado en PHP que oculta los errores por defecto. Como al instalar plugins y agregar código suelen surgir errores, conviene mostrarlos para solucionarlos cuanto antes y garantizar el rendimiento y la seguridad de la web. Para activar la depuración necesitas editar el archivo wp-config.php, que se encuentra en la raíz de los archivos de la plataforma en el servidor, y añadir la línea:

define('WP_DEBUG', true);

Recuerda hacer una copia de seguridad del archivo antes de modificarlo y volver a poner el valor en falso cuando termines de depurar.

Niveles de error_reporting en PHP

La función error_reporting permite indicar qué tipos de errores quieres ver. Estos son los niveles disponibles, cada uno con su código correspondiente: E_ERROR, E_WARNING, E_PARSE, E_NOTICE, E_CORE_ERROR, E_CORE_WARNING, E_COMPILE_ERROR, E_COMPILE_WARNING, E_USER_ERROR, E_USER_WARNING, E_USER_NOTICE, E_ALL, E_STRICT y E_RECOVERABLE_ERROR. Usar E_ALL es lo más recomendable durante el desarrollo, porque muestra absolutamente todos los avisos y te ayuda a escribir un código más limpio y robusto.

Buenas prácticas, rendimiento y hosting

El manejo de errores en PHP es mucho más sencillo cuando activas la opción de mostrarlos, ya que dispondrás siempre de información actualizada sobre la cantidad de errores y su ubicación. Eso sí, mantén esta función como una herramienta temporal: actívala para diagnosticar, corrige los fallos y vuelve a ocultarla en producción.

Gran parte de la facilidad para depurar también depende de tu proveedor de alojamiento. Un buen hosting te da acceso a los registros de errores (logs), a la gestión de versiones de PHP y a un soporte que puede orientarte cuando algo falla. HostingPlus, con trayectoria desde 2004, ofrece soporte técnico 24/7, discos SSD/NVMe y tecnología LiteSpeed para que tu sitio se mantenga rápido y estable mientras desarrollas y das mantenimiento, además de migración y certificado SSL incluidos.

Conclusión

Mostrar los errores de PHP es una práctica imprescindible para cualquier persona que desarrolle o administre un sitio web. Te permite detectar problemas ocultos, mejorar el rendimiento y reforzar la seguridad. Ya sea activando display_errors, agregando código a una página puntual o habilitando WP_DEBUG en WordPress, la clave está en usar estas herramientas de forma temporal y responsable, y apoyarte en un hosting confiable que te facilite el trabajo.

Preguntas frecuentes

¿Es seguro mostrar los errores de PHP en un sitio en producción?

No es recomendable. Cuando los errores están visibles, tanto desarrolladores como usuarios pueden verlos, y eso puede exponer información sensible y afectar la experiencia de usuario. Lo ideal es activar la visualización solo de forma temporal o en un entorno de pruebas, y desactivarla en producción.

¿Cómo activo la depuración de errores en WordPress?

Debes editar el archivo wp-config.php que está en la raíz de tu instalación y agregar la línea define(‘WP_DEBUG’, true);. Al terminar de depurar, vuelve a poner el valor en false. Haz siempre una copia de seguridad del archivo antes de modificarlo.

¿El hosting influye en la gestión de errores PHP?

Sí. Un buen hosting te permite acceder a los logs de errores, elegir la versión de PHP y contar con soporte técnico que te ayude a resolver incidencias. En HostingPlus tienes soporte 24/7, SSD/NVMe y LiteSpeed. Para conocer los planes y precios en soles, escribe al equipo o llama al (01) 640 9409.

¿Tu web necesita el hosting N°1 del Perú?

Hosting peruano con soporte real 24/7, migración gratis, SSL incluido y 30 días de garantía. Desde S/.70 al año.

Ver planes de hosting →