Errores comunes en instalación de PrestaShop | Soluciones

Instalar PrestaShop puede parecer sencillo, pero a menudo surgen errores que frustran a los usuarios con poca experiencia técnica. En esta guía extensa, tipo FAQ, te explicamos los fallos más comunes durante la instalación, sus causas y cómo solucionarlos paso a paso. Todo explicado de forma clara, sin tecnicismos innecesarios y pensando en que puedas resolverlo por ti mismo.

Errores de permisos de archivos y carpetas

Uno de los errores más repetidos al instalar PrestaShop está relacionado con los permisos de los archivos y directorios en el servidor. El sistema necesita poder escribir en ciertas carpetas para crear archivos de configuración, logs o imágenes temporales.

¿Por qué ocurre?

Cuando el usuario del servidor web (por ejemplo, www-data en Apache o nginx) no tiene permisos de escritura sobre las carpetas de PrestaShop, el instalador se detiene o muestra mensajes como "No se puede escribir en la carpeta config".

Solución paso a paso

Accede a tu servidor por SSH o al panel de control de hosting (como Syspanel, que recuerda que se accede por el puerto 2106).
Navega hasta la carpeta donde has subido PrestaShop, normalmente en /var/www/html/ o /home/usuario/web/.

Otorga permisos correctos con estos comandos (ajusta la ruta a tu caso):

chmod -R 755 /ruta/a/prestashop
chmod -R 777 /ruta/a/prestashop/cache
chmod -R 777 /ruta/a/prestashop/log
chmod -R 777 /ruta/a/prestashop/img
chmod -R 777 /ruta/a/prestashop/mails
chmod -R 777 /ruta/a/prestashop/modules
chmod -R 777 /ruta/a/prestashop/themes
chmod -R 777 /ruta/a/prestashop/translations
chmod -R 777 /ruta/a/prestashop/upload
chmod -R 777 /ruta/a/prestashop/download

Si tu servidor usa Syspanel, desde el gestor de archivos del panel puedes cambiar permisos fácilmente: selecciona la carpeta y elige "Permisos 755" para directorios y "644" para archivos.

[TIP] No dejes permisos 777 en toda la instalación una vez finalizada. Solo las carpetas mencionadas necesitan escritura. El resto puede quedar en 755.

Error de versión de PHP incompatible

PrestaShop tiene requisitos de PHP muy concretos. Si tu servidor tiene una versión demasiado antigua o demasiado nueva, el instalador lanzará un error de compatibilidad.

¿Por qué ocurre?

PrestaShop 1.7 requiere PHP 7.1 a 8.0 (según la versión). Con PHP 8.1 o superior, muchas funciones obsoletas dejan de funcionar y el instalador falla.

Solución paso a paso

Verifica la versión de PHP de tu servidor. Puedes hacerlo desde la terminal con:
```
php -v
```
O desde el panel de control (Syspanel, cPanel, etc.) en la sección "Selector de PHP".
Si tu versión no es compatible, cambia a una que sí lo sea. En Syspanel, ve a "Configuración del servidor" > "Versión de PHP" y elige una versión entre 7.4 y 8.0.
Si usas un hosting compartido, contacta al soporte para que te cambien la versión de PHP.
Reinicia el servidor web si es necesario (Apache o Nginx).

[WARNING] No instales PrestaShop con PHP 8.1 o superior a menos que uses una versión muy reciente de PrestaShop (1.7.8+). Siempre revisa la documentación oficial.

Error de conexión con la base de datos

Durante la instalación, PrestaShop necesita crear las tablas en una base de datos MySQL o MariaDB. Si los datos de conexión son incorrectos o la base de datos no existe, aparece un error.

¿Por qué ocurre?

El nombre de la base de datos, usuario o contraseña están mal escritos.
El usuario no tiene privilegios para crear tablas.
El servidor de base de datos no está accesible desde el hosting.

Solución paso a paso

Accede a tu panel de control (por ejemplo, Syspanel en puerto 2106) y ve a "Bases de datos".
Crea una nueva base de datos y un usuario con todos los privilegios sobre ella.
Anota exactamente:
- Nombre de la base de datos
- Usuario
- Contraseña
- Servidor (normalmente "localhost")
Durante la instalación de PrestaShop, introduce estos datos exactamente como los copiaste.
Si el error persiste, prueba a conectarte manualmente desde phpMyAdmin o la terminal para confirmar que los datos son correctos.

[INFO] Algunos hosting usan un prefijo en el nombre de la base de datos (ej: usuario_bd). Asegúrate de incluirlo completo.

Error de "500 Internal Server Error" o página en blanco

Este error es muy genérico y puede deberse a múltiples causas, pero en instalaciones de PrestaShop suele estar relacionado con el archivo .htaccess o con la memoria PHP.

¿Por qué ocurre?

El archivo .htaccess generado por PrestaShop tiene reglas incorrectas.
El límite de memoria de PHP es demasiado bajo.
Algún módulo o tema incompatible se activa durante la instalación.

Solución paso a paso

Renombra temporalmente el archivo .htaccess en la raíz de PrestaShop:
```
mv .htaccess .htaccess_old
```
Si el error desaparece, el problema está en el .htaccess. Puedes regenerarlo desde el panel de administración de PrestaShop (una vez instalado) en "Configuración" > "SEO y URLs" > "Guardar".
Aumenta el límite de memoria de PHP. Edita el archivo php.ini o desde Syspanel en "Configuración de PHP" y cambia:
```
memory_limit = 256M
max_execution_time = 300
```
Si usas un hosting compartido, pide al soporte que aumenten estos valores.
Desactiva todos los módulos no esenciales temporalmente desde la base de datos (consulta con tu técnico si no sabes hacerlo).

[WARNING] No borres el .htaccess original sin hacer copia de seguridad. Puede contener reglas de seguridad importantes.

Error de "No se puede escribir el archivo settings.inc.php"

Este es un error típico en la instalación. PrestaShop intenta crear un archivo de configuración en /config/settings.inc.php pero no tiene permisos.

¿Por qué ocurre?

La carpeta config no tiene permisos de escritura para el usuario del servidor web.

Solución paso a paso

Desde la terminal o el panel de archivos de Syspanel, navega a la carpeta config dentro de tu instalación de PrestaShop.
Cambia los permisos de la carpeta a 777:
```
chmod 777 config
```
Si el archivo settings.inc.php ya existe, asegúrate de que también tenga permisos 777 durante la instalación. Después de instalar, puedes dejarlo en 644.
Vuelve a ejecutar el instalador desde el principio (a veces hay que borrar los datos previos).

[TIP] Algunos servidores requieren que el propietario de los archivos sea el mismo que el del servidor web. Si usas Syspanel, puedes cambiar el propietario desde el gestor de archivos.

Error de "La extensión PHP cURL no está activada"

PrestaShop necesita varias extensiones de PHP para funcionar correctamente. Una de las más importantes es cURL, que permite conexiones externas (pagos, módulos, etc.).

¿Por qué ocurre?

El servidor tiene deshabilitada la extensión cURL en la configuración de PHP.

Solución paso a paso

Desde el panel de control (Syspanel, cPanel, etc.), busca la sección "Extensiones PHP" o "Módulos PHP".
Activa la extensión curl.
Si no tienes acceso a esa opción, contacta al soporte de tu hosting y pídeles que activen cURL.
Para verificar si está activa, crea un archivo info.php en la raíz con:
```
<?php phpinfo(); ?>
```
Luego accede a tudominio.com/info.php y busca "curl". Si no aparece, no está activa.
Borra el archivo info.php después de la comprobación por seguridad.

[INFO] Otras extensiones necesarias son: gd, json, mbstring, openssl, pdo_mysql, zip. Actívalas todas si es posible.

Error de "Tiempo de ejecución excedido" durante la instalación

Si tu servidor es lento o tiene recursos limitados, la instalación puede superar el tiempo máximo de ejecución de PHP y aparecer un error de timeout.

¿Por qué ocurre?

El valor max_execution_time en php.ini es demasiado bajo (normalmente 30 segundos).

Solución paso a paso

Edita el archivo php.ini de tu servidor (desde Syspanel puedes hacerlo en "Configuración de PHP").
Cambia o añade:
```
max_execution_time = 600
```
Si no puedes editar php.ini, crea un archivo .user.ini en la raíz de PrestaShop con esa línea.
También puedes intentar aumentar el tiempo desde el instalador de PrestaShop: algunos hosting permiten modificar estos valores temporalmente.

[TIP] Si el error persiste, prueba a instalar PrestaShop desde la línea de comandos (CLI) con php install/index_cli.php que no tiene límite de tiempo.

Error de "No se encuentra el archivo de idioma"

Durante la instalación, PrestaShop descarga los paquetes de idioma. Si el servidor no puede conectarse a internet o hay un firewall, falla.

¿Por qué ocurre?

Falta de conexión a internet en el servidor.
El puerto 443 (HTTPS) está bloqueado.
Los repositorios de PrestaShop están caídos.

Solución paso a paso

Verifica que tu servidor tenga acceso a internet. Puedes probar con:
```
ping google.com
```
Si usas un firewall, permite las conexiones salientes por los puertos 80 y 443.
Durante la instalación, selecciona "Saltar este paso" o "No descargar paquetes de idioma ahora". Puedes instalarlos después desde el panel de administración.
También puedes descargar manualmente el paquete de idioma desde el sitio oficial de PrestaShop y subirlo a la carpeta /translations.

[WARNING] No instales PrestaShop en un servidor sin acceso a internet si planeas usar módulos o temas de terceros. La tienda dependerá de conexiones externas.

Preguntas frecuentes (FAQ) sobre instalación de PrestaShop

¿Puedo instalar PrestaShop en un subdirectorio?

Sí, pero ten en cuenta que las URLs se complican. Es mejor instalarlo en la raíz del dominio (ej: tudominio.com). Si lo haces en un subdirectorio (ej: tudominio.com/tienda), asegúrate de configurar bien las rutas en el instalador.

¿Qué hago si el instalador se queda en "Cargando..."?

Normalmente es un problema de memoria PHP o de permisos. Aumenta memory_limit a 256M y verifica los permisos de las carpetas. También prueba a desactivar temporalmente el firewall de tu servidor.

¿Es necesario tener SSL durante la instalación?

No es obligatorio, pero muy recomendable. Si tu dominio no tiene SSL, puedes instalar sin HTTPS. Luego, una vez funcione, activa el certificado desde el panel de administración.

¿Puedo instalar PrestaShop usando Syspanel?

Sí, Syspanel (accesible por puerto 2106) tiene un instalador de aplicaciones que te permite instalar PrestaShop con un clic. Busca "Instalador de aplicaciones" en el menú y selecciona PrestaShop. Esto evita muchos errores manuales.

¿Qué versión de PrestaShop debo elegir?

Para principiantes, la versión 1.7.x es la más estable y con mejor soporte. Evita versiones muy antiguas (1.6) o muy recientes (8.x) si no tienes experiencia.

¿Por qué mi instalación da error de "500" después de subir archivos por FTP?

Probablemente los permisos de los archivos subidos no son correctos. Usa un cliente FTP que permita mantener permisos o cámbialos después de subir con los comandos mencionados al inicio.

Conclusión

La instalación de PrestaShop puede presentar varios obstáculos, pero la mayoría tienen solución siguiendo pasos lógicos y verificando los requisitos del servidor. Recuerda siempre:

Revisar los permisos de carpetas.
Usar la versión de PHP correcta.
Tener una base de datos bien configurada.
Aumentar los límites de PHP si es necesario.

Si después de todo sigues teniendo problemas, no dudes en consultar la documentación oficial de PrestaShop o pedir ayuda en foros especializados. Con paciencia y esta guía, tendrás tu tienda online funcionando en poco tiempo.

[INFO] Si usas Syspanel, aprovecha su instalador automático. Te ahorrará la mayoría de estos errores y te permitirá tener PrestaShop listo en minutos. Recuerda que el acceso es por el puerto 2106.