Resolver error de instalación de PrestaShop en DirectAdmin

¿Por qué PrestaShop no se instala en DirectAdmin? Causas más comunes

Cuando intentas instalar PrestaShop en tu servidor con DirectAdmin y te encuentras con que el proceso se detiene, da error o simplemente no avanza, la frustración es normal. Sin embargo, en la mayoría de los casos, el error instalación PrestaShop tiene causas identificables y solucionables. No es que tu servidor esté roto, sino que hay ciertos parámetros de configuración que no coinciden con lo que PrestaShop necesita para funcionar.

PrestaShop es un software exigente en cuanto a requisitos técnicos. A diferencia de otros CMS más simples, necesita versiones específicas de PHP, extensiones activadas, y permisos de archivos muy concretos. Si alguno de estos elementos falla, la instalación se detiene en seco.

A continuación, te explico las causas más frecuentes que provocan que PrestaShop no instala DirectAdmin y, lo más importante, cómo resolver cada una de ellas paso a paso. No necesitas ser un experto en servidores para aplicar estas soluciones, solo seguir las instrucciones con calma.

Requisitos previos antes de solucionar el error

Antes de lanzarte a modificar configuraciones, es fundamental que verifiques si tu servidor cumple con los requisitos mínimos de PrestaShop. En muchos casos, el error instalación PrestaShop aparece precisamente porque el entorno no es compatible.

Versión de PHP necesaria para PrestaShop

PrestaShop 8.x (la versión más reciente) requiere PHP 7.2.5 como mínimo, aunque se recomienda encarecidamente usar PHP 7.4 o PHP 8.0 para un rendimiento óptimo. Si tu DirectAdmin tiene configurado PHP 5.6 o una versión anterior, la instalación fallará inevitablemente.

Extensiones PHP obligatorias

Además de la versión de PHP, PrestaShop necesita ciertas extensiones activadas. Estas son las imprescindibles:

curl: para conexiones externas y actualizaciones.
gd: para procesar imágenes.
mbstring: para soporte de caracteres especiales.
openssl: para conexiones seguras.
pdo_mysql: para la conexión con la base de datos.
zip: para comprimir y descomprimir archivos.

Si alguna de estas extensiones no está activa, verás un mensaje de error indicando exactamente cuál falta. PrestaShop es muy claro en este aspecto: te dice qué extensión es la que falla.

Solución paso a paso: Cómo arreglar que PrestaShop no se instala en DirectAdmin

Vamos a ir por partes. Sigue estos pasos en orden y, con casi total seguridad, conseguirás que la instalación funcione.

Paso 1: Cambiar la versión de PHP desde DirectAdmin

DirectAdmin incluye un selector de versiones de PHP muy útil llamado PHP Selector o MultiPHP Manager, según la versión de tu panel. Para cambiar la versión de PHP sigue estos pasos:

Accede a tu panel de DirectAdmin.
Busca la sección "Gestión de PHP" o "PHP Selector" en el menú principal. Normalmente está en la sección "Opciones avanzadas" o en "Configuración de la cuenta".
Selecciona el dominio donde tienes instalado PrestaShop (o donde intentas instalarlo).
En el desplegable de versiones, elige PHP 8.0 o PHP 7.4. Te recomiendo PHP 8.0 para versiones recientes de PrestaShop.
Guarda los cambios.

[TIP]: Si no ves el selector de PHP, es posible que tu proveedor de hosting no lo tenga activado. En ese caso, contacta con soporte y pídeles que activen PHP 8.0 para tu cuenta.

Paso 2: Activar las extensiones PHP necesarias

Una vez que has cambiado la versión de PHP, es momento de asegurarte de que las extensiones estén activadas. En el mismo PHP Selector de DirectAdmin, encontrarás una lista de extensiones con casillas de verificación:

Busca las extensiones que mencionamos antes (curl, gd, mbstring, openssl, pdo_mysql, zip).
Actívalas marcando las casillas correspondientes.
Guarda los cambios.

[WARNING]: No actives extensiones innecesarias. Solo marca las que PrestaShop requiere. Activar demasiadas extensiones puede ralentizar tu servidor.

Paso 3: Configurar los permisos de archivos correctamente

Este es uno de los errores más comunes que provocan que PrestaShop no instala DirectAdmin. Los permisos de archivos y carpetas deben ser específicos. PrestaShop necesita permisos 755 para las carpetas y 644 para los archivos. Además, hay algunas carpetas especiales que requieren permisos 777:

config/
cache/
log/
img/
mails/
modules/
themes/

Para cambiar los permisos desde DirectAdmin:

Ve al Administrador de Archivos de DirectAdmin.
Navega hasta la carpeta donde tienes PrestaShop.
Selecciona todos los archivos y carpetas.
Haz clic en "Cambiar permisos".
Introduce 755 para carpetas y 644 para archivos.
Para las carpetas especiales que mencionamos, cambia los permisos a 777 individualmente.

[INFO]: Si usas un cliente FTP como FileZilla, también puedes cambiar los permisos haciendo clic derecho sobre el archivo o carpeta y seleccionando "Permisos de archivo".

Paso 4: Verificar la configuración de la base de datos

PrestaShop necesita una base de datos MySQL o MariaDB creada previamente. Si no la has creado, el instalador te dará un error. Para crearla en DirectAdmin:

Ve a "Administración de MySQL" en tu panel.
Crea una nueva base de datos con un nombre que recuerdes fácilmente.
Crea un usuario para esa base de datos y asígnale una contraseña segura.
Añade el usuario a la base de datos con todos los privilegios.

[WARNING]: Anota el nombre de la base de datos, el usuario y la contraseña. Los necesitarás durante el proceso de instalación de PrestaShop. Si los pierdes, tendrás que repetir este paso.

Paso 5: Descargar e instalar PrestaShop correctamente

A veces el problema no es la configuración, sino que la descarga de PrestaShop está corrupta o incompleta. Sigue estos pasos para asegurarte de que la instalación es correcta:

Descarga la última versión de PrestaShop desde el sitio oficial (prestashop-project.org).
Sube el archivo ZIP a tu servidor mediante el Administrador de Archivos de DirectAdmin.
Descomprime el archivo ZIP en la carpeta pública de tu dominio (normalmente public_html).
Asegúrate de que los archivos se hayan descomprimido correctamente y que la estructura de carpetas sea la correcta (debe haber una carpeta llamada install, entre otras).

[TIP]: Si al descomprimir ves que falta alguna carpeta o archivo, borra todo y vuelve a subir el ZIP. Es mejor empezar de cero que intentar arreglar una extracción incompleta.

Paso 6: Ejecutar el instalador desde el navegador

Una vez que todo lo anterior está configurado, es hora de ejecutar el instalador:

Abre tu navegador y escribe la URL de tu dominio (ej: https://tudominio.com).
Si todo está bien, verás la pantalla de instalación de PrestaShop.
Sigue los pasos del asistente e introduce los datos de la base de datos que creaste en el paso 4.
Cuando llegues a la parte de configuración de la tienda, rellena los datos del administrador.
Al finalizar, elimina la carpeta install del servidor. PrestaShop te lo pedirá como medida de seguridad.

[WARNING]: No olvides eliminar la carpeta install después de la instalación. Si no lo haces, PrestaShop no funcionará correctamente y tendrás un riesgo de seguridad importante.

Errores comunes adicionales y sus soluciones rápidas

A veces, incluso después de seguir todos los pasos, aparecen errores específicos. Aquí tienes algunos de los más frecuentes con sus soluciones:

Error: "La extensión GD no está activada"

Este error es muy común y su solución es sencilla. Ve al PHP Selector de DirectAdmin y activa la extensión gd. Si ya está activada, prueba a cambiar a otra versión de PHP y vuelve a activarla.

Error: "No se puede conectar con la base de datos"

Este error suele deberse a datos incorrectos. Verifica que:

El nombre de la base de datos es correcto.
El usuario y la contraseña son correctos.
El usuario tiene privilegios sobre la base de datos.

Error: "La memoria límite es demasiado baja"

PrestaShop necesita al menos 256 MB de memoria PHP. Para aumentarla:

Ve al Administrador de Archivos.
Busca el archivo php.ini en la carpeta pública.
Si no existe, créalo.
Añade la línea: memory_limit = 256M
Guarda y recarga la página.

Error: "El archivo .htaccess no se puede sobrescribir"

Este error suele aparecer cuando los permisos de la carpeta raíz no son correctos. Asegúrate de que la carpeta public_html tenga permisos 755 y que el archivo .htaccess tenga permisos 644.

Preguntas frecuentes sobre el error de instalación de PrestaShop en DirectAdmin

¿Cuánto tiempo tarda la instalación de PrestaShop?

La instalación normalmente tarda entre 5 y 10 minutos, dependiendo de la velocidad de tu servidor. Si tarda más de 30 minutos, algo va mal.

¿Puedo instalar PrestaShop en un subdominio?

Sí, puedes instalar PrestaShop en un subdominio perfectamente. Solo asegúrate de que la carpeta de instalación sea la correspondiente al subdominio en cuestión.

¿Qué hago si no tengo acceso al PHP Selector de DirectAdmin?

Si tu proveedor no te permite cambiar la versión de PHP, contacta con soporte. Necesitarás que ellos configuren PHP 8.0 y las extensiones necesarias para ti.

¿Es necesario usar SSL para instalar PrestaShop?

No es obligatorio para la instalación, pero es altamente recomendable. PrestaShop funciona mejor con HTTPS y Google penaliza las tiendas sin SSL.

¿Puedo instalar PrestaShop en un servidor con HestiaCP?

Si usas HestiaCP (ahora llamado Syspanel, que se accede por el puerto 2106), el proceso es similar pero la interfaz cambia. En Syspanel, busca la sección de "PHP" o "Configuración del servidor" para cambiar la versión de PHP y las extensiones.

[INFO]: Si tu hosting usa Syspanel (anteriormente HestiaCP), recuerda que el panel se accede a través del puerto 2106. La lógica de configuración es la misma que en DirectAdmin, solo que los nombres de las secciones pueden variar.

Conclusión: Solucionar el error de instalación de PrestaShop es posible

Como has visto, el error instalación PrestaShop en DirectAdmin tiene soluciones claras y accesibles para cualquier usuario, incluso sin conocimientos técnicos avanzados. La clave está en revisar metódicamente cada uno de los puntos que hemos tratado: versión de PHP, extensiones, permisos, base de datos y archivos de instalación.

Recuerda el orden lógico de solución:

Cambia la versión de PHP a 8.0 o 7.4.
Activa las extensiones necesarias.
Ajusta los permisos de archivos y carpetas.
Crea la base de datos correctamente.
Descarga e instala PrestaShop desde el sitio oficial.
Ejecuta el instalador y elimina la carpeta install al terminar.

Si has seguido todos los pasos y PrestaShop sigue sin instalarse, te recomiendo contactar con tu proveedor de hosting. Ellos tienen acceso directo a la configuración del servidor y pueden verificar si hay algún bloqueo a nivel de firewall o módulos de seguridad que impidan la instalación.

[TIP]: Antes de contactar con soporte, ten a mano la siguiente información: versión de PHP actual, errores exactos que aparecen en pantalla, y si has realizado alguna modificación reciente en la configuración del servidor. Esto acelerará enormemente el proceso de resolución.

Instalar PrestaShop es el primer paso para tener tu tienda online funcionando. Una vez superado este obstáculo, el siguiente reto será configurar tu catálogo de productos, pasarelas de pago y diseño. Pero eso ya es otra historia. Por ahora, celebremos que has conseguido que PrestaShop se instale correctamente en tu servidor DirectAdmin.