Error 500 en PrestaShop con DirectAdmin: Solución definitiva

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

El error 500 es uno de los mensajes de error más frustrantes que puedes encontrar en tu tienda PrestaShop. Cuando aparece, verás una página en blanco o un mensaje que dice "Error interno del servidor". En el mundo del hosting, este error significa que algo ha fallado en el servidor, pero no te dice exactamente qué ha sido. Es como cuando tu coche no arranca: sabes que hay un problema, pero no sabes si es la batería, el motor o un simple cable suelto.

En un entorno DirectAdmin, este error puede estar causado por múltiples factores: permisos incorrectos de archivos, un archivo .htaccess dañado, problemas de memoria PHP, módulos incompatibles o incluso un tema o plugin que está dando problemas. La buena noticia es que solucionar error 500 PrestaShop es algo que puedes hacer tú mismo con un poco de paciencia y siguiendo los pasos que te voy a explicar a continuación.

Herramientas que necesitas antes de empezar

Antes de ponernos manos a la obra, es importante que tengas a mano las herramientas necesarias. No te preocupes, no necesitas ser un experto en informática para esto.

Acceso al Panel de Control de DirectAdmin

Lo primero es tener acceso a tu panel de DirectAdmin. Este es el panel donde gestionas tu hosting, tus dominios y tus archivos. Normalmente accedes a él escribiendo tu dominio seguido de :2222 en el navegador. Por ejemplo: tudominio.com:2222.

Acceso al administrador de archivos

Dentro de DirectAdmin, tendrás acceso al "Administrador de archivos". Esta herramienta te permite ver, editar y modificar todos los archivos de tu sitio web. Es como el explorador de archivos de tu ordenador, pero en la nube.

Un cliente FTP (opcional pero recomendado)

Si te sientes más cómodo trabajando desde tu ordenador, puedes usar un cliente FTP como FileZilla. Esto te permitirá conectarte a tu servidor y trabajar con los archivos desde tu escritorio, lo que suele ser más cómodo para tareas como cambiar permisos o subir archivos.

Acceso al log de errores

Este es uno de los recursos más valiosos para troubleshooting PrestaShop. DirectAdmin te ofrece acceso a los logs de error del servidor. Ahí podrás ver exactamente qué está fallando. Te enseñaré cómo encontrarlos más adelante.

Paso 1: Identificar la causa del error 500

El primer paso para solucionar error 500 PrestaShop es saber qué lo está causando. No tiene sentido cambiar cosas al azar. Aquí es donde el log de errores se convierte en tu mejor amigo.

Cómo acceder al log de errores en DirectAdmin

Inicia sesión en tu panel de DirectAdmin.
Busca la sección "Administración de errores" o "Logs".
Haz clic en "Error Log" o "Registro de errores".
Busca el archivo llamado error_log en la carpeta principal de tu dominio o en la carpeta logs.

Cuando abras el log, verás líneas como esta: [Thu Oct 10 12:34:56 2024] [error] [client 192.168.1.1] PHP Fatal error: Allowed memory size of 134217728 bytes exhausted. Esta información es oro puro. Te dice exactamente qué está fallando.

Errores comunes que verás en el log

"Allowed memory size exhausted": tu sitio necesita más memoria PHP.
"Call to undefined function": probablemente hay un módulo o plugin incompatible.
"Parse error": hay un error de sintaxis en algún archivo.
"Failed to open stream: Permission denied": los permisos de archivos no son correctos.

[INFO] Si no encuentras el log de errores, puedes crear un archivo llamado error_log en la carpeta raíz de tu dominio. Los errores se registrarán automáticamente ahí.

Paso 2: Comprobar los permisos de archivos y carpetas

Uno de los causantes más comunes del error 500 PrestaShop son los permisos incorrectos. Cuando los archivos tienen permisos demasiado restrictivos, el servidor no puede leerlos o ejecutarlos. Cuando son demasiado permisivos, puede suponer un riesgo de seguridad.

Los permisos correctos para PrestaShop

Archivos: 644
Carpetas: 755
Archivos de configuración (config/settings.inc.php): 444 después de la instalación
Carpeta cache: 755 (y vacía si es posible)
Carpeta log: 755

Cómo cambiar los permisos desde DirectAdmin

Ve al "Administrador de archivos" de DirectAdmin.
Navega hasta la carpeta donde está instalado tu PrestaShop.
Selecciona todos los archivos y carpetas.
Haz clic en "Cambiar permisos".
Introduce el valor correcto (644 para archivos, 755 para carpetas).

[WARNING] No cambies los permisos de forma masiva sin saber lo que estás haciendo. Si pones permisos 777 en todo, estarás abriendo la puerta a posibles ataques. Los permisos 644 y 755 son los estándar recomendados por PrestaShop.

Cómo cambiar permisos desde FTP

Si prefieres usar FileZilla:

Conéctate a tu servidor.
Selecciona todos los archivos y carpetas.
Haz clic derecho y elige "Permisos de archivo".
Introduce el valor numérico (644 o 755).
Marca la casilla "Recurse into subdirectories" para aplicar los cambios a todos los subdirectorios.

Paso 3: Revisar el archivo .htaccess

El archivo .htaccess es un archivo de configuración muy importante en PrestaShop. Si está dañado o tiene directivas incompatibles, puede provocar un error 500 inmediato.

Cómo comprobar si el .htaccess es el problema

Ve al "Administrador de archivos" de DirectAdmin.
Navega hasta la carpeta raíz de tu PrestaShop.
Busca el archivo .htaccess (puede estar oculto, activa "Mostrar archivos ocultos" si no lo ves).
Haz una copia de seguridad del archivo (cámbiale el nombre a .htaccess.bak).
Intenta acceder a tu tienda.

Si la tienda carga correctamente, el problema era el .htaccess. Ahora tienes dos opciones:

Regenerar el archivo desde el panel de administración de PrestaShop (Back Office > Parámetros avanzados > Rendimiento > "Regenerar el archivo .htaccess").
Si no puedes acceder al Back Office, crea un .htaccess nuevo con el contenido básico de PrestaShop.

Contenido básico de un .htaccess para PrestaShop

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^api/ - [L]
RewriteRule ^(.*)$ /index.php [QSA,L]
</IfModule>

[TIP] Si no estás seguro de qué contenido debe tener tu .htaccess, es mejor que lo regeneres desde el Back Office de PrestaShop. Esto garantiza que se crea con todas las directivas correctas para tu versión.

Paso 4: Aumentar la memoria PHP

El error "Allowed memory size exhausted" es uno de los más comunes cuando aparece el error 500 en PrestaShop. Esto significa que tu tienda necesita más memoria de la que el servidor le está asignando.

Cómo aumentar la memoria PHP en DirectAdmin

Ve al panel de DirectAdmin.
Busca la sección "Configuración de PHP" o "PHP Settings".
Busca la directiva memory_limit.
Cámbiala a un valor mayor. Por ejemplo, de 128M a 256M o 512M.

[WARNING] No pongas un valor demasiado alto como -1 (ilimitado), ya que esto podría sobrecargar el servidor. Empieza con 256M y ve subiendo si es necesario.

Cómo aumentar la memoria PHP desde un archivo .htaccess

Si no puedes cambiar la configuración desde DirectAdmin, puedes intentar añadir estas líneas a tu .htaccess:

php_value memory_limit 256M
php_value max_execution_time 300

Aumentar la memoria desde el archivo php.ini

Si tienes acceso al archivo php.ini, busca la línea memory_limit y cámbiala al valor deseado. Guarda el archivo y reinicia PHP si es necesario.

Paso 5: Desactivar módulos o temas problemáticos

A veces, el error 500 en PrestaShop está causado por un módulo o tema que no es compatible con tu versión de PrestaShop o con la configuración de tu servidor.

Cómo identificar el módulo problemático

Si puedes acceder al Back Office, ve a "Módulos" y desactiva los módulos recientemente instalados o actualizados.
Si no puedes acceder al Back Office, tendrás que hacerlo manualmente.

Desactivar módulos manualmente desde DirectAdmin

Ve al "Administrador de archivos".
Navega hasta carpeta_de_prestashop/modules/.
Renombra la carpeta del módulo que crees que está causando el problema. Por ejemplo, cambia ps_banner a ps_banner_backup.

[TIP] Si no sabes qué módulo está causando el problema, prueba a renombrar todos los módulos de uno en uno hasta que encuentres el culpable. Es un proceso lento, pero efectivo.

Cambiar el tema manualmente

Si sospechas que el tema es el problema:

Ve a carpeta_de_prestashop/themes/.
Renombra la carpeta del tema activo.
PrestaShop debería usar el tema por defecto automáticamente.

Paso 6: Comprobar la versión de PHP y PrestaShop

La incompatibilidad entre versiones es otra causa frecuente de error 500 PrestaShop. Si tu PrestaShop es antiguo y tu servidor usa una versión de PHP muy reciente (o viceversa), pueden aparecer errores.

Qué versión de PHP necesitas

PrestaShop 1.6: PHP 5.6 o 7.0
PrestaShop 1.7: PHP 7.1, 7.2 o 7.3
PrestaShop 8.x: PHP 7.2 o superior

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

Ve al panel de DirectAdmin.
Busca la sección "Administrador de PHP" o "PHP Version".
Selecciona la versión de PHP que necesitas.
Guarda los cambios y comprueba si tu tienda carga correctamente.

[INFO] Si no encuentras la opción de cambiar la versión de PHP, es posible que tu plan de hosting no lo permita. Contacta con tu proveedor de hosting para que te ayuden.

Paso 7: Limpiar la caché de PrestaShop

Una caché corrupta puede provocar que tu tienda no cargue y aparezca el error 500. Esto es más común de lo que parece y la solución es muy sencilla.

Cómo limpiar la caché desde el Back Office

Ve a "Parámetros avanzados" > "Rendimiento".
Haz clic en "Vaciar la caché".

Cómo limpiar la caché manualmente desde DirectAdmin

Ve al "Administrador de archivos".
Navega hasta carpeta_de_prestashop/var/cache/ (en PrestaShop 1.7) o carpeta_de_prestashop/cache/ (en PrestaShop 1.6).
Elimina todos los archivos dentro de esa carpeta, pero no la carpeta en sí.
Si hay subcarpetas como dev o prod, elimina también su contenido.

[TIP] Asegúrate de que la carpeta de caché tenga permisos 755 después de limpiarla, para que PrestaShop pueda volver a escribir en ella sin problemas.

Paso 8: Revisar los archivos de configuración

Los archivos de configuración de PrestaShop (config/settings.inc.php en 1.6 o app/config/parameters.php en 1.7) pueden estar dañados o tener datos incorrectos, lo que provoca el error 500.

Cómo comprobar el archivo de configuración

Ve al "Administrador de archivos".
Navega hasta la carpeta de configuración correspondiente.
Abre el archivo y verifica que las credenciales de la base de datos son correctas.
Comprueba que la URL de tu tienda es correcta.

[WARNING] Ten mucho cuidado al editar estos archivos. Un error de sintaxis puede dejar tu tienda completamente inaccesible. Haz una copia de seguridad antes de modificar nada.

Paso 9: Comprobar los permisos de la base de datos

A veces el problema no está en los archivos, sino en la base de datos. Si tu base de datos está llena o tiene permisos incorrectos, tu tienda no cargará.

Cómo comprobar la base de datos en DirectAdmin

Ve a "MySQL Management" en DirectAdmin.
Asegúrate de que tu base de datos existe y que el usuario tiene todos los privilegios.
Si tienes acceso a phpMyAdmin, puedes comprobar si las tablas de PrestaShop están correctas.

[INFO] Si sospechas que la base de datos está dañada, puedes usar la herramienta "Reparar" de phpMyAdmin. Selecciona todas las tablas y elige "Reparar tabla".

Paso 10: Contactar con el soporte de tu hosting

Si después de todos estos pasos tu PrestaShop no carga, puede que el problema sea más profundo. En ese caso, es hora de contactar con el soporte técnico de tu hosting.

Qué información debes proporcionar

El mensaje exacto del error 500.
El contenido del log de errores.
Los pasos que ya has intentado.
Tu versión de PrestaShop y de PHP.

[TIP] Muchos proveedores de hosting tienen un soporte técnico 24/7. No dudes en aprovecharlo, para eso estás pagando.

Preguntas frecuentes (FAQ)

¿Por qué mi PrestaShop da error 500 después de una actualización?

Las actualizaciones pueden corromper archivos o dejar módulos incompatibles. Intenta desactivar los módulos recientes y limpia la caché.

¿El error 500 puede ser por un problema de seguridad?

Sí, a veces los cortafuegos del servidor bloquean ciertos archivos o acciones. Contacta con tu hosting si sospechas de esto.

¿Cuánto tiempo tarda en solucionarse el error 500?

Depende de la causa. Si es un problema de permisos, puede tardar 10 minutos. Si es un módulo incompatible, puede llevar más tiempo.

¿Debo contratar un servicio de mantenimiento de PrestaShop?

Si el troubleshooting PrestaShop te supera, puede ser una buena inversión. Muchos servicios de mantenimiento incluyen soporte para este tipo de errores.

Conclusión

El error 500 en PrestaShop puede ser desalentador, pero como has visto, solucionar error 500 es algo que puedes hacer siguiendo los pasos correctos. Empieza siempre por lo más sencillo: revisar los logs, comprobar los permisos y limpiar la caché. Si el problema persiste, ve subiendo en complejidad: modifica la memoria PHP, desactiva módulos y revisa la configuración.

Recuerda que en DirectAdmin tienes todas las herramientas necesarias para diagnosticar y resolver el problema. La clave está en ser metódico y no rendirse. Con paciencia y siguiendo esta guía, tu tienda volverá a estar operativa en poco tiempo.

[WARNING] Si en algún momento te sientes perdido o el problema es crítico para tu negocio, no dudes en pedir ayuda profesional. Un error 500 no es el fin del mundo, pero puede afectar a tus ventas si no se resuelve a tiempo.

Espero que esta guía te haya sido de gran ayuda. Si tienes alguna otra duda, no dudes en consultar la documentación oficial de PrestaShop o contactar con tu proveedor de hosting. ¡Buena suerte con tu tienda!