Solucionar error 500 en PrestaShop con DirectAdmin

¿Te ha aparecido de repente un error 500 en tu tienda PrestaShop alojada en un servidor con DirectAdmin? No te preocupes, es uno de los problemas más comunes y, por suerte, suele tener solución. Este error, conocido como "Error interno del servidor", es una señal de que algo no funciona bien en la configuración de tu sitio, pero no te dice exactamente qué. En esta guía extensa y paso a paso, te explicaré las causas más frecuentes del error 500 PrestaShop en entornos DirectAdmin PrestaShop error y cómo solucionar error 500 de forma sencilla, incluso si no eres un experto en sistemas.

Vamos a desglosar el problema desde lo más básico hasta lo más técnico, siempre con un lenguaje claro y ejemplos prácticos. Si sigues estos pasos, podrás recuperar tu tienda en pocos minutos.

¿Por qué aparece el error 500 en PrestaShop?

El error 500 es un código HTTP genérico que indica que el servidor encontró una condición inesperada que le impidió completar la solicitud. En el contexto de PrestaShop DirectAdmin fallo, las causas más habituales son:

Archivos .htaccess corruptos o mal configurados. PrestaShop usa este archivo para gestionar redirecciones y URLs amigables.
Problemas de permisos de archivos o carpetas. Si los permisos no son correctos, el servidor no puede leer o ejecutar ciertos archivos.
Errores en la configuración de PHP. Versiones incompatibles, límites de memoria bajos o extensiones deshabilitadas.
Módulos o temas defectuosos. Un plugin recién instalado puede estar causando un conflicto.
Errores en la base de datos. Aunque es menos común, también puede provocar un 500.
Problemas de caché o sesión. Archivos temporales corruptos.

Lo primero que debes hacer es mantener la calma. Este error no significa que hayas perdido datos, solo que el servidor no puede mostrar la página. Vamos a resolverlo.

Paso 1: Accede a los logs de error (la clave para saber qué pasa)

Antes de tocar nada, necesitas encontrar la causa exacta. El error servidor PrestaShop suele dejar una pista en los archivos de registro (logs). En DirectAdmin, puedes acceder a ellos desde el panel de control.

¿Cómo ver los logs en DirectAdmin?

Inicia sesión en tu panel de DirectAdmin.
Ve a la sección "Gestión de cuentas" o "Estadísticas avanzadas".
Busca la opción "Logs de errores" o "Error Log". Normalmente está en la sección de "Herramientas del sitio".
También puedes acceder por FTP o SSH a la carpeta logs/ dentro de tu cuenta de hosting. El archivo se suele llamar error.log o php_errors.log.

¿Qué buscas en el log? Líneas que contengan la fecha y hora del error, con frases como "PHP Fatal error", "Allowed memory size exhausted", "Permission denied" o "Parse error". Copia el texto de la línea del error, te servirá más adelante.

[TIP] Si no ves nada en los logs, puede que el error esté oculto por la configuración de PHP. Activa la visualización de errores temporalmente (lo veremos más adelante).

Paso 2: Soluciona el error más común: el archivo .htaccess

El archivo .htaccess es el principal sospechoso. A menudo se corrompe al instalar un módulo, cambiar la URL del sitio o al hacer una actualización.

Cómo regenerar el .htaccess de PrestaShop

Conéctate a tu servidor por FTP (FileZilla, por ejemplo) o al administrador de archivos de DirectAdmin.
Navega hasta la carpeta raíz de tu PrestaShop (donde están las carpetas admin, modules, themes, etc.).
Busca el archivo .htaccess. Si no lo ves, asegúrate de que tu cliente FTP muestre archivos ocultos.
Renómbralo a .htaccess_backup (por si acaso).
Ahora, accede a tu panel de administración de PrestaShop (si es que aún puedes) o si no, tendrás que regenerarlo manualmente.

Si puedes acceder al panel de administración:

Ve a "Parámetros de la tienda" > "Tráfico y SEO".
En la pestaña "SEO y URLs", haz clic en "Guardar" sin cambiar nada. Esto regenerará el archivo.

Si no puedes acceder al panel:

Crea un archivo .htaccess nuevo con el siguiente contenido básico (esto es solo para que el sitio funcione, luego lo optimizarás):

# START: Configuración básica de PrestaShop
<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^(.*)$ index.php [QSA,L]
</IfModule>
# END: Configuración básica de PrestaShop

Sube este archivo a la raíz y comprueba si el error 500 desaparece. Si funciona, después podrás regenerar el .htaccess correcto desde el panel.

[WARNING] No copies el contenido de ejemplo si no es necesario. Lo mejor es regenerarlo desde el panel. Este contenido es de emergencia.

Paso 3: Verifica los permisos de archivos y carpetas

Los permisos incorrectos son otra causa frecuente del error 500 PrestaShop. En DirectAdmin, los permisos deben ser:

Carpetas: 755 (rwxr-xr-x)
Archivos: 644 (rw-r--r--)
Archivos de configuración (como config/settings.inc.php): 644
Carpetas de caché (cache/, themes/cache/): 755

Cómo corregir permisos desde DirectAdmin

En el panel de DirectAdmin, ve a "Administrador de archivos".
Selecciona la carpeta raíz de tu PrestaShop.
Marca la casilla "Seleccionar todo" y luego haz clic en "Cambiar permisos".
Aplica los valores mencionados (755 para carpetas, 644 para archivos). Algunos paneles tienen un botón "Restablecer permisos" que lo hace automático.

Si usas SSH (más rápido):
Conéctate por terminal y ejecuta:

find /ruta/a/tu/prestashop -type d -exec chmod 755 {} \;
find /ruta/a/tu/prestashop -type f -exec chmod 644 {} \;

[INFO] Si el error persiste, prueba con permisos 755 en archivos específicos como index.php o config/settings.inc.php. No es recomendable usar 777 por seguridad.

Paso 4: Aumenta los límites de PHP

Un error típico en los logs es "Allowed memory size of X bytes exhausted". Esto significa que PHP necesita más memoria. En DirectAdmin, puedes ajustar los parámetros de PHP desde el panel.

Cómo modificar los límites de PHP en DirectAdmin

Ve a "Configuración de PHP" o "Selector de PHP" (dependiendo de la versión de DirectAdmin).
Busca las opciones:
- memory_limit -> Ponlo a 256M o 512M.
- max_execution_time -> 300 segundos.
- upload_max_filesize -> 64M (si trabajas con imágenes grandes).
- post_max_size -> 64M.
Guarda los cambios y reinicia el servicio PHP si es necesario (a veces se hace automáticamente).

Si no encuentras estas opciones, puedes crear un archivo php.ini personalizado en la raíz de tu PrestaShop con estas líneas:

memory_limit = 256M
max_execution_time = 300
upload_max_filesize = 64M
post_max_size = 64M

O también puedes usar un archivo .user.ini (si tu servidor lo soporta).

[TIP] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el puerto de acceso es el 2106. Los pasos son similares, pero busca la opción "PHP Settings" dentro del panel de tu sitio.

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

Si el error apareció después de instalar un módulo o cambiar de tema, ese es el culpable. Como no puedes acceder al panel, tendrás que hacerlo manualmente.

Cómo desactivar módulos desde FTP

Conéctate por FTP a tu servidor.
Ve a la carpeta modules/.
Localiza la carpeta del módulo sospechoso (por ejemplo, modules/nombredelmodulo/).
Renómbrala añadiendo un guion bajo al final, por ejemplo: nombredelmodulo_desactivado.
Vuelve a cargar tu tienda. Si el error desaparece, ese módulo era el problema.

Para desactivar el tema:

Ve a la carpeta themes/.
Dentro, busca la carpeta de tu tema activo (normalmente themes/classic o el nombre que hayas elegido).
Renómbrala igual que hiciste con el módulo.
PrestaShop usará el tema por defecto (si está disponible) o mostrará un error manejable.

Paso 6: Limpia la caché de PrestaShop

A veces la caché guarda datos corruptos. Puedes limpiarla manualmente.

Conéctate por FTP.
Elimina todo el contenido de la carpeta cache/ (excepto el archivo index.php que suele haber).
También vacía la carpeta themes/cache/ si existe.
Elimina la carpeta cache/smarty/ completamente (se regenerará sola).

[WARNING] No elimines la carpeta cache/ en sí, solo su contenido. Si borras la carpeta, el sistema podría no crearla automáticamente.

Paso 7: Revisa la configuración de la base de datos

Aunque menos común, un error en la conexión a la base de datos puede dar un 500. Revisa el archivo config/settings.inc.php (o app/config/parameters.php en versiones modernas de PrestaShop 1.7+).

¿Qué buscar?

Que el nombre de la base de datos, usuario y contraseña sean correctos.
Que el servidor de base de datos (normalmente localhost) esté bien escrito.
Que los permisos del usuario de la BD sean los adecuados (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.).

Si tienes acceso a phpMyAdmin desde DirectAdmin, puedes verificar la conexión entrando a la base de datos y ejecutando una consulta simple como SELECT 1;.

Paso 8: Activa el modo de depuración de PrestaShop (último recurso)

Si nada funciona, activa el modo debug para obtener más información sobre el error servidor PrestaShop.

Cómo activar el modo debug manualmente

Abre el archivo config/defines.inc.php (en PrestaShop 1.6 y anteriores) o config/defines.inc.php en la raíz (en 1.7+).

Busca la línea:

define('_PS_MODE_DEV_', false);

y cámbiala a:

define('_PS_MODE_DEV_', true);

Guarda el archivo y recarga la tienda. Ahora verás errores detallados en pantalla (como "Fatal error: Uncaught exception...").
Anota el error y luego vuelve a poner false para desactivar el modo debug (por seguridad).

[INFO] En algunos servidores, el modo debug puede mostrar información sensible. No lo dejes activo en producción.

Preguntas frecuentes (FAQ) sobre el error 500 en PrestaShop y DirectAdmin

¿Por qué veo un error 500 solo en algunas páginas?

Puede deberse a un módulo específico que se carga en esas páginas o a una regla de .htaccess mal escrita. Revisa los logs para identificar la URL que falla.

¿El error 500 puede dañar mi base de datos?

No directamente. El error 500 es del servidor web, no de la base de datos. Sin embargo, si el error persiste y afecta a la escritura de datos, podrías tener problemas de integridad. Siempre es bueno tener un backup.

¿Qué hago si no tengo acceso al panel de administración ni a FTP?

Contacta con tu proveedor de hosting. Ellos pueden acceder a los logs y ayudarte a solucionar error 500 desde su lado. Diles que es un DirectAdmin PrestaShop error y que necesitas revisar los logs de error.

¿Puede ser un problema de certificado SSL?

Poco probable. El error 500 es interno del servidor, no de conexión segura. Si el SSL está mal configurado, verías un error de certificado, no un 500.

¿El error 500 tiene relación con la versión de PHP?

Sí, totalmente. PrestaShop requiere versiones específicas de PHP. Por ejemplo, PrestaShop 1.6 funciona con PHP 5.6 a 7.1, y PrestaShop 1.7 con PHP 7.1 a 8.0. Si tu servidor tiene PHP 8.2 y tu tienda es antigua, puedes tener errores. En DirectAdmin, puedes cambiar la versión de PHP desde el "Selector de PHP".

Resumen y consejos finales

El error 500 PrestaShop en DirectAdmin PrestaShop error es frustrante, pero casi siempre tiene solución. Sigue este orden:

Revisa los logs para saber la causa exacta.
Regenera el .htaccess (es la solución más común).
Corrige permisos de archivos y carpetas.
Aumenta los límites de PHP (memoria, tiempo de ejecución).
Desactiva módulos o temas sospechosos.
Limpia la caché de PrestaShop.
Verifica la base de datos y sus credenciales.
Activa el modo debug como último recurso.

Si después de todo esto el error persiste, contacta con tu proveedor de hosting. A veces el problema está en la configuración del servidor (como módulos de Apache deshabilitados, por ejemplo mod_rewrite).

Recuerda: no borres nada sin hacer una copia de seguridad. Siempre renombra los archivos en lugar de eliminarlos. Y si usas Syspanel (HestiaCP), recuerda que el puerto de acceso es el 2106 y los pasos son muy similares.

Espero que esta guía te haya sido de ayuda. ¡Tu tienda volverá a funcionar en breve!