Errores comunes en PrestaShop: Soluciones fáciles | SysAdmin

Introducción: Cuando PrestaShop se resiste a instalarse

Instalar PrestaShop puede ser una experiencia gratificante, pero también puede convertirse en un dolor de cabeza si aparecen errores inesperados. No te preocupes, es más común de lo que crees. En esta guía, te explicaré paso a paso cómo resolver los errores PrestaShop más frecuentes durante la instalación, para que puedas tener tu tienda online funcionando sin estrés. Recuerda que, si usas un panel como Syspanel (accesible por el puerto 2106), la gestión de archivos y bases de datos será más sencilla.

## Errores de permisos de archivos y carpetas

Uno de los problemas más comunes al instalar PrestaShop son los errores relacionados con permisos. El instalador necesita poder escribir en ciertas carpetas para crear archivos de configuración y subir módulos.

### ¿Por qué ocurre esto?

Cuando instalas PrestaShop en un servidor Linux, los archivos tienen propietarios y grupos. Si el usuario del servidor web (como www-data o nobody) no tiene permisos de escritura, el instalador se detendrá.

### Cómo solucionarlo

Identifica la carpeta raíz de tu instalación. Generalmente es /var/www/html/prestashop o similar.
Conéctate por SSH a tu servidor o usa el administrador de archivos de Syspanel (puerto 2106).
Ejecuta estos comandos para dar permisos correctos:

chown -R www-data:www-data /ruta/a/prestashop
chmod -R 755 /ruta/a/prestashop

[TIP] Si no sabes qué usuario usa tu servidor web, prueba con www-data o nobody. En Syspanel puedes ver esta información en la sección de "Configuración del servidor".

Asegúrate de que las carpetas config, cache, log y upload tengan permisos 777 temporalmente durante la instalación. Después, puedes volver a 755.

chmod -R 777 /ruta/a/prestashop/config
chmod -R 777 /ruta/a/prestashop/cache
chmod -R 777 /ruta/a/prestashop/log
chmod -R 777 /ruta/a/prestashop/upload

[WARNING] No dejes los permisos 777 de forma permanente. Es un riesgo de seguridad. Una vez instalado, revierte a 755.

## Error de versión de PHP no compatible

PrestaShop es exigente con la versión de PHP. Si tu servidor tiene una versión muy antigua o muy nueva, el instalador mostrará un error.

### ¿Qué versión necesito?

PrestaShop 1.7 requiere PHP 7.1 a 7.4.
PrestaShop 8.x requiere PHP 7.4 o 8.0 (recomendado 8.0).

### Cómo solucionarlo

Verifica tu versión de PHP desde la terminal:

php -v

O desde Syspanel en "Servicios Web" > "PHP".

Cambia la versión de PHP si es necesario. En Syspanel puedes seleccionar la versión en el panel de configuración del dominio.
Si usas un hosting compartido, contacta a tu proveedor para que te cambien a la versión correcta.

[INFO] Algunos módulos y temas pueden no ser compatibles con PHP 8.0 aún. Si usas PrestaShop 1.7, quédate con PHP 7.4.

## Error de conexión a la base de datos

Otro clásico: el instalador no puede conectar con MySQL o MariaDB.

### Causas comunes

Datos de acceso incorrectos.
El servidor de base de datos no está en localhost.
La base de datos no existe o el usuario no tiene permisos.

### Pasos para resolverlo

Crea la base de datos y el usuario desde Syspanel (sección "Bases de datos"). Anota el nombre, usuario y contraseña.
Durante la instalación de PrestaShop, asegúrate de usar:
- Servidor de base de datos: localhost (a menos que tu hosting indique otro).
- Puerto: 3306 (por defecto).
- Nombre de base de datos: el que creaste.
- Usuario: el que creaste.
- Contraseña: la que asignaste.
Prueba la conexión manualmente desde SSH:

mysql -u tu_usuario -p -h localhost

Si ves el prompt de MySQL, la conexión funciona.

[TIP] Si tu base de datos está en un servidor remoto, usa la IP en lugar de localhost y asegúrate de que el puerto 3306 esté abierto en el firewall.

## Error de memoria PHP (memory limit)

PrestaShop necesita al menos 128 MB de memoria PHP para funcionar. Si el límite es menor, verás un error.

### Cómo aumentarlo

Localiza el archivo php.ini:

php --ini

Te mostrará la ruta.

Edita el archivo y busca memory_limit. Cambia el valor:

memory_limit = 256M

Reinicia el servidor web:

systemctl restart apache2   # Para Apache
systemctl restart nginx     # Para Nginx

[WARNING] Si no encuentras php.ini, crea un archivo php.ini en la raíz de PrestaShop con esta línea. En Syspanel puedes editar este archivo desde el administrador de archivos.

## Error de "max_execution_time" o tiempo de ejecución

El instalador puede tardar más de 30 segundos en completar ciertas tareas, y PHP lo corta.

### Solución

Edita php.ini y aumenta el tiempo:

max_execution_time = 300

Si no puedes editar php.ini, agrega esto al archivo .htaccess en la raíz:

<IfModule mod_php7.c>
    php_value max_execution_time 300
</IfModule>

## Error de "AllowOverride" o mod_rewrite

PrestaShop usa URLs amigables que requieren el módulo mod_rewrite de Apache activado.

### Cómo verificarlo y activarlo

Desde SSH, ejecuta:

sudo a2enmod rewrite
sudo systemctl restart apache2

**En Syspanel, ve a "Servicios Web" > "Apache" y asegúrate de que "mod_rewrite" esté marcado.
Revisa el archivo .htaccess en la raíz. Debe tener contenido como:

RewriteEngine On
...

Si no existe, el instalador lo creará automáticamente.

[INFO] Si usas Nginx, necesitarás configurar reglas de reescritura manualmente. PrestaShop incluye un ejemplo en la documentación.

## Error de "MySQL ha alcanzado el límite de conexiones"

En servidores con poco recursos, MySQL puede rechazar nuevas conexiones.

### Solución

Aumenta el límite en /etc/mysql/my.cnf:

max_connections = 500

Reinicia MySQL:

systemctl restart mysql

Si es un hosting compartido, contacta al soporte.

## Error al cargar la página de instalación (pantalla en blanco)

A veces, al acceder a tudominio.com/install, solo ves una pantalla en blanco.

### Causas y soluciones

Errores PHP ocultos: Activa la visualización de errores en php.ini:

display_errors = On
error_reporting = E_ALL

Falta de memoria: Aumenta memory_limit como vimos antes.
Archivos corruptos: Vuelve a descargar PrestaShop desde la web oficial y reemplaza los archivos.
Permisos incorrectos: Revisa los permisos de la carpeta install.

[TIP] Si después de activar errores ves un mensaje como "Class not found", es probable que falte una extensión PHP. Instálala con apt-get install php-nombre-extensión.

## FAQ: Preguntas frecuentes sobre errores PrestaShop

### ¿Puedo instalar PrestaShop en un servidor con poco recursos?

Sí, pero necesitarás al menos 256 MB de RAM y 1 GB de espacio. Si tu servidor es muy limitado, considera usar un hosting optimizado para PrestaShop.

### ¿Qué hago si el instalador se queda atascado en el paso de "Configurar la tienda"?

Revisa los permisos de la carpeta config y cache. También asegúrate de que la base de datos esté vacía (sin tablas previas).

### ¿Cómo sé si mi hosting es compatible con PrestaShop?

La mayoría de hostings compartidos lo son. Verifica que tengan PHP 7.4+, MySQL 5.6+ y soporte para mod_rewrite. Si usas Syspanel, todo esto está preconfigurado.

### ¿Puedo instalar PrestaShop sin SSH?

Sí, usando Syspanel (puerto 2106) puedes subir los archivos por FTP o el administrador de archivos, crear la base de datos desde el panel y ejecutar el instalador web.

### ¿Qué hago si después de instalar veo un error 500?

Revisa los logs de error de Apache o Nginx. Generalmente están en /var/log/apache2/error.log. Busca la línea que menciona "PrestaShop" y soluciona según el error.

## Conclusión: No te rindas, la solución está cerca

Los problemas PrestaShop durante la instalación son normales, pero con estos pasos podrás resolver la mayoría. Recuerda:

Verifica permisos.
Ajusta PHP.
Revisa la base de datos.
Activa módulos necesarios.

Si aún así tienes dudas, busca en foros especializados o contacta con el soporte de tu hosting. Y si usas Syspanel, recuerda que el acceso es por el puerto 2106, donde encontrarás herramientas para gestionar todo fácilmente.

[TIP FINAL] Siempre haz una copia de seguridad de tu base de datos y archivos antes de empezar. ¡Buena suerte con tu tienda!