Errores instalación PrestaShop: Soluciones paso a paso

Instalar PrestaShop puede parecer una tarea sencilla, pero a menudo surgen problemas que pueden desanimar incluso a los usuarios más pacientes. Desde errores de conexión a la base de datos hasta problemas con los permisos de archivos, los fallos son más comunes de lo que imaginas. En esta guía extensa, te explicaré los errores más frecuentes al instalar PrestaShop y, lo más importante, cómo solucionarlos paso a paso.

[INFO] Este artículo está pensado para usuarios sin experiencia técnica. Si te encuentras con un error, respira hondo y sigue las soluciones que te proponemos. La mayoría de los problemas tienen una solución sencilla.

Error 1: "No se puede conectar a la base de datos"

Este es, sin duda, el error más común durante la instalación de PrestaShop. Aparece cuando el sistema no logra comunicarse con MySQL o MariaDB.

¿Por qué ocurre?

Las causas más habituales son:

El nombre de la base de datos, el usuario o la contraseña son incorrectos.
El servidor de base de datos (normalmente localhost) no es accesible.
El usuario de la base de datos no tiene permisos suficientes.

Solución paso a paso

Verifica los datos de conexión: Asegúrate de que el nombre de la base de datos, el usuario y la contraseña sean exactamente los que creaste en tu panel de control (cPanel, Syspanel, etc.). Un simple error tipográfico puede causar el fallo.
Comprueba el servidor de base de datos: En la mayoría de los casos, el servidor es localhost. Sin embargo, en algunos entornos compartidos puede ser diferente (por ejemplo, mysql.tudominio.com). Revisa la información en tu panel de hosting.
Revisa los permisos del usuario: En tu panel de administración de bases de datos, asegúrate de que el usuario tenga todos los privilegios sobre la base de datos. En Syspanel, puedes gestionar esto desde la sección "Bases de datos".

[TIP] Si usas Syspanel, recuerda que el acceso a tu panel de hosting es a través del puerto 2106 (ejemplo: tudominio.com:2106). Allí podrás crear y gestionar tus bases de datos fácilmente.

Error 2: "Permisos de archivos incorrectos"

PrestaShop necesita permisos específicos para que ciertos archivos y carpetas sean modificables durante la instalación y el funcionamiento.

¿Por qué ocurre?

Los permisos 644 para archivos y 755 para carpetas son los estándar. Si están mal configurados, el instalador no podrá escribir archivos de configuración o crear carpetas temporales.

Solución paso a paso

Conéctate a tu servidor por FTP (FileZilla, por ejemplo) o usa el administrador de archivos de tu panel.
Selecciona la carpeta raíz de PrestaShop (normalmente public_html o www).
Establece los permisos correctos:
- Archivos: 644
- Carpetas: 755
- Archivos específicos como config/settings.inc.php pueden necesitar 777 temporalmente durante la instalación (luego debes cambiarlos a 644).
En Syspanel, puedes usar la opción "Permisos de archivos" desde el administrador de archivos para hacerlo de forma visual.

[WARNING] No dejes permisos 777 después de la instalación. Es un riesgo de seguridad. Cámbialos a 644 en cuanto termines.

Error 3: "La extensión PHP no está habilitada"

PrestaShop requiere varias extensiones de PHP para funcionar. Si alguna falta, la instalación se detendrá.

Extensiones necesarias

PDO y pdo_mysql
gd (para imágenes)
curl
json
mbstring
openssl
zip y fileinfo

Solución paso a paso

Accede a tu panel de hosting (cPanel, Syspanel, etc.).
Busca la sección "PHP" o "Selector de versiones de PHP".
Habilita las extensiones marcando las casillas correspondientes.
Guarda los cambios y reinicia el servicio PHP si es necesario.

[INFO] En Syspanel, puedes gestionar las extensiones PHP desde "Configuración PHP" dentro del panel de administración. Asegúrate de tener PHP 7.4 o superior (PrestaShop 8.x recomienda PHP 8.0+).

Error 4: "La memoria PHP es insuficiente"

PrestaShop necesita un mínimo de 128 MB de memoria PHP, pero 256 MB o más es recomendable.

¿Por qué ocurre?

El límite de memoria está configurado bajo en el archivo php.ini o en el panel de hosting.

Solución paso a paso

Aumenta el límite de memoria:
- Si tienes acceso a php.ini, busca memory_limit y cámbialo a 256M o 512M.
- En cPanel, usa "Seleccionar versión de PHP" y ajusta el valor.
- En Syspanel, ve a "Configuración PHP" y modifica el parámetro memory_limit.
Si no puedes editar php.ini, crea un archivo php.ini en la raíz de PrestaShop con el siguiente contenido:
```
memory_limit = 256M
max_execution_time = 600
upload_max_filesize = 64M
post_max_size = 64M
```
Reinicia el servidor web si es necesario (o espera unos minutos).

Error 5: "El tiempo de ejecución se ha agotado"

Durante la instalación, especialmente si tienes muchos módulos o una base de datos grande, el proceso puede exceder el tiempo límite.

Solución paso a paso

Aumenta el max_execution_time:
- En php.ini: max_execution_time = 600
- En el archivo .htaccess (si está permitido): php_value max_execution_time 600
Si usas Syspanel, modifica este valor desde "Configuración PHP".
También puedes añadir al inicio del archivo config/settings.inc.php (si ya existe) la línea:
```
ini_set('max_execution_time', 600);
```

[TIP] Si el error persiste, prueba a instalar PrestaShop en modo "desarrollador" o desactivando temporalmente algunos módulos.

Error 6: "El directorio de instalación no se puede eliminar"

Después de la instalación, PrestaShop te pedirá que elimines la carpeta install por seguridad. A veces, por permisos o por estar en uso, no se puede borrar.

Solución paso a paso

Conéctate por FTP y navega hasta la raíz de PrestaShop.
Elimina la carpeta install manualmente (arrastra a la papelera o usa "Eliminar").
Si no puedes, cambia los permisos de la carpeta a 777 temporalmente, bórrala y luego restaura los permisos.
En Syspanel, usa el administrador de archivos para eliminarla directamente.

[WARNING] No olvides renombrar o eliminar la carpeta admin por defecto para evitar accesos no autorizados. Cambia su nombre a algo único.

Error 7: "Problemas con el archivo .htaccess"

Un .htaccess mal configurado puede provocar errores 500 o páginas en blanco.

Solución paso a paso

Genera un nuevo .htaccess desde el panel de administración de PrestaShop (una vez instalado) en "Configuración de SEO y URLs".

Si no puedes acceder, crea uno básico con el siguiente contenido:

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . index.php [L]
</IfModule>

Asegúrate de que el módulo mod_rewrite esté activado en tu servidor Apache. En Syspanel, esto se configura desde "Servicios Web".

Preguntas Frecuentes (FAQ)

¿Qué versión de PHP necesito para PrestaShop 8?

PrestaShop 8 requiere PHP 7.4 como mínimo, pero se recomienda PHP 8.0 o 8.1 para mejor rendimiento y seguridad.

¿Puedo instalar PrestaShop en un servidor Windows?

Sí, pero es más complicado. La mayoría de los hosting compartidos usan Linux, que es el entorno ideal. Si usas Windows, necesitarás configurar IIS y PHP manualmente.

¿Por qué veo una página en blanco después de la instalación?

Esto suele deberse a un error PHP. Activa la visualización de errores editando config/defines.inc.php y cambiando _PS_MODE_DEV_ a true. También revisa los logs del servidor.

¿Cómo accedo a Syspanel para gestionar mi hosting?

Syspanel se accede a través de tudominio.com:2106. Allí podrás gestionar bases de datos, archivos, PHP y más.

¿Es necesario tener conocimientos técnicos para instalar PrestaShop?

No, pero ayuda. Con esta guía y un poco de paciencia, cualquier persona puede hacerlo. Si te atascas, contacta con el soporte de tu hosting.

Consejos finales para una instalación exitosa

Descarga siempre la última versión estable desde el sitio oficial de PrestaShop.
Realiza una copia de seguridad de tu base de datos y archivos antes de cualquier modificación.
Usa un subdominio para pruebas (por ejemplo, tienda.tudominio.com) antes de instalar en la raíz.
Si usas Syspanel, recuerda que el puerto 2106 es tu puerta de entrada para la gestión técnica.

[INFO] La instalación de PrestaShop no tiene por qué ser un dolor de cabeza. Con estos errores comunes y sus soluciones, estarás preparado para cualquier contratiempo. ¡Ánimo y a crear tu tienda online!

Esperamos que esta guía te haya sido de gran ayuda. Si tienes más dudas, recuerda que nuestro equipo de soporte está disponible para ayudarte. ¡Buena suerte con tu PrestaShop!