Solucionar error de instalación PrestaShop en DirectAdmin

¿Por qué da error al instalar PrestaShop en DirectAdmin?

Si estás intentando montar una tienda online y te has topado con un error prestashop directadmin, no te preocupes: es mucho más común de lo que parece y, en la gran mayoría de los casos, tiene una solución sencilla. DirectAdmin es un panel de control muy potente y rápido, pero su configuración por defecto a veces choca con los requisitos específicos de PrestaShop.

Lo primero que debes saber es que este error no significa que algo esté roto para siempre. Simplemente hay que ajustar un par de parámetros en el servidor o en los archivos de configuración. Vamos a desgranar las causas más frecuentes y, sobre todo, cómo solucionarlas paso a paso.

A lo largo de esta guía, veremos desde los errores de permisos hasta los problemas con la versión de PHP, pasando por la configuración de la base de datos. Tanto si eres principiante como si ya tienes algo de experiencia, aquí encontrarás la respuesta.

Requisitos previos antes de instalar PrestaShop en DirectAdmin

Antes de lanzarnos a corregir errores, es vital que tu servidor cumpla los requisitos mínimos. Si no los cumples, cualquier instalación fallará por mucho que lo intentes.

Versión de PHP compatible

PrestaShop es exigente con la versión de PHP. Las versiones modernas de PrestaShop (1.7.8 y 8.x) necesitan PHP 7.2 como mínimo, aunque lo recomendable es PHP 7.4 u 8.0 para un rendimiento óptimo.

Para cambiar la versión de PHP en DirectAdmin:

Entra en tu panel de DirectAdmin.
Busca la sección "Administrador de PHP" o "PHP Version Selector" (el nombre puede variar según la versión de DirectAdmin).
Selecciona la versión recomendada (por ejemplo, PHP 8.0).
Guarda los cambios y reinicia el servicio si te lo pide.

[INFO] Si tu DirectAdmin no tiene un selector de PHP, es posible que debas contactar con tu proveedor de hosting para que lo active o lo cambie manualmente.

Extensiones PHP necesarias

PrestaShop necesita varias extensiones de PHP activas para funcionar. Las más importantes son:

curl
gd
intl
mbstring
openssl
pdo_mysql
zip

En DirectAdmin, estas extensiones suelen activarse desde el mismo "PHP Version Selector" marcando las casillas correspondientes.

Errores comunes al instalar PrestaShop en DirectAdmin

Vamos a ver ahora los problemas más habituales y cómo resolverlos. Te recomiendo seguir el orden de esta lista, ya que va de lo más básico a lo más complejo.

1. Error de permisos de archivos y carpetas

Este es, con diferencia, el error prestashop directadmin más típico. Suele aparecer como un mensaje de "No se puede escribir en el archivo" o directamente un pantallazo blanco.

El problema es que los archivos de PrestaShop necesitan ciertos permisos para poder instalarse. En DirectAdmin, la propiedad de los archivos debe ser la del usuario del hosting, y los permisos deben ser los correctos.

Solución paso a paso:

Accede a tu Administrador de Archivos en DirectAdmin.
Ve a la carpeta donde has subido PrestaShop (normalmente public_html o una subcarpeta).
Selecciona todos los archivos y carpetas.
Haz clic en "Cambiar permisos".
Pon los permisos en 755 para las carpetas y 644 para los archivos.
Aplica los cambios.

[WARNING] No uses permisos 777 (todos los permisos). Aunque a veces se recomienda para solucionar errores, es un grave riesgo de seguridad. Si tu instalación te pide permisos de escritura, es mejor que ajustes la propiedad de los archivos que no dar permisos universales.

2. Error de conexión con la base de datos MySQL

Otro de los fallos más comunes es el mensaje de "No se puede conectar a la base de datos" o "Error al crear la base de datos".

Causas y soluciones:

La base de datos no existe: Debes crearla antes de instalar PrestaShop. En DirectAdmin, ve a "Administrador de MySQL" y crea una nueva base de datos y un usuario con todos los privilegios.
El prefijo de la base de datos: DirectAdmin suele añadir un prefijo al nombre de la base de datos (por ejemplo, usuario_bd). Asegúrate de escribir el nombre completo, incluyendo ese prefijo, durante la instalación.
El host de la base de datos: En la mayoría de los casos, el host es localhost. Pero en algunos servidores DirectAdmin, puede ser 127.0.0.1 o incluso el nombre del servidor. Si localhost no funciona, prueba con las otras opciones.

[TIP] Cuando crees el usuario de la base de datos, asegúrate de que tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.). A veces, por defecto, solo se le dan algunos y eso causa errores extraños.

3. Error de memoria PHP (Memory Limit)

Si ves un mensaje como "Fatal error: Allowed memory size of X bytes exhausted", significa que PrestaShop necesita más memoria de la que PHP tiene asignada.

Cómo solucionarlo:

Ve a la carpeta raíz de tu instalación de PrestaShop.
Busca el archivo config/defines.inc.php.
Ábrelo con un editor de texto (desde el Administrador de Archivos de DirectAdmin).
Busca la línea que dice define('_PS_MEMORY_LIMIT_', '256M');.
Cambia 256M por 512M o incluso 1G si tienes suficiente memoria en el servidor.
Guarda el archivo.

También puedes aumentar el límite de memoria desde el archivo php.ini de tu cuenta, si tienes acceso a él. Busca la línea memory_limit y cámbiala.

4. Error con la versión de PHP o el archivo .htaccess

A veces, el error no es de permisos ni de base de datos, sino de configuración del servidor web. PrestaShop utiliza un archivo .htaccess para gestionar las URLs amigables y otras funciones.

Si ves un error 500 o un bucle de redirección:

Ve a la carpeta de instalación.
Busca el archivo .htaccess (si no lo ves, activa la opción de "Mostrar archivos ocultos" en el Administrador de Archivos).
Renómbralo a .htaccess.bak (esto lo desactiva temporalmente).
Intenta acceder a tu tienda de nuevo.

Si con eso se soluciona, el problema es que el .htaccess estaba mal configurado o tenía reglas incompatibles con la versión de PHP que tienes. Puedes regenerarlo desde el panel de administración de PrestaShop (Parámetros avanzados > Rendimiento, y ahí "Regenerar el archivo .htaccess").

[WARNING] Si renombras el .htaccess, las URLs amigables dejarán de funcionar hasta que lo regeneres. Es una solución temporal para diagnosticar el problema, no la definitiva.

5. Error de zona horaria o fecha incorrecta

Un error menos conocido, pero muy molesto, es el de "It is not possible to set the timezone" o problemas con la fecha y hora.

Solución:

Ve a tu php.ini (o al selector de PHP de DirectAdmin).
Busca la línea date.timezone.
Asegúrate de que tenga un valor válido, como date.timezone = "Europe/Madrid" o la zona horaria que corresponda a tu ubicación.
Guarda y reinicia PHP.

Solución paso a paso para el error de instalación típico

Vamos a hacer un resumen práctico con los pasos que debes seguir si te encuentras con un error genérico al instalar PrestaShop en DirectAdmin. Este flujo de trabajo te sacará del apuro en el 90% de los casos.

Paso 1: Verifica los requisitos del sistema

Entra en DirectAdmin y selecciona la versión de PHP 8.0.
Activa todas las extensiones necesarias (curl, gd, intl, mbstring, etc.).
Sube los archivos de PrestaShop (puedes hacerlo por FTP o con el Administrador de Archivos de DirectAdmin).

Paso 2: Comprueba los permisos

Selecciona todos los archivos en public_html.
Pon permisos 755 a las carpetas y 644 a los archivos.
Asegúrate de que la propiedad de los archivos es tu usuario de DirectAdmin (suele ser automático).

Paso 3: Crea la base de datos correctamente

En "Administrador de MySQL", crea una base de datos nueva.
Crea un usuario y asígnale todos los privilegios.
Anota el nombre completo de la base de datos, el usuario y la contraseña.

Paso 4: Instala PrestaShop

Ejecuta el instalador desde tu navegador (ej: tudominio.com/install).
Introduce los datos de la base de datos que creaste.
Si te da error de memoria, modifica config/defines.inc.php como te explicamos antes.

Paso 5: Elimina la carpeta de instalación

Después de instalar, es obligatorio eliminar la carpeta /install del servidor. Si no lo haces, PrestaShop puede dar errores de seguridad o no funcionar correctamente.

Problemas específicos con versiones de PrestaShop

Dependiendo de la versión de PrestaShop que uses, el error prestashop directadmin puede variar ligeramente.

PrestaShop 1.7.x

Esta versión es bastante estable, pero tiene un problema conocido con el autoloader de Composer. Si ves un error de "Class not found", puede ser que los archivos de vendor no se hayan subido correctamente.

Solución: Sube de nuevo la carpeta vendor completa. Si usas FTP, asegúrate de subirla en modo binario (no ASCII) para que no se corrompan los archivos.

PrestaShop 8.x

Las versiones más recientes requieren PHP 7.3 o superior. Si tu DirectAdmin tiene una versión de PHP inferior, la instalación fallará al principio. Además, necesitan la extensión allow_url_fopen activada.

Solución: En el selector de PHP de DirectAdmin, busca la opción allow_url_fopen y actívala.

Preguntas frecuentes (FAQ)

¿Puedo instalar PrestaShop en una subcarpeta de DirectAdmin?

Sí, perfectamente. Solo tienes que crear una subcarpeta en public_html (por ejemplo, public_html/tienda) y subir los archivos ahí. El proceso es el mismo, pero la URL de acceso será tudominio.com/tienda.

¿Qué hago si veo un error 500 después de la instalación?

Un error 500 suele estar relacionado con el archivo .htaccess o con los permisos. Prueba a renombrar el .htaccess y luego a regenerarlo desde el panel de administración.

¿Cómo sé qué versión de PHP tengo en DirectAdmin?

Puedes verlo en el "PHP Version Selector" o creando un archivo info.php en tu servidor con el contenido <?php phpinfo(); ?> y abriéndolo en el navegador.

¿Es necesario usar SSL (HTTPS) para instalar PrestaShop?

No es obligatorio, pero es altamente recomendable para una tienda online. De hecho, PrestaShop puede dar avisos si no tienes SSL activo. En DirectAdmin, puedes activar un certificado SSL gratuito desde la sección "SSL Certificates".

¿Qué hago si el instalador se queda cargando sin avanzar?

Esto suele deberse a un problema de memoria o a que el servidor está tardando demasiado en procesar. Aumenta el memory_limit y prueba de nuevo. Si persiste, contacta con tu proveedor de hosting.

Consejos finales para evitar problemas futuros

Una vez que hayas resuelto el error de instalación, te recomiendo seguir estos consejos para que tu tienda funcione sin sobresaltos:

Mantén PrestaShop actualizado: Las actualizaciones corrigen errores y vulnerabilidades de seguridad.
Haz copias de seguridad periódicas: DirectAdmin tiene una herramienta de backup, pero también puedes usar el panel de PrestaShop.
No instales módulos de fuentes dudosas: Pueden generar conflictos con el núcleo de PrestaShop y provocar errores.
Monitoriza el espacio en disco: Un disco lleno puede causar errores extraños de escritura.

[INFO] Recuerda que, si tu panel de control es Syspanel (en lugar de DirectAdmin), el puerto de acceso es el 2106. Aunque la interfaz sea diferente, muchos de los conceptos y soluciones que hemos visto aquí son aplicables, especialmente los relacionados con PHP y MySQL.

Conclusión

Resolver un error prestashop directadmin no es una misión imposible. Con un enfoque metódico y siguiendo los pasos que hemos detallado, la mayoría de los problemas se solucionan en cuestión de minutos. La clave está en verificar los requisitos del servidor, comprobar los permisos de los archivos y asegurarse de que la base de datos esté bien configurada.

Si después de todo esto sigues teniendo problemas, no dudes en contactar con el soporte de tu hosting. Muchas veces, el problema está en la configuración general del servidor, algo que solo ellos pueden modificar.

Recuerda que instalar prestashop directadmin es el primer paso para crear tu tienda online, y una vez superado, tendrás una plataforma robusta y profesional para vender tus productos. ¡Mucho ánimo con tu proyecto!