En este artículo te mostramos cómo activar Display Errors en WHMCS.
WHMCS incluye diversas herramientas de diagnóstico pensadas para ayudarte a identificar y resolver incidencias. Una de las más útiles es Display Errors, que permite mostrar información detallada cuando ocurre un error crítico, facilitando el análisis del problema y agilizando su resolución.
Esta opción es especialmente recomendable durante procesos de depuración, pruebas o cuando necesitas obtener más contexto técnico para soporte.
¿Cuándo debería habilitar el Display Errors?
LaLa opción Display Errors es especialmente útil cuando se presenta un error crítico que provoca alguno de los siguientes comportamientos:
- Aparición del mensaje “¡Oops!”
- Páginas completamente en blanco
- Páginas cargadas de forma parcial o incompleta
En estos escenarios, habilitar Display Errors te permitirá ver mensajes técnicos adicionales que ayudan a identificar la causa del problema (por ejemplo, errores de PHP, archivos faltantes o fallos de ejecución).
Aunque Display Errors es una herramienta muy valiosa para diagnóstico, muestra información técnica sensible a cualquier persona que visite tu sistema. Por esta razón, debe utilizarse únicamente de forma temporal mientras investigas un problema, evitando mantenerla activada en entornos de producción y desactivándola inmediatamente una vez identificado el error.
Ten en cuenta que dejar esta opción habilitada puede exponer rutas internas, configuraciones del servidor y otros detalles técnicos que no deberían ser visibles para terceros, lo cual representa un riesgo de seguridad.
Habilitación de informes de errores (Display Error) en WHMCS
Existen dos formas de activar Display Errors, dependiendo de si aún puedes acceder al área administrativa o no.
1. Habilitación desde el área de administración
Si todavía puedes ingresar al panel administrativo, sigue estos pasos para activar temporalmente la visualización de errores. Una vez habilitado, vuelve a reproducir la acción que te llevaba a la página en blanco o parcialmente cargada; el sistema mostrará información adicional del error.
- Dirígete a:
- Configuración > Configuración del sistema > Configuración general > Otro (En versiones anteriores a WHMCS 8.0: Configuración > Configuración general > Otro)
- Marca la casilla Display Errors, ubicada al final de la página.
- Haz clic en Guardar cambios.
Después de esto, intenta nuevamente acceder a la página que estaba fallando para ver los mensajes técnicos generados.
Recuerda desactivar Display Errors una vez que hayas identificado el problema. Mantener esta opción activa puede representar un riesgo de seguridad.
2. Habilitación desde el archivo de configuración
Si el error es lo suficientemente grave como para impedir el acceso al área administrativa, puedes activar Display Errors manualmente desde el archivo configuration.php, ubicado en el directorio raíz de WHMCS.
Sigue estos pasos:
- Abre el archivo
configuration.php. - Agrega la siguiente línea justo antes del cierre
?>(si existe).
Si el archivo no tiene cierre PHP, simplemente colócala al final:
$display_errors = true;- Guarda los cambios.
Una vez hecho esto, vuelve a intentar los pasos que generaban el error. El sistema ahora mostrará información técnica adicional que te ayudará a identificar la causa.
Desactiva esta opción inmediatamente después de finalizar el diagnóstico. Dejar la visualización de errores habilitada puede exponer rutas internas, configuraciones del servidor u otros detalles sensibles.