Cómo solucionar el error 500 en PrestaShop con DirectAdmin

¿Qué significa el error 500 en PrestaShop y por qué aparece en DirectAdmin?

Cuando visitas tu tienda online y ves un mensaje que dice "500 Internal Server Error", es normal que sientas un poco de pánico. Pero respira, porque este error es uno de los más comunes en el mundo del hosting y, en la mayoría de los casos, tiene solución en pocos minutos.

El error 500 en PrestaShop con DirectAdmin indica que el servidor encontró un problema inesperado que le impide cargar tu página. A diferencia de un error 404 (que significa "página no encontrada"), el 500 es un error genérico del servidor. Es decir, el servidor sabe que algo falla, pero no te dice exactamente qué es. Por eso, la solución requiere un proceso de investigación paso a paso.

En este artículo, te voy a guiar por todas las causas más frecuentes y sus soluciones, pensadas especialmente para usuarios que trabajan con el panel de control DirectAdmin. No necesitas ser un experto en programación: solo sigue las instrucciones con calma.

Primeros pasos: identifica si el error afecta a todo tu sitio o solo a una parte

Antes de lanzarte a modificar archivos, haz una prueba rápida. Esto te ahorrará mucho tiempo.

Prueba con la tienda en modo mantenimiento

Accede a tu panel de DirectAdmin.
Ve a la sección de Administrador de archivos (File Manager).
Busca la carpeta raíz de tu PrestaShop (normalmente es public_html o una subcarpeta como public_html/tienda).
Dentro, localiza el archivo llamado .htaccess. Si no lo ves, activa la opción de "mostrar archivos ocultos".
Descarga una copia de seguridad de ese archivo a tu ordenador. Esto es importante por si necesitas restaurarlo.
Ahora, renombra el archivo .htaccess a .htaccess.bak. Esto lo desactiva temporalmente.
Intenta cargar tu tienda de nuevo.

Si con esto el error desaparece, el problema está en el archivo .htaccess. Si el error persiste, continúa con el siguiente paso.

[TIP] El archivo .htaccess controla reglas de redirección, seguridad y caché en PrestaShop. Si se corrompe o tiene reglas incompatibles con tu versión de PHP, provoca el temido error 500.

Causa principal: la versión de PHP no es compatible con tu PrestaShop

Esta es, con diferencia, la causa más común del error 500 prestashop directadmin. PrestaShop es muy sensible a la versión de PHP que usa tu servidor. Si tu tienda fue creada con PHP 7.4 y ahora el servidor usa PHP 8.2, es muy probable que aparezca el error.

Cómo cambiar la versión de PHP en DirectAdmin

Inicia sesión en tu panel de DirectAdmin.
Busca la sección "PHP Version Selector" o "Selector de versión de PHP". En algunos planes, esta opción está dentro de "Configuración de dominio".
Selecciona tu dominio (el que usa PrestaShop).
Verás un menú desplegable con varias versiones de PHP.
Si tu PrestaShop es anterior a la versión 8, elige PHP 7.4 (la más estable para tiendas antiguas).
Si tu PrestaShop es la versión 8.x, puedes probar con PHP 8.1 o 8.2.
Guarda los cambios y espera unos segundos.

[WARNING] Si cambias la versión de PHP, algunas extensiones de tu hosting podrían dejar de funcionar. Si después del cambio ves otros errores, vuelve a la versión anterior.

¿Cómo saber qué versión de PHP necesita tu PrestaShop?

La forma más fácil es mirar la versión que tenías antes de que apareciera el error. Si no la recuerdas, prueba con PHP 7.4 primero, ya que es la versión más compatible con PrestaShop 1.7 y versiones anteriores.

El clásico problema de permisos: archivos y carpetas con permisos incorrectos

Otra causa muy frecuente del prestashop error 500 son los permisos de archivos. Si algún archivo o carpeta tiene permisos demasiado restrictivos o demasiado abiertos, el servidor no puede leerlos correctamente.

Permisos recomendados para PrestaShop

Carpetas: deben tener permisos 755.
Archivos: deben tener permisos 644.
El archivo config/settings.inc.php (en PrestaShop 1.6) o app/config/parameters.php (en PrestaShop 1.7+): debe tener permisos 444 o 644.

Cómo corregir permisos desde DirectAdmin

Ve al Administrador de archivos.
Selecciona la carpeta raíz de tu tienda.
Marca la casilla de seleccionar todo (Ctrl+A o Cmd+A).
En la barra superior, verás un botón que dice "Cambiar permisos".
Introduce 755 para carpetas y 644 para archivos.
Aplica los cambios.

[INFO] Si tienes muchos archivos, este proceso puede tardar unos minutos. No cierres la pestaña del navegador hasta que termine.

La caché de PrestaShop: un enemigo silencioso

La caché de PrestaShop es un sistema que guarda versiones "pre-cocinadas" de tus páginas para que carguen más rápido. Pero a veces, esa caché se corrompe y provoca el error 500.

Cómo limpiar la caché manualmente

Accede a tu DirectAdmin y abre el Administrador de archivos.
Ve a la carpeta var/cache (en PrestaShop 1.7+) o cache (en versiones anteriores).
Dentro, verás carpetas como dev, prod o class_index.php.
Borra todo el contenido de la carpeta cache o var/cache. No borres la carpeta en sí, solo su interior.
Vuelve a cargar tu tienda.

[WARNING] Si usas un módulo de caché como Memcached o APC, también deberás desactivarlo temporalmente desde el archivo de configuración. Si no sabes cómo, contacta con tu proveedor de hosting.

El archivo de configuración de la base de datos: un error común

PrestaShop necesita conectarse a una base de datos MySQL para funcionar. Si los datos de conexión son incorrectos, o si la base de datos está llena o caída, obtendrás un error 500.

Revisa la conexión a la base de datos

En el Administrador de archivos, busca el archivo app/config/parameters.php (PrestaShop 1.7+) o config/settings.inc.php (PrestaShop 1.6).
Ábrelo con el editor de texto de DirectAdmin.
Verifica que los valores de database_host, database_name, database_user y database_password sean correctos.
Si no estás seguro, ve a DirectAdmin > MySQL Management y comprueba que la base de datos existe y que el usuario tiene permisos.

[TIP] Si cambiaste la contraseña de la base de datos recientemente, este es el primer lugar donde debes actualizarla.

Módulos incompatibles: el culpable silencioso

A veces, un módulo de PrestaShop (como un plugin de pago, envío o SEO) es incompatible con la versión de PHP o con otros módulos. Esto puede causar un conflicto fatal que provoque el error 500.

Cómo identificar si un módulo es el problema

Accede a tu DirectAdmin.
Ve al Administrador de archivos.
Navega a la carpeta modules dentro de tu instalación de PrestaShop.
Localiza la carpeta del módulo que instalaste recientemente (justo antes de que apareciera el error).
Renombra esa carpeta añadiendo _backup al final. Por ejemplo, ps_banner pasa a ser ps_banner_backup.
Intenta cargar tu tienda.

Si el error desaparece, ya sabes cuál es el módulo problemático. Puedes reinstalarlo desde el panel de administración de PrestaShop, o buscar una versión actualizada.

[WARNING] No renombres todos los módulos a la vez. Hazlo de uno en uno para identificar al culpable.

Error de memoria: el límite de memoria PHP

PrestaShop es una plataforma que consume bastante memoria, especialmente si tienes muchos módulos o un catálogo grande. Si el servidor tiene un límite de memoria bajo, el error 500 aparecerá en momentos de alta demanda.

Cómo aumentar el límite de memoria

Busca el archivo php.ini en tu DirectAdmin. Si no existe, puedes crearlo en la carpeta raíz.
Dentro, añade o modifica esta línea:

memory_limit = 256M

Guarda el archivo y sube los cambios.
Si no puedes modificar php.ini, intenta añadir esta línea al archivo .htaccess:

php_value memory_limit 256M

[INFO] Si tu plan de hosting no te permite modificar php.ini, contacta con tu proveedor y pide que aumenten el límite de memoria a al menos 256 MB.

El error 500 en PrestaShop con DirectAdmin: soluciones avanzadas

Si has probado todo lo anterior y el error persiste, es hora de mirar los registros del servidor. No te asustes, es más fácil de lo que parece.

Cómo ver los registros de error en DirectAdmin

En tu panel de DirectAdmin, busca la sección "Error Logs" o "Registros de errores".
Selecciona tu dominio.
Verás un listado de errores con fechas y horas.
Busca los errores que coincidan con el momento en que aparece el error 500.
Fíjate en mensajes como "PHP Fatal error" o "Allowed memory size exhausted". Esos te darán pistas exactas.

[TIP] Copia el texto del error y búscalo en Google. Seguramente encontrarás la solución exacta en foros de PrestaShop.

Preguntas frecuentes (FAQ) sobre el error 500 en PrestaShop

¿Por qué mi tienda da error 500 solo en algunos productos?

Esto suele indicar un problema con las imágenes o con los atributos de ese producto concreto. Prueba a desactivar el producto y reactivarlo, o regenera las miniaturas desde Catálogo > Productos > Regenerar miniaturas.

¿El error 500 puede deberse a un ataque de hackers?

Sí, es posible. Si tu tienda fue hackeada, los archivos modificados pueden provocar errores. Revisa los archivos con fecha de modificación reciente y usa un escáner de malware.

¿Cuánto tiempo se tarda en solucionar el error 500?

Depende de la causa. Si es por la versión de PHP, lo resuelves en 5 minutos. Si es por un módulo, puede llevar 30 minutos. En casos extremos, si es un problema del servidor, tendrás que contactar con tu proveedor.

¿Qué hago si nada de esto funciona?

Si has probado todos los pasos y el directadmin prestashop error continúa, es hora de contactar con el soporte técnico de tu hosting. Dales toda la información: qué pasos has seguido, qué versión de PHP usas, y los mensajes de error de los logs. Ellos podrán acceder a los registros del servidor a un nivel más profundo.

Resumen: tu checklist para solucionar el error 500

Aquí tienes un resumen rápido de los pasos que debes seguir en orden:

Renombra el archivo .htaccess para descartar problemas de configuración.
Cambia la versión de PHP desde DirectAdmin.
Corrige los permisos de archivos y carpetas.
Limpia la caché de PrestaShop.
Verifica la conexión con la base de datos.
Desactiva módulos recientes renombrando sus carpetas.
Aumenta el límite de memoria PHP.
Revisa los logs de error para obtener pistas exactas.

[WARNING] No hagas varios cambios a la vez. Haz una prueba después de cada paso para saber cuál era el problema. Así, si el error reaparece en el futuro, sabrás exactamente qué hacer.

Conclusión: el error 500 no es el fin del mundo

El error 500 prestashop directadmin puede parecer aterrador, pero con este artículo tienes todas las herramientas para enfrentarlo. La clave está en ir paso a paso, sin prisas y sin hacer cambios drásticos sin entender qué estás haciendo.

Recuerda que siempre es buena idea tener una copia de seguridad reciente de tu tienda. Si algo sale mal durante el proceso, podrás restaurarla en minutos.

Si después de seguir todos estos pasos el problema persiste, no dudes en contactar con el soporte de tu hosting. Ellos tienen acceso a herramientas más avanzadas y podrán diagnosticar el problema en profundidad.

Tu tienda online volverá a estar operativa en poco tiempo. ¡Mucho ánimo y manos a la obra!