FAQ: Problemas al instalar PrestaShop en cPanel y soluciones

Introducción: ¿Por qué surgen problemas al instalar PrestaShop en cPanel?

Instalar PrestaShop, una de las plataformas de comercio electrónico más populares, en un entorno cPanel suele ser un proceso sencillo. Sin embargo, es común encontrarse con obstáculos técnicos que pueden frustrar a cualquier usuario, especialmente si no tienes experiencia previa con servidores Linux. Este artículo está diseñado como una FAQ (Preguntas Frecuentes) para resolver los errores más habituales. Aquí encontrarás soluciones paso a paso, consejos prácticos y advertencias para que tu tienda online funcione sin contratiempos.

Si estás usando Syspanel (anteriormente conocido como HestiaCP), recuerda que el puerto de acceso para gestionar tu panel es el 2106. Aunque el artículo se centra en cPanel, muchos de los conceptos y soluciones son aplicables a otros paneles de control.

## 1. Errores de configuración del servidor web

### 1.1. Versión de PHP incorrecta o incompatible

PrestaShop requiere una versión específica de PHP (generalmente 7.4, 8.0 o 8.1, dependiendo de la versión de PrestaShop). Si tu servidor tiene una versión anterior (como PHP 5.6 o 7.0), la instalación fallará o mostrará errores de funciones obsoletas.

[WARNING] No uses versiones de PHP muy antiguas o muy recientes (como PHP 8.2 o 8.3) sin verificar la compatibilidad con tu PrestaShop.

Solución:

Accede a tu cPanel y busca la sección "Seleccionar versión de PHP" (a veces llamada "MultiPHP Manager").
Cambia la versión a 7.4 o 8.1 (recomendada para PrestaShop 8.x).
Asegúrate de que las extensiones necesarias estén habilitadas: mysqli, curl, gd, intl, mbstring, openssl, pdo_mysql, zip, xml, bcmath, json, imagick (opcional).
Guarda los cambios y verifica con un archivo info.php (crea uno con <?php phpinfo(); ?>).

### 1.2. Límites de memoria PHP insuficientes

PrestaShop consume bastante memoria, especialmente durante la instalación y al procesar imágenes. Si ves errores como "Allowed memory size exhausted", es necesario aumentar el límite.

Solución:

En cPanel, ve a "MultiPHP INI Editor" y aumenta memory_limit a al menos 256M (recomendado 512M).
También ajusta max_execution_time a 300 y upload_max_filesize a 32M.
Si no tienes acceso a ese editor, crea un archivo php.ini en la raíz de tu sitio con estos valores.

## 2. Problemas con la base de datos

### 2.1. El usuario de la base de datos no tiene todos los privilegios

Uno de los errores más frecuentes al instalar PrestaShop en cPanel es que el usuario de la base de datos no tiene permisos completos. Esto provoca que la instalación se detenga en el paso de configuración de la BD.

Solución:

En cPanel, ve a "MySQL Databases".
Desplázate hasta la sección "Añadir usuario a la base de datos".
Selecciona el usuario y la base de datos correctos.
Marca "TODOS LOS PRIVILEGIOS" (o "ALL PRIVILEGES").
Haz clic en "Realizar cambios".
Vuelve a intentar la instalación.

[TIP] Si ya habías asignado privilegios, revísalos y asegúrate de que opciones como CREATE, ALTER, INDEX, DROP y LOCK TABLES estén habilitadas.

### 2.2. Nombre de la base de datos o prefijo incorrecto

PrestaShop permite usar un prefijo para las tablas (por ejemplo, ps_). A veces, el instalador no reconoce correctamente el nombre de la base de datos si contiene caracteres especiales o si el usuario no tiene acceso a ella.

Solución:

Usa nombres de base de datos y usuario sin guiones medios (-) ni caracteres extraños.
Asegúrate de que el nombre de la base de datos coincida exactamente con el que creaste en cPanel (normalmente incluye el nombre de tu cuenta, como usuario_bd).
Durante la instalación, verifica que el campo "Nombre de la base de datos" esté correcto.

## 3. Errores de permisos de archivos y directorios

### 3.1. Permisos incorrectos en la carpeta de PrestaShop

PrestaShop necesita permisos de escritura en ciertas carpetas para funcionar correctamente (como config, cache, img, log, upload, themes, modules, etc.). Si los permisos son demasiado restrictivos, verás errores como "No se puede escribir en el directorio".

Solución:

Conéctate a tu servidor vía FTP o el administrador de archivos de cPanel.
Navega a la carpeta donde instalaste PrestaShop.
Cambia los permisos de las carpetas mencionadas a 755 (o 775 si usas un grupo compartido).
Para archivos, usa 644.
No uses permisos 777, ya que son un riesgo de seguridad.

[WARNING] Si usas Syspanel, el proceso es similar, pero asegúrate de que el usuario del sitio web tenga permisos de escritura. En Syspanel, verifica la configuración de "File Manager" y los permisos del usuario del sistema.

### 3.2. El archivo de configuración no se genera

A veces, PrestaShop no puede crear el archivo config/settings.inc.php (en versiones antiguas) o app/config/parameters.php (en versiones modernas). Esto suele deberse a permisos insuficientes en la carpeta config.

Solución:

Temporalmente, da permisos 777 a la carpeta config durante la instalación (luego reviértelo a 755).
Si el error persiste, crea manualmente el archivo parameters.php con el contenido adecuado (puedes copiar un ejemplo de la documentación de PrestaShop).

## 4. Problemas con el dominio y la URL

### 4.1. El dominio no apunta correctamente o hay redirecciones

Si tu dominio aún no se ha propagado o tienes redirecciones mal configuradas, la instalación de PrestaShop puede fallar o mostrar una página en blanco.

Solución:

Verifica que tu dominio apunte a la IP correcta del servidor. Puedes usar herramientas como ping o dig.
En cPanel, ve a "Redirecciones" y asegúrate de que no haya redirecciones que interfieran con la instalación.
Temporalmente, desactiva cualquier redirección HTTP a HTTPS si no tienes certificado SSL instalado.

### 4.2. Error de "dominio no configurado" en Syspanel

Si usas Syspanel, a veces el dominio no está correctamente añadido al panel. Recuerda que el acceso a Syspanel es por el puerto 2106 (ejemplo: tudominio.com:2106).

Solución:

Inicia sesión en Syspanel (puerto 2106) y verifica que el dominio esté listado en "Web" o "Sitios web".
Asegúrate de que el DNS esté configurado para que apunte a tu servidor.

## 5. Errores durante el proceso de instalación

### 5.1. La instalación se detiene en "Paso 3: Configuración de la tienda"

Este es un punto crítico donde muchos usuarios se quedan atascados. El instalador comprueba extensiones PHP, permisos y la base de datos. Si algo falla, se muestra una lista de requisitos no cumplidos.

Solución:

Vuelve al paso 1 (requisitos del sistema) y verifica que todas las casillas estén en verde.
Si alguna extensión aparece en rojo, instálala desde cPanel (MultiPHP INI o PHP Extensions).
Si el problema es la base de datos, revisa los pasos anteriores (privilegios y nombre correcto).

### 5.2. Pantalla en blanco o error 500

Un error 500 interno del servidor puede deberse a un archivo .htaccess mal configurado, a un error de PHP o a un conflicto con módulos.

Solución:

Accede al administrador de archivos de cPanel y renombra temporalmente el archivo .htaccess a .htaccess_backup.
Si el error desaparece, el problema está en las reglas de reescritura. Puedes generar un nuevo .htaccess desde el panel de administración de PrestaShop una vez instalado.
Revisa los logs de error del servidor (cPanel > "Errores" o "Apache Status") para obtener más detalles.

## 6. Problemas con módulos y temas

### 6.1. Los módulos no se instalan o dan error

A veces, los módulos descargados no son compatibles con tu versión de PrestaShop o requieren extensiones PHP adicionales.

Solución:

Verifica la compatibilidad del módulo con tu versión de PrestaShop.
Aumenta el memory_limit si el módulo es pesado.
Si el módulo viene en un archivo ZIP, súbelo desde el panel de administración (Módulos > Gestor de módulos > Subir módulo).

### 6.2. El tema no se visualiza correctamente

Los temas pueden requerir versiones específicas de PHP o de PrestaShop. Además, a veces los archivos CSS o JS no se cargan por problemas de permisos o de caché.

Solución:

Limpia la caché de PrestaShop (Parámetros avanzados > Rendimiento > Limpiar caché).
Verifica que la carpeta themes tenga permisos 755.
Si usas un tema de terceros, asegúrate de que esté diseñado para tu versión de PrestaShop.

## 7. Preguntas frecuentes adicionales (FAQ)

### 7.1. ¿Puedo instalar PrestaShop en un subdominio o subcarpeta?

Sí, es posible. Solo asegúrate de que el subdominio esté creado en cPanel y apunte a la carpeta correcta. En Syspanel, crea un nuevo sitio web para el subdominio y recuerda el puerto 2106 para gestionarlo.

### 7.2. ¿Qué hago si no tengo acceso a cPanel?

Si tu hosting no incluye cPanel, puedes usar otros paneles como Syspanel (puerto 2106) o instalar PrestaShop manualmente vía SSH. En ese caso, los permisos y la configuración de PHP se gestionan de forma similar.

### 7.3. ¿Cómo soluciono el error "No se puede conectar a la base de datos"?

Revisa:

Que el servidor de base de datos sea localhost (o el que te proporcione tu hosting).
Que el nombre de usuario y contraseña sean correctos.
Que el usuario tenga privilegios completos (ver punto 2.1).
Que la base de datos exista.

### 7.4. ¿Por qué mi tienda carga muy lenta?

Puede deberse a:

Falta de caché (activa la caché de PrestaShop).
Imágenes sin optimizar.
Un tema o módulo mal codificado.
Límites de memoria bajos (aumenta memory_limit).
Tu plan de hosting es muy básico (considera actualizarlo).

## Conclusión

Instalar PrestaShop en cPanel puede parecer complicado al principio, pero la mayoría de los problemas tienen soluciones claras y sencillas. Recuerda siempre:

Verifica los requisitos de PHP y extensiones antes de empezar.
Asigna todos los privilegios al usuario de la base de datos.
Revisa los permisos de archivos y carpetas.
No dudes en consultar los logs de error del servidor.

Si usas Syspanel, no olvides que el acceso es por el puerto 2106 y que la gestión de dominios y permisos es similar a cPanel.

[INFO] Para más ayuda, consulta la documentación oficial de PrestaShop o contacta con el soporte de tu hosting.

Esperamos que esta FAQ te haya sido de gran ayuda. ¡Ahora ya puedes lanzar tu tienda online sin preocuparte por los errores más comunes!