En este artículo te explicamos cómo puedes activar la visualización de errores para las versiones de PHP a partir de la versión PHP 8.0.

Al habilitar la visualización de errores, los mensajes de error que se producen durante la ejecución del código del programa se muestran directamente en tu página web. Esto te permite diagnosticar problemas cuando solamente se muestra una página en blanco o incompleta.

Importante

Por razones de seguridad, te recomendamos que no actives permanentemente los mensajes de error en un entorno de producción. Estos podrían mostrar información sensible que sea útil para potenciales atacantes. Sin embargo, en fases de desarrollo o para el diagnóstico de problemas agudos, puede ser práctico mostrar temporalmente los mensajes de error.

Si quieres realizar diagnósticos de error durante un período de tiempo más largo, activa el registro de errores en su lugar.

Habilitar los mensajes de error

Para activar la visualización de mensajes de error en PHP para tu página web, añade un archivo con el nombre .user.ini en el directorio raíz de tu página web con el siguiente contenido:

display_errors=En
display_startup_errors=En
error_reporting=E_ALL

Si no deseas que se muestren todos los tipos de error, puedes cambiar la configuración ajustando la línea error_reporting=E_ALL. El procedimiento se describe a continuación.

Personalizar la visualización de errores

PHP distingue entre diferentes tipos de error. Además de los errores críticos (fatal error)  que conducen a la cancelación del script, también existen tipos de error menos graves como los avisos (notice) o advertencias (warning). Puedes especificar qué tipos de error se muestran usando la directiva error_reporting.

En la siguiente tabla figuran algunos ejemplos de configuración:

DIRECTIVA DE CONFIGURACIÓN DESCRIPCIÓN  
error_reporting = E_ALL Se muestran todos los tipos de mensajes de error. Esta orden también se utilizó anteriormente en «Mostrar instrucciones paso a paso».  
error_reporting = E_ERROR Solamente se muestran los errores de ejecución críticos (fatal errors). Estos son aquellos errores que no se pueden rectificar. Por ejemplo, problemas con la asignación de memoria. Si se produce un error de este tipo, se cancela la ejecución del script.  
error_reporting = E_ERROR E_WARNING En este ejemplo, se muestran errores de ejecución críticos y advertencias. Las advertencias en PHP (warnings) son mensajes que indican que ha ocurrido un problema durante la ejecución de un script. A diferencia de los errores críticos, que cancelan la ejecución de un script, las advertencias no provocan la cancelación del script. A pesar de la advertencia, el script se ejecuta hasta el final. Las advertencias suelen indicar problemas no críticos que deben rectificarse pero que no afectan inmediatamente a la funcionalidad del programa.

Si se configura más de un tipo de error, estos deben enumerarse por separado mediante una barra vertical  | (bitwise OR). Por ejemplo: error_reporting = E_ERROR | E_WARNING

Puedes encontrar un resumen de las constantes predefinidas para su uso con «error _reporting» aquí: https: //www.php.net/manual/es/errorfunc.constants.php

Más información