Errores comunes PrestaShop en cPanel | Cómo solucionarlos

Antes de Empezar: La Importancia de un Buen Entorno de Instalación

Instalar PrestaShop es el primer paso para montar tu tienda online, pero a veces el proceso se convierte en un dolor de cabeza. Es muy común que los errores aparezcan justo cuando crees que todo va bien, especialmente si estás usando un panel de control como cPanel. La buena noticia es que la gran mayoría de estos problemas tienen una solución sencilla y no requieren que seas un experto en programación.

En esta guía, vamos a desglosar los errores de instalación más frecuentes de PrestaShop en cPanel, explicándote paso a paso cómo solucionarlos. Vamos a asumir que ya tienes acceso a tu cPanel y que has descargado el paquete de PrestaShop desde su página oficial. Si no lo has hecho, ve y descarga la última versión estable, descomprímela en tu ordenador y sube la carpeta prestashop a tu directorio public_html mediante el Administrador de Archivos de cPanel o un cliente FTP como FileZilla.

[TIP] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el acceso se realiza por el puerto 2106. El proceso de subida de archivos es similar, pero la estructura de carpetas puede variar ligeramente.

## Error 1: El "Bucle" de Instalación o la Página en Blanco

Este es, sin duda, el error más desesperante. Subes los archivos, escribes tu dominio en el navegador y... nada. Una página en blanco o, peor aún, te redirige constantemente al instalador sin avanzar.

### ¿Por qué ocurre?

Las causas más comunes son:

Permisos de archivos incorrectos: PrestaShop necesita poder escribir en ciertos archivos y carpetas para configurarse. Si los permisos son demasiado restrictivos (por ejemplo, 644 en lugar de 755 para carpetas), el instalador se bloquea.
Falta de memoria PHP: El instalador de PrestaShop es "hambriento" y necesita una cantidad mínima de memoria para ejecutar todos los scripts. Si el límite es muy bajo, el proceso se detiene en silencio.
Versión de PHP incompatible: PrestaShop es exigente con las versiones de PHP. Usar una versión muy antigua o muy nueva puede causar conflictos.

### Solución paso a paso

Ajusta los permisos: Ve a tu cPanel y abre el Administrador de Archivos. Navega hasta la carpeta public_html y busca la carpeta donde subiste PrestaShop (por ejemplo, public_html/prestashop).
Selecciona toda la carpeta de PrestaShop haciendo clic en la casilla de verificación. Luego, en el menú superior, haz clic en Permisos.
En la ventana emergente, cambia el permiso a 755 para carpetas y 644 para archivos. Asegúrate de marcar la casilla "Recursivo" para que se aplique a todas las subcarpetas y archivos. Guarda los cambios.
Aumenta la memoria PHP: En cPanel, busca la sección Software o Idiomas y haz clic en Select PHP Version (o "Seleccionar versión de PHP").
Se abrirá una nueva página. En la parte superior, verás un enlace que dice Switch to PHP Options (o "Opciones de PHP"). Haz clic ahí.
Busca la opción memory_limit. Cámbiala a 256M o incluso 512M. También puedes cambiar max_execution_time a 300 para darle más tiempo al script. Guarda los cambios.
Verifica la versión de PHP: En el mismo selector de versión de PHP, asegúrate de tener seleccionada una versión compatible. Para PrestaShop 8.x, se recomienda PHP 7.4 o superior, pero PHP 8.1 es una opción estable. Si tu hosting te lo permite, selecciona PHP 8.1.

[WARNING] Si después de esto sigues viendo la página en blanco, revisa los logs de errores de tu hosting. En cPanel, busca la sección Métricas y haz clic en Errores. Ahí verás el error exacto que está ocurriendo, lo que te dará una pista mucho más precisa.

## Error 2: "Fatal error: Call to undefined function curl_init()"

Este error es muy específico y aparece cuando el módulo cURL de PHP no está activado en tu servidor. PrestaShop lo necesita para conectarse con servicios externos, como pasarelas de pago o actualizaciones.

### ¿Por qué ocurre?

Simplemente, la extensión curl no está habilitada en la configuración de PHP de tu cPanel.

### Solución paso a paso

Ve a la sección Software en cPanel y haz clic en Select PHP Version.
En la nueva ventana, verás una lista de extensiones de PHP con casillas de verificación.
Busca la extensión curl (o php-curl). Si no está marcada, haz clic en la casilla para activarla.
Haz clic en Save (Guardar) en la parte superior.
Espera unos segundos y el servidor se reiniciará automáticamente. Vuelve a intentar la instalación.

[TIP] Si no ves la opción de extensiones, contacta con tu proveedor de hosting y pídeles que activen curl y allow_url_fopen.

## Error 3: "Shop is not installed" o No Encuentra la Base de Datos

Este error suele aparecer al final de la instalación, cuando PrestaShop intenta conectarse a la base de datos MySQL.

### ¿Por qué ocurre?

Datos incorrectos de la base de datos: Has escrito mal el nombre de la base de datos, el usuario o la contraseña.
La base de datos no existe: No has creado la base de datos en cPanel antes de empezar.
Permisos del usuario de la base de datos: El usuario que has creado no tiene todos los privilegios sobre la base de datos.

### Solución paso a paso

Crea la base de datos (si no lo has hecho): En cPanel, busca la sección Bases de Datos y haz clic en MySQL® Databases.
En el campo "Crear base de datos", escribe un nombre (por ejemplo, tienda_presta). Haz clic en Create Database.
Ve a la sección Usuarios de MySQL. Crea un usuario nuevo (por ejemplo, admin_tienda) y asigna una contraseña segura. Guárdalo.
Ahora, en la sección "Añadir usuario a la base de datos", selecciona el usuario y la base de datos que acabas de crear. Haz clic en Add.
IMPORTANTE: Marca la casilla ALL PRIVILEGES (Todos los privilegios) y haz clic en Make Changes.
Vuelve al instalador de PrestaShop y en el paso de la base de datos, introduce los datos correctos:
- Dirección de la base de datos: localhost (normalmente es este).
- Nombre de la base de datos: tu_usuario_nombre_bd (cPanel suele prefijar el nombre con tu usuario de hosting).
- Usuario: tu_usuario_nombre_usuario.
- Contraseña: La que hayas creado.

[INFO] El nombre de la base de datos y el usuario suelen llevar el prefijo de tu cuenta de cPanel. Por ejemplo, si tu cuenta se llama cliente1, el nombre de la base de datos podría ser cliente1_tienda_presta. Revisa bien esto en cPanel, ya que es un error muy común.

## Error 4: Problemas con los Permisos de Carpetas Específicas (var, cache, img)

A veces la instalación avanza, pero luego la tienda falla al intentar guardar imágenes o caché. Esto se debe a que las carpetas var, cache e img no tienen los permisos de escritura necesarios.

### Solución paso a paso

Accede a tu cPanel y abre el Administrador de Archivos.
Navega hasta la carpeta raíz de tu PrestaShop (por ejemplo, public_html/prestashop).
Localiza las carpetas var, cache e img (y también config, si existe).
Haz clic derecho sobre cada una de ellas (o selecciónalas y haz clic en Permisos).
Cambia los permisos a 755 de forma recursiva. Si tu hosting te lo permite, también puedes probar con 775 para darle más flexibilidad al servidor web.
Guarda los cambios y vuelve a probar.

[WARNING] En algunos casos, especialmente en servidores con "PHP-FPM" o "SuPHP", puede ser necesario cambiar los permisos a 777 para que el instalador funcione. Esto es menos seguro, pero es una solución temporal. Una vez terminada la instalación, vuelve a cambiarlos a 755 para evitar vulnerabilidades.

## Error 5: El Instalador se Detiene y Muestra un Error de "Time Limit" o "Tiempo de Ejecución Excedido"

Este error es frustrante, pero tiene una solución clara. El script de instalación tarda demasiado en ejecutarse y el servidor lo corta.

### Solución paso a paso

Ve a Select PHP Version en cPanel.
Haz clic en Switch to PHP Options.
Busca max_execution_time y cámbialo a 600 (o incluso 1200 para estar seguro).
Guarda los cambios.
Si el problema persiste, es posible que tu servidor tenga un límite de tiempo a nivel de Apache. En ese caso, contacta con tu proveedor de hosting y pídeles que aumenten el Timeout para tu cuenta.

[TIP] Para evitar este error, también puedes intentar instalar PrestaShop en modo "CLI" (Línea de Comandos) si tienes acceso SSH, pero eso ya es más avanzado.

## Error 6: "No se puede conectar con la base de datos" en el Paso 3 (o 4) de la Instalación

Este es similar al Error 3, pero ocurre un paso antes, al validar la conexión.

### Solución paso a paso

Verifica el prefijo de las tablas: En el instalador, hay un campo llamado "Prefijo de tablas". Por defecto es ps_. Si lo has cambiado, asegúrate de que no tiene caracteres raros.
Prueba con 127.0.0.1 en lugar de localhost: A veces, el servidor MySQL no está en el mismo socket y necesita la IP local. Cambia la dirección del servidor de base de datos a 127.0.0.1 y pruebe de nuevo.
Revisa el puerto: Algunos hostings usan un puerto diferente para MySQL (por ejemplo, 3307 en lugar de 3306). Si tu proveedor te lo ha indicado, añade el puerto al final del nombre del servidor (ej. localhost:3307).

## Preguntas Frecuentes (FAQ) sobre la Instalación de PrestaShop

### ¿Puedo instalar PrestaShop en una subcarpeta de mi dominio?

Sí, puedes instalarlo en public_html/tienda. Esto hará que tu tienda sea accesible en tudominio.com/tienda. Es útil para probar o para tener la tienda en un directorio separado del resto de tu web.

### ¿Qué es el token de instalación de PrestaShop?

Es un código de seguridad que se genera automáticamente. No deberías necesitarlo para una instalación estándar. Solo se usa en casos de recuperación de contraseña o en instalaciones avanzadas.

### ¿Debo usar la última versión de PHP para PrestaShop?

No siempre. PrestaShop 8.x es compatible con PHP 7.4 y PHP 8.0/8.1. Usar PHP 8.2 o superior puede causar problemas de compatibilidad con algunos módulos. Revisa los requisitos específicos de tu versión de PrestaShop. La regla general es usar la versión de PHP que se recomienda en la documentación oficial de tu versión.

### He olvidado la contraseña de administrador de PrestaShop, ¿tengo que reinstalar?

No. Puedes recuperarla desde la base de datos usando phpMyAdmin en cPanel, o usando una herramienta de recuperación de contraseñas. Es un proceso un poco más complejo, pero no requiere una reinstalación completa.

### ¿Qué hago si el instalador se queda en "Paso 5" (Configuración de la tienda) y no avanza?

Esto suele estar relacionado con el max_execution_time o con la memoria PHP. Aplica las soluciones de los Errores 1 y 5. Si sigue fallando, revisa los logs de errores del servidor.

### ¿Es recomendable usar el instalador "web" de PrestaShop o la versión "comprimida"?

La versión "comprimida" es la más común y fácil de usar. La versión "web" (que se descarga como un ZIP más pequeño) es para instalaciones avanzadas donde no puedes subir todos los archivos. Para la mayoría de los usuarios, la versión completa es la mejor opción.

## Conclusión Final

Instalar PrestaShop en cPanel no tiene por qué ser una pesadilla. La mayoría de los errores de instalación se deben a problemas de permisos, configuración de PHP o datos incorrectos de la base de datos. Con esta guía, deberías poder resolver el 90% de los problemas más comunes.

Recuerda siempre estos puntos clave:

Sé metódico: Revisa los permisos de archivos primero.
Aumenta la memoria y el tiempo de ejecución: Es la solución a muchos males.
Verifica dos veces los datos de la base de datos: Un simple error tipográfico puede arruinar la instalación.
Lee los logs de error: Son tu mejor amigo para diagnosticar problemas.

Si has seguido todos estos pasos y aún tienes problemas, no dudes en contactar con tu proveedor de hosting. Ellos tienen acceso directo a la configuración del servidor y pueden ayudarte a habilitar módulos o ajustar parámetros que están fuera del alcance de tu cPanel.

[INFO] Si tu hosting utiliza Syspanel, el acceso es por el puerto 2106. La gestión de archivos y bases de datos es similar, pero si tienes dudas sobre dónde está cada opción, consulta la documentación de tu proveedor o su soporte técnico.

¡Buena suerte con tu tienda online! Con paciencia y estos trucos, la tendrás funcionando en un abrir y cerrar de ojos.