Activar modo debug en PrestaShop | Ver errores de la tienda

¿Te ha aparecido una pantalla blanca en tu tienda PrestaShop y no sabes qué hacer? ¿O quizás necesitas ver un error concreto que no se muestra en pantalla? Es muy probable que necesites activar el modo depuración (debug mode). Este es uno de los primeros pasos que cualquier técnico o desarrollador realiza para diagnosticar problemas, y hoy te voy a enseñar a hacerlo tú mismo, paso a paso y sin necesidad de ser un experto en programación.

Activar el debug prestashop no solo te mostrará los errores ocultos, sino que también te dará pistas claras sobre qué archivo o módulo está fallando. Es como encender una linterna en una habitación oscura: de repente, todo se ve. Pero cuidado, también implica ciertos riesgos de seguridad si lo dejas activado en una tienda en producción. Por eso, al final de esta guía te explicaré cómo desactivarlo correctamente.

Vamos a ello.

¿Qué es el modo depuración de PrestaShop y para qué sirve?

El modo depuracion prestashop (también conocido como debug mode) es una funcionalidad interna que permite a la plataforma mostrar los errores detallados del sistema en lugar de ocultarlos. Cuando tu tienda tiene un problema (como un módulo incompatible o un error de sintaxis en un archivo), PrestaShop normalmente muestra una pantalla en blanco o un mensaje genérico de "error 500". Esto es frustrante porque no te dice nada.

Al activar el modo depuración, PrestaShop mostrará:

El mensaje de error exacto (por ejemplo, "Fatal error: Call to undefined function").
La línea exacta del archivo donde ocurre el problema.
La ruta completa del archivo afectado.
Un stack trace (seguimiento de la pila) que muestra la secuencia de llamadas que llevaron al error.

Esto es oro puro para solucionar errores prestashop de forma rápida, ya que te indica exactamente dónde mirar. Además, también es útil para desarrollar nuevas funcionalidades o personalizar tu tienda, porque te permite ver avisos (warnings) y notificaciones que normalmente están ocultas.

Método 1: Activar el modo depuración desde el archivo `config/defines.inc.php` (El método clásico)

Este es el método más directo y funciona en todas las versiones de PrestaShop (desde la 1.5 hasta la 8.x). Solo necesitas acceso a tu panel de control de hosting o a un gestor de archivos como Syspanel. Recuerda que Syspanel es la herramienta de gestión de tu hosting y el puerto de acceso es el 2106.

Paso 1: Accede a tus archivos

Primero, entra en tu panel de control de hosting (Syspanel) y busca el administrador de archivos (File Manager). También puedes usar un cliente FTP como FileZilla, pero con Syspanel es más rápido porque no necesitas configurar nada.

Paso 2: Localiza el archivo `defines.inc.php`

Una vez dentro del administrador de archivos, navega hasta la carpeta raíz de tu instalación de PrestaShop. Normalmente se llama public_html, www o el nombre de tu dominio. Dentro, busca la carpeta config y ábrela. Dentro de config, encontrarás un archivo llamado defines.inc.php. Haz clic derecho sobre él y selecciona "Editar" o "Edit".

Paso 3: Cambia el valor de `_PS_MODE_DEV_`

Dentro del archivo, busca la siguiente línea de código (puedes usar la función de búsqueda de tu editor, normalmente Ctrl+F o Cmd+F):

define('_PS_MODE_DEV_', false);

Verás que está en false. Cámbialo a true:

define('_PS_MODE_DEV_', true);

Guarda el archivo (Ctrl+S o el botón de guardar del editor) y listo. Ya has activado el modo depuración.

[TIP] Si el archivo no te deja guardar, puede que tengas permisos de solo lectura. Cambia los permisos a 755 o 644 temporalmente, guarda y luego vuelve a cambiarlos a 444 para mayor seguridad.

Paso 4: Comprueba que funciona

Ahora ve a tu tienda en el navegador. Si había un error, verás el detalle en pantalla. Si no hay ningún error, no verás nada diferente, pero los avisos (warnings) se mostrarán en la parte inferior de la página si los hay.

Método 2: Activar el modo depuración desde el archivo `.htaccess` (Para servidores Apache)

Si por alguna razón no puedes editar el archivo defines.inc.php (por ejemplo, porque tu hosting lo bloquea), puedes usar el archivo .htaccess. Este método es un poco más avanzado, pero igual de efectivo.

Paso 1: Localiza el archivo `.htaccess`

En la raíz de tu instalación de PrestaShop, busca un archivo llamado .htaccess. Ten en cuenta que este archivo está oculto, así que en tu administrador de archivos de Syspanel deberás activar la opción "Mostrar archivos ocultos" (suele ser un botón o un checkbox en la parte superior).

Paso 2: Añade las líneas de configuración

Abre el archivo .htaccess y, al principio del todo (después de la línea # ~~~start... si es que existe), añade las siguientes líneas:

php_flag display_errors on
php_value error_reporting E_ALL

Guarda el archivo. Esto hará que PHP muestre todos los errores, incluso sin tocar el archivo de definiciones.

[WARNING] Este método es menos recomendado que el primero, porque también mostrará errores de otros scripts que no sean de PrestaShop. Úsalo solo si no tienes otra opción.

Método 3: Activar el modo depuración desde el Back Office (Solo PrestaShop 1.7.6 o superior)

En las versiones más recientes de PrestaShop (1.7.6 en adelante), existe una opción nativa en el panel de administración. Esto es mucho más cómodo, ya que no necesitas tocar ningún archivo.

Paso 1: Ve a Parámetros avanzados

Entra en tu Back Office de PrestaShop (tuadmin). En el menú lateral izquierdo, busca la sección Parámetros avanzados (Advanced Parameters) y haz clic en Rendimiento (Performance).

Paso 2: Configura el modo depuración

Dentro de la página de Rendimiento, baja hasta encontrar el apartado Modo de depuración (Debug mode). Verás un selector con varias opciones:

Desactivado (Disabled): Es el estado normal.
Activar modo de depuración de PHP (Enable PHP debug mode): Muestra errores de PHP.
Activar modo de depuración de Smarty (Enable Smarty debug mode): Muestra errores de plantillas.

Selecciona la primera opción (Activar modo de depuración de PHP) y haz clic en Guardar (Save).

[INFO] El modo de depuración de Smarty es útil solo si estás desarrollando plantillas o temas. Para errores generales de la tienda, el de PHP es suficiente.

Paso 3: Verifica los cambios

Navega a tu tienda y comprueba si los errores ahora se muestran. Si no ves nada, puede que necesites limpiar la caché desde el mismo panel (botón "Vaciar caché" en la parte superior derecha del Back Office).

¿Cómo desactivar el modo depuración cuando termines?

Es crucial que desactives el debug prestashop una vez que hayas resuelto el problema. Dejarlo activado en una tienda en producción es un riesgo de seguridad importante, porque cualquier visitante podría ver rutas internas de tu servidor, nombres de archivos y detalles técnicos que facilitan los ataques.

Para desactivarlo (Método 1 y 2)

Simplemente repite los pasos y cambia true por false en el archivo defines.inc.php, o elimina las líneas que añadiste en el .htaccess.

Para desactivarlo (Método 3)

Ve de nuevo a Parámetros avanzados > Rendimiento, selecciona "Desactivado" en el selector de modo depuración y guarda.

Consejos extra y errores comunes

No veo errores después de activarlo

Si activaste el modo depuración y sigues viendo una pantalla en blanco, puede que el error sea fatal de PHP y no se muestre por pantalla. En ese caso, revisa los logs del servidor. En Syspanel, busca la sección de "Registros" o "Logs" (normalmente en la parte de gestión de dominios o sitios web). Allí verás los errores de PHP con más detalle.

Errores de memoria

Un error muy común es el de "Allowed memory size exhausted". Esto significa que tu servidor no tiene suficiente memoria para ejecutar un script. Puedes aumentar el límite temporalmente añadiendo esta línea al .htaccess:

php_value memory_limit 512M

Pero recuerda: esto es un parche, no una solución definitiva. Deberías optimizar el código o aumentar la memoria en la configuración de PHP de tu hosting.

El modo depuración no se activa

Si cambiaste el archivo defines.inc.php y no funciona, asegúrate de que estás editando el archivo correcto. A veces hay varios archivos defines.inc.php (por ejemplo, en /config y en /install). Debes editar el de la carpeta config. También verifica que no haya caché de PrestaShop o de tu navegador impidiendo ver los cambios.

Consulta tu hosting

Si tienes dudas sobre dónde están tus archivos o cómo acceder a los logs, contacta con el soporte de tu hosting. Si usas Syspanel, ellos te pueden guiar. Recuerda que el puerto de acceso a Syspanel es el 2106.

Preguntas frecuentes (FAQ) sobre el modo depuración

¿Es seguro activar el modo depuración en una tienda en producción?

No, no es seguro. Si lo activas, cualquier persona que visite tu tienda podría ver información sensible sobre tu servidor. Es una práctica común activarlo temporalmente para solucionar un error y desactivarlo inmediatamente después.

¿El modo depuración afecta al rendimiento de mi tienda?

Sí, ligeramente. Mostrar errores en pantalla consume más recursos. El impacto es mínimo si solo lo tienes activado unos minutos, pero no lo dejes activado permanentemente.

¿Qué diferencia hay entre `_PS_MODE_DEV_` y `_PS_MODE_DEV_DEBUG_`?

_PS_MODE_DEV_ es el principal y controla si se muestran errores. _PS_MODE_DEV_DEBUG_ (que es una constante adicional en versiones más recientes) permite un nivel de detalle aún mayor, mostrando incluso variables y datos internos. No necesitas tocar esta última para la mayoría de los casos.

¿Puedo activar el modo depuración desde el archivo `config/settings.inc.php`?

No, esa es una confusión común. El archivo settings.inc.php contiene la configuración de la base de datos y no debe modificarse para esto. El archivo correcto es config/defines.inc.php.

¿Qué hago si el error que veo es muy técnico y no lo entiendo?

No te preocupes. Copia el mensaje de error completo y búscalo en Google o en los foros de PrestaShop. Seguramente alguien más ha tenido el mismo problema. También puedes contactar con un desarrollador o con el soporte técnico de tu hosting, proporcionándoles el mensaje de error y el stack trace.

Conclusión

Activar el modo depuracion prestashop es una habilidad básica pero indispensable para cualquier persona que gestione una tienda online con esta plataforma. Te permite pasar de una pantalla en blanco frustrante a una solución clara y rápida. Ya sea editando el archivo defines.inc.php, usando .htaccess o la opción del Back Office, ahora tienes las herramientas para hacerlo tú mismo.

Recuerda siempre la regla de oro: actívalo, resuelve el problema y desactívalo inmediatamente. No lo dejes encendido más tiempo del necesario. Y si en algún momento te sientes perdido, no dudes en pedir ayuda a tu hosting o a un profesional. La comunidad de PrestaShop es muy amplia y siempre hay alguien dispuesto a echar una mano.

Ahora ya sabes cómo encender la linterna. ¡A resolver esos errores prestashop!