Errores comunes al instalar PrestaShop en Syspanel y cómo solucionarlos

¡Hola! Soy tu técnico de soporte amigable. Si estás aquí es porque estás montando tu tienda online con PrestaShop y te has topado con algún error durante la instalación en tu Syspanel. No te preocupes, es más común de lo que crees. He preparado esta guía completa para que puedas resolver los problemas más típicos paso a paso.

Vamos a ello. Recuerda que el acceso a tu panel de control Syspanel se realiza a través de la URL tudominio.com:2106 (el puerto es el 2106). Allí gestionarás todo tu hosting.

Errores Comunes al Instalar PrestaShop y Cómo Solucionarlos con Syspanel

Antes de empezar, asegúrate de que tu hosting cumple con los requisitos mínimos de PrestaShop (PHP 7.4 o superior, MySQL 5.6 o superior, y suficiente memoria). Si tienes dudas, revisa la sección de "Requisitos del sistema" en la documentación oficial de PrestaShop o contacta con nuestro soporte.

1. Error de Conexión a la Base de Datos

Este es, sin duda, el error más frecuente. Aparece un mensaje como: "Error al conectar con la base de datos" o "No se puede seleccionar la base de datos".

Causa principal: Los datos de la base de datos (nombre, usuario, contraseña) son incorrectos o no tienes permisos suficientes.

Solución paso a paso:

Accede a Syspanel: Abre tu navegador y ve a tudominio.com:2106. Inicia sesión con tus credenciales de hosting.
Ve a la sección de Bases de Datos: Busca el menú "Base de Datos" o "MySQL". En Syspanel, suele estar en la barra lateral izquierda.
Crea una nueva base de datos (si no la tienes): Haz clic en "Añadir Base de Datos". Dale un nombre (ej: prestashop_db). Syspanel creará automáticamente un usuario con el mismo nombre y una contraseña aleatoria. Anota esta información exactamente como aparece.
Verifica los datos en tu instalación de PrestaShop:
- Durante la instalación, en el paso de "Configuración de la base de datos", asegúrate de que el Nombre de la base de datos, el Usuario y la Contraseña coinciden EXACTAMENTE con lo que creaste en Syspanel.
- Importante: El servidor de base de datos suele ser localhost o 127.0.0.1. No lo cambies a menos que tu hosting te indique lo contrario.
Prueba la conexión: Muchos instaladores de PrestaShop tienen un botón "¡Prueba la conexión!". Úsalo. Si falla, revisa que no hayas escrito mal la contraseña (es sensible a mayúsculas/minúsculas).

[TIP] Si olvidaste la contraseña de la base de datos, en Syspanel puedes ir a la sección "Base de Datos", seleccionar la base de datos y hacer clic en "Cambiar contraseña". Se generará una nueva. Recuerda actualizarla también en el archivo app/config/parameters.php de PrestaShop si ya lo habías instalado.

2. Error de Permisos de Archivos y Carpetas

PrestaShop necesita escribir en ciertos archivos y carpetas para funcionar (por ejemplo, para subir imágenes, generar caché o instalar módulos). Si no tiene permisos, verás errores como "No se puede escribir en la carpeta /cache" o "Error al crear el archivo de configuración".

Solución paso a paso:

Accede a Syspanel y ve a "Administrador de Archivos": Suelo estar en la sección "Web" o "Archivos". Busca la carpeta donde has subido PrestaShop (normalmente public_html o www).
Selecciona la carpeta raíz de PrestaShop: Haz clic derecho sobre la carpeta principal (ej: mi-tienda) y elige "Permisos de archivo".
Establece los permisos correctos: PrestaShop recomienda los siguientes permisos para la mayoría de sus carpetas:
- Carpetas (directorios): 755 (rwxr-xr-x)
- Archivos: 644 (rw-r--r--)
- Archivos especiales (como config/settings.inc.php): A veces necesitan 777 temporalmente durante la instalación, pero después deben volver a 644 o 444 por seguridad.
Aplica los cambios recursivamente: Asegúrate de marcar la opción "Aplicar a todos los archivos y subcarpetas" (Recursive). Esto es crucial.
Verifica carpetas específicas: Las carpetas cache, log, img, mails, modules, themes, translations, upload, download y sitemap deben tener permisos 755 o 777 (dependiendo de tu hosting). Si tienes dudas, pon 755 primero.

[WARNING] No dejes permisos 777 de forma permanente. Es un riesgo de seguridad. Úsalos solo temporalmente durante la instalación o para solucionar problemas, y luego revierte a 755 o 644.

3. Error de Versión de PHP o Extensiones Faltantes

PrestaShop es exigente con la versión de PHP y las extensiones activas. Si tu servidor tiene una versión obsoleta o le falta una extensión (como mysqli, gd, curl, mbstring, openssl, zip, etc.), verás un mensaje de error o la instalación se detendrá.

Solución paso a paso:

Accede a Syspanel y ve a "Configuración de PHP": Busca una opción como "PHP Settings", "PHP Version" o "Selector de PHP".
Cambia la versión de PHP: Selecciona una versión compatible con tu PrestaShop. Para PrestaShop 8.x, se recomienda PHP 8.1 o 8.2. Para versiones anteriores, PHP 7.4 suele ser seguro.
Activa las extensiones necesarias: En la misma sección, verás una lista de extensiones. Asegúrate de que las siguientes estén activadas (marcadas):
- mysqli (o mysqlnd)
- gd
- curl
- mbstring
- openssl
- zip
- xml
- json
- fileinfo
- intl
Guarda los cambios: Haz clic en "Guardar" o "Aplicar". El servidor se reiniciará automáticamente.
Verifica la configuración: Puedes crear un archivo info.php en tu servidor con el código <?php phpinfo(); ?> y acceder a él desde tu navegador para verificar que la versión y las extensiones son las correctas. No olvides borrar este archivo después por seguridad.

[INFO] Si no encuentras la opción de cambiar la versión de PHP en Syspanel, contacta con nuestro soporte. A veces está en un menú llamado "Web" o "Dominios".

4. Error de Memoria Límite (Memory Limit)

PrestaShop, especialmente durante la instalación o al procesar imágenes grandes, puede requerir más memoria de la que tiene configurada por defecto en PHP. El error típico es: "Fatal error: Allowed memory size of X bytes exhausted".

Solución paso a paso:

Accede a Syspanel y ve a "Configuración de PHP" (como en el paso anterior).
Aumenta el límite de memoria: Busca la opción memory_limit. El valor recomendado es 256M o incluso 512M si tu hosting lo permite.
Aumenta también otros límites (opcional pero recomendado):
- max_execution_time: 300 (segundos)
- max_input_time: 300
- upload_max_filesize: 64M (para subir temas o módulos grandes)
- post_max_size: 64M
Guarda los cambios.

[TIP] Si no puedes modificar estos valores desde Syspanel, puedes intentar hacerlo a través de un archivo .htaccess en la raíz de tu PrestaShop, añadiendo líneas como:
php_value memory_limit 256M
php_value max_execution_time 300

5. Error de URL Amigable (URL Rewriting)

Después de la instalación, al intentar acceder a tu tienda, ves un error 404 en todas las páginas excepto la principal. Esto suele deberse a que el módulo de reescritura de URLs (mod_rewrite) no está activado o la configuración de Apache no es correcta.

Solución paso a paso:

Comprueba que mod_rewrite está activado: En Syspanel, busca una sección de "Apache" o "Módulos". Asegúrate de que mod_rewrite esté habilitado. Si no lo ves, contacta con soporte.
Verifica el archivo .htaccess: PrestaShop genera un archivo .htaccess automáticamente. Ve al "Administrador de Archivos" y busca el archivo .htaccess en la raíz de tu PrestaShop. Si no existe, puedes crear uno con el siguiente contenido básico:
```
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php [QSA,L]
</IfModule>
```
Regenera el .htaccess desde el panel de administración: Una vez que puedas acceder al back office de PrestaShop (a veces funciona la URL tudominio.com/admin1234), ve a "Parámetros de la tienda" > "Tráfico y SEO" > "URLs amigables". Desactívalas, guarda, actívalas de nuevo y guarda. Esto regenerará el .htaccess correctamente.

[WARNING] Si tu hosting usa Nginx en lugar de Apache, el proceso es diferente. Necesitarás configurar las reglas de reescritura en el archivo de configuración de Nginx. Syspanel suele usar Apache por defecto, pero si tienes dudas, consúltanos.

6. Error de Zona Horaria o Configuración Regional

PrestaShop puede mostrar errores relacionados con la zona horaria o la configuración regional (locale) si no están correctamente definidas en PHP.

Solución paso a paso:

Accede a Syspanel y ve a "Configuración de PHP".
Busca las opciones:
- date.timezone: Establécelo a tu zona horaria, por ejemplo, Europe/Madrid o America/Mexico_City.
- setlocale: No suele estar disponible en el panel, pero puedes forzarlo en el archivo config/defines.inc.php de PrestaShop añadiendo: define('_DB_SERVER_', 'localhost'); (esto no es para locale, es solo un ejemplo). Para el locale, es mejor configurarlo en el propio PrestaShop durante la instalación.
Guarda los cambios.

Preguntas Frecuentes (FAQ)

P: ¿Puedo instalar PrestaShop en un subdominio?
R: Sí, perfectamente. Solo asegúrate de que la carpeta de destino en Syspanel (por ejemplo, public_html/tienda) sea la correcta y que el subdominio apunte a esa carpeta.

P: ¿Qué hago si el instalador de PrestaShop se queda en blanco?
R: Esto suele deberse a un error de PHP no mostrado. Activa la visualización de errores en PHP desde Syspanel (opción display_errors = On) temporalmente para ver el error real. También revisa los logs de error de PHP en Syspanel (sección "Logs").

P: ¿Cómo accedo a mi base de datos desde fuera de Syspanel?
R: Por seguridad, la mayoría de los hostings bloquean el acceso remoto a la base de datos. Si necesitas gestionarla, usa el phpMyAdmin que viene integrado en Syspanel (busca "phpMyAdmin" en el menú).

P: Después de instalar, no puedo acceder al back office (panel de administración).
R: Prueba a acceder directamente a tudominio.com/admin1234 (sustituye admin1234 por la carpeta que elegiste durante la instalación). Si no funciona, revisa que el archivo admin1234/index.php exista y tenga permisos correctos. También verifica que no hayas cambiado la URL del sitio en la base de datos por error.

Espero que esta guía te haya sido de gran ayuda. Recuerda que Syspanel está diseñado para ser intuitivo, pero si en algún momento te sientes perdido, no dudes en contactar con nuestro equipo de soporte. ¡Estaremos encantados de ayudarte a poner tu tienda online en marcha!

¡Buena suerte con tu PrestaShop!