Errores comunes de PrestaShop al instalar en DirectAdmin y cómo solucionarlos

Antes de empezar: ¿Por qué aparecen errores al instalar PrestaShop en DirectAdmin?

Instalar PrestaShop en DirectAdmin es un proceso muy común, pero también es cierto que pueden aparecer algunos errores típicos que frustran a cualquiera. La mayoría de estos fallos no son graves y tienen una solución sencilla si sabes dónde mirar. En esta guía vamos a repasar los errores más frecuentes que verás al instalar PrestaShop DirectAdmin errores, cómo identificarlos y, sobre todo, cómo solucionarlos paso a paso. No necesitas ser un experto en servidores, solo tener paciencia y seguir las instrucciones al pie de la letra.

Antes de lanzarnos, ten en cuenta que DirectAdmin es un panel de control muy potente, pero a veces su configuración por defecto no está pensada para las necesidades específicas de PrestaShop. Por eso, es normal que tengas que ajustar algunos parámetros. Vamos a ello.

Error 1: Pantalla en blanco o error 500 tras subir los archivos

Este es, sin duda, uno de los errores comunes PrestaShop que más aparecen. Subes los archivos de PrestaShop a tu carpeta public_html, intentas acceder a tu dominio y… nada. Una página en blanco o un error 500. No te preocupes, casi siempre es un problema de permisos o de falta de memoria PHP.

¿Por qué ocurre?

DirectAdmin, por defecto, asigna permisos que pueden no ser los adecuados para que PrestaShop lea y escriba archivos. Además, el límite de memoria PHP suele ser bajo (128 MB) y PrestaShop necesita más para ejecutar el instalador.

Solución paso a paso

1. Corrige los permisos de archivos y carpetas: Conéctate a tu servidor por FTP (con FileZilla, por ejemplo) o usa el administrador de archivos de DirectAdmin. Selecciona todos los archivos de PrestaShop y establece los permisos en 644 para archivos y 755 para carpetas. Si usas FileZilla, puedes hacer clic derecho sobre la carpeta raíz, ir a "Permisos de archivos" y marcar la opción "Recursivo en subcarpetas".
2. Aumenta el límite de memoria PHP: Entra en tu panel de DirectAdmin, busca la sección "Administrador de PHP" o "Configuración de PHP". Ahí verás una lista de opciones. Busca memory_limit y cámbialo a 512M o incluso 768M. Guarda los cambios.
3. Revisa el archivo .htaccess: Si el error persiste, puede que el .htaccess de PrestaShop esté corrupto. Renombra el archivo .htaccess a .htaccess_backup e intenta acceder de nuevo. Si funciona, el instalador creará uno nuevo.

[WARNING]
No subas los archivos de PrestaShop con un gestor de archivos que no sea FTP o el de DirectAdmin. A veces, los gestores web no suben todos los archivos correctamente, lo que provoca errores extraños.

Error 2: "La extensión PHP cURL debe estar cargada" o "Falta la extensión GD"

Este es otro clásico entre los errores PrestaShop DirectAdmin. El instalador te muestra un mensaje indicando que faltan extensiones de PHP. PrestaShop es exigente y necesita una serie de extensiones para funcionar correctamente.

¿Qué extensiones necesito?

Las más críticas son: cURL, GD, PDO, MySQLi, OpenSSL, Zip y Intl. Si alguna falta, el instalador se detiene.

Solución paso a paso

1. Accede al selector de versiones de PHP: En DirectAdmin, ve a "Select PHP Version" o "Administrador de PHP" (dependiendo de la versión). Verás una lista de extensiones con casillas de verificación.
2. Activa las extensiones: Marca las casillas de las extensiones que te falten (cURL, GD, etc.) y guarda los cambios.
3. Reinicia PHP-FPM: DirectAdmin suele reiniciar PHP automáticamente, pero si no es así, busca el botón "Reiniciar PHP" o "Restart PHP-FPM" y haz clic.
4. Verifica de nuevo: Vuelve a ejecutar el instalador de PrestaShop. El error debería haber desaparecido.

[TIP]
Si no ves la opción "Select PHP Version", es posible que tu plan de hosting no incluya esta función. En ese caso, contacta con tu proveedor de hosting y pídeles que activen las extensiones necesarias. Es un trámite rápido.

Error 3: Problemas con los permisos de la carpeta var/cache y config

Los permisos PrestaShop DirectAdmin son la fuente de muchos quebraderos de cabeza. PrestaShop necesita escribir en ciertas carpetas para generar cachés, configuraciones y archivos temporales. Si no tiene permisos, verás errores como "No se puede escribir en el archivo" o simplemente la tienda no carga.

¿Cómo solucionarlo?

1. Identifica las carpetas problemáticas: Las carpetas que suelen dar problemas son var/cache, config, img, log y download. Estas deben tener permisos de escritura.
2. Establece permisos 755: Para la mayoría de los casos, con permisos 755 en estas carpetas es suficiente. Si tu servidor usa PHP como módulo de Apache (y no PHP-FPM), puede que necesites permisos 775 o 777.

[WARNING]
Usar permisos 777 es un riesgo de seguridad. Solo úsalo temporalmente para instalar y luego vuelve a 755. Si tu servidor usa PHP-FPM (lo más común en DirectAdmin), con 755 es más que suficiente.

3. Usa el administrador de archivos de DirectAdmin: Esta es la forma más fiable. Navega a la carpeta de tu dominio, selecciona la carpeta var, luego cache, haz clic derecho y selecciona "Cambiar permisos". Introduce 755 y marca la casilla "Aplicar a todos los archivos y subcarpetas". Repite este proceso con las demás carpetas.

Error 4: El instalador se queda atascado en "Paso 3" o no avanza

Este es otro de los errores comunes PrestaShop que más desesperan. El instalador se queda cargando o muestra un error en el paso 3 (configuración de la base de datos). Esto suele ser un problema con la conexión a MySQL o con la configuración de la base de datos en sí.

Posibles causas y soluciones

1. Datos de la base de datos incorrectos: Revisa que el nombre de la base de datos, el usuario y la contraseña sean exactamente los que creaste en DirectAdmin. Un simple error tipográfico es la causa más común.
2. El usuario de la base de datos no tiene privilegios: En DirectAdmin, al crear una base de datos, debes asignar un usuario y darle privilegios. Asegúrate de que has marcado la casilla "TODOS LOS PRIVILEGIOS" o al menos los que PrestaShop necesita (SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP).
3. El servidor MySQL no está en "localhost": A veces, DirectAdmin usa un hostname diferente para MySQL, como mysql.tudominio.com. Revisa los datos de conexión en la sección "MySQL Management" de DirectAdmin.

[INFO]
Si usas Syspanel (el panel que antes se llamaba HestiaCP), el acceso se realiza a través del puerto 2106 y la gestión de bases de datos es similar, pero la interfaz puede variar ligeramente. En Syspanel, también encontrarás la opción de crear bases de datos y usuarios con sus privilegios.

Error 5: "Error de conexión a la base de datos" al intentar instalar

Este error es muy específico y suele aparecer justo en el paso de la configuración de la base de datos. El mensaje puede ser algo como "Link to database cannot be established".

Solución detallada

1. Verifica que el servidor MySQL está en funcionamiento: En DirectAdmin, ve a "Servicios" o "Status" y comprueba que MySQL está corriendo. Si no lo está, inícialo.
2. Comprueba los datos de acceso: Vuelve a revisar el nombre de la base de datos, el usuario y la contraseña. Recuerda que en DirectAdmin, el nombre de la base de datos suele tener un prefijo con tu nombre de usuario, por ejemplo usuario_bdprestashop.
3. Prueba la conexión desde PHPMyAdmin: Si tienes acceso a PHPMyAdmin, intenta iniciar sesión con los mismos datos. Si no puedes, el problema está en los datos de acceso. Si puedes, el problema puede estar en la configuración de PrestaShop.
4. Revisa el archivo parameters.php: Si ya has intentado instalar antes, puede que exista un archivo app/config/parameters.php con datos incorrectos. Bórralo e intenta la instalación de nuevo.

[TIP]
A veces, el problema no es la contraseña, sino que el usuario de la base de datos solo puede conectarse desde localhost. Si estás intentando instalar desde una IP remota, puede que tengas problemas. En DirectAdmin, asegúrate de que el campo "Host" del usuario de la base de datos sea localhost o % (para cualquier host).

Error 6: Problemas con las extensiones PHP al instalar PrestaShop (versiones antiguas)

Si estás intentando instalar una versión antigua de PrestaShop (1.6 o anterior) en un servidor con PHP 8.0 o superior, es muy probable que te encuentres con errores de compatibilidad. Las extensiones PHP PrestaShop han cambiado y las versiones antiguas no son compatibles con las nuevas.

¿Qué opciones tienes?

1. Cambia la versión de PHP: En DirectAdmin, ve a "Select PHP Version" y cambia a una versión más antigua como PHP 7.4 o incluso 7.1. PrestaShop 1.6 funciona bien con PHP 7.1.
2. Actualiza PrestaShop: Si es posible, es mejor que actualices a la última versión de PrestaShop. Las versiones nuevas son compatibles con PHP 8.0 y superiores.

[WARNING]
Usar versiones antiguas de PHP es un riesgo de seguridad. Si tu tienda va a estar en producción, te recomendamos encarecidamente que uses una versión de PrestaShop que sea compatible con PHP 8.0 o superior.

Error 7: La tienda se ve sin estilos (CSS) o con imágenes rotas

Este error no impide la instalación, pero sí que la tienda se vea mal. Es un problema de las URLs amigables o de los permisos de la carpeta img.

Solución rápida

1. Activa las URLs amigables: Ve al panel de administración de PrestaShop, a "Parámetros avanzados" > "SEO y URLs". Activa la opción "URLs amigables". Si no puedes acceder al panel, edita el archivo .htaccess y añade las reglas de reescritura que PrestaShop genera.
2. Revisa los permisos de la carpeta img: Asegúrate de que la carpeta img y sus subcarpetas tienen permisos de escritura (755 o 775).
3. Regenera las miniaturas: En el panel de administración, ve a "Parámetros avanzados" > "Rendimiento" y haz clic en "Regenerar miniaturas".

[INFO]
Este problema es muy común después de migrar una tienda de un servidor a otro. Asegúrate de que la URL de la tienda en "Parámetros avanzados" > "General" es la correcta (con o sin www).

Error 8: No puedo acceder al panel de administración

Después de instalar, intentas acceder a /admin y te da error 404 o te redirige a la página principal. Esto suele pasar por dos motivos: la carpeta de administración se ha renombrado o hay un problema con el .htaccess.

Cómo solucionarlo

1. Busca la carpeta de administración: PrestaShop 1.7 y superiores renombran la carpeta de administración de forma aleatoria por seguridad. Busca en tu servidor una carpeta que se llame admin seguido de un código (ej. admin12345). Accede a través de esa URL.
2. Renombra el .htaccess: Si no encuentras la carpeta, renombra el .htaccess a .htaccess_backup e intenta acceder de nuevo. Si funciona, el problema es de las reglas de reescritura.

Error 9: El instalador no arranca o se descarga el archivo PHP

Este es un error raro pero frustrante. En lugar de ejecutar el instalador, el navegador descarga el archivo index.php. Esto significa que PHP no se está ejecutando en tu servidor.

Solución

1. Verifica que PHP está activo: En DirectAdmin, asegúrate de que has seleccionado una versión de PHP en "Select PHP Version". Si no has seleccionado ninguna, PHP no se ejecutará.
2. Comprueba el archivo .htaccess: Un .htaccess corrupto puede evitar que PHP se ejecute. Renómbralo y prueba de nuevo.
3. Revisa la configuración de PHP-FPM: Asegúrate de que PHP-FPM está configurado para ejecutarse en tu dominio. En DirectAdmin, puedes ver esto en "PHP-FPM Management".

Error 10: "La tienda está en modo mantenimiento" o "Error al conectar con la base de datos" después de la instalación

Este es uno de los errores comunes PrestaShop que aparecen justo después de instalar, al intentar acceder a la tienda o al panel de administración.

Causas y soluciones

1. El archivo parameters.php tiene datos incorrectos: Revisa el archivo app/config/parameters.php y asegúrate de que los datos de la base de datos son correctos.
2. La base de datos no se ha importado correctamente: Si has movido una tienda existente, puede que la base de datos no se haya importado del todo. Reimporta la base de datos desde PHPMyAdmin.
3. Los permisos de la carpeta var/cache son incorrectos: Borra el contenido de la carpeta var/cache y establece permisos 755. Esto obligará a PrestaShop a regenerar la caché.

Preguntas frecuentes (FAQ) sobre errores de PrestaShop en DirectAdmin

¿Cuál es el error más común al instalar PrestaShop en DirectAdmin?

El error más común es la pantalla en blanco o el error 500, causado casi siempre por permisos incorrectos en archivos y carpetas, o por un límite de memoria PHP demasiado bajo.

¿Cómo puedo aumentar el límite de memoria PHP en DirectAdmin?

Ve a "Select PHP Version" o "Administrador de PHP" y busca la opción memory_limit. Cámbiala a 512M o 768M y guarda los cambios.

¿Qué permisos necesito para PrestaShop en DirectAdmin?

Los archivos deben tener permisos 644 y las carpetas 755. Si usas PHP como módulo de Apache, puede que necesites 775 para algunas carpetas como var/cache o img.

¿Qué extensiones PHP necesito para PrestaShop?

Las extensiones más importantes son: cURL, GD, PDO, MySQLi, OpenSSL, Zip e Intl. Puedes activarlas desde "Select PHP Version" en DirectAdmin.

¿Por qué mi instalación de PrestaShop se queda atascada en el paso 3?

Esto suele deberse a datos incorrectos de la base de datos, a un usuario sin privilegios o a que el servidor MySQL no es localhost. Revisa estos tres puntos.

¿Puedo instalar PrestaShop 1.6 en PHP 8.0?

No se recomienda. PrestaShop 1.6 no es compatible con PHP 8.0. Te recomendamos usar PHP 7.1 o actualizar a una versión más reciente de PrestaShop.

¿Qué hago si mi tienda se ve sin estilos CSS?

Activa las URLs amigables en el panel de administración, revisa los permisos de la carpeta img y regenera las miniaturas desde "Parámetros avanzados"