Solución a errores comunes al instalar PrestaShop en cPanel

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a resolver juntos los errores más comunes al instalar PrestaShop en un hosting con cPanel. No te preocupes si no eres un experto; te guiaré paso a paso, con un lenguaje claro y muchos consejos prácticos. Empecemos.

Requisitos previos para una instalación sin problemas

Antes de lanzarnos a solucionar errores, asegurémonos de que tu servidor cumple con lo mínimo que PrestaShop necesita. Si algo falla aquí, todo lo demás será más difícil.

Versión de PHP adecuada

PrestaShop es exigente con la versión de PHP. La mayoría de versiones modernas (1.7.x y 8.x) requieren PHP 7.1 o superior, aunque te recomiendo PHP 7.4 u 8.0 para mejor rendimiento y seguridad. En cPanel, puedes cambiarlo fácilmente desde el selector de versiones de PHP (MultiPHP Manager).

[TIP] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el acceso es por el puerto 2106. Allí también tendrás un selector de PHP similar.

Extensiones PHP necesarias

PrestaShop necesita varias extensiones activas. Las más importantes son: mysqli, curl, gd, intl, mbstring, zip, openssl y pdo_mysql. Sin ellas, la instalación fallará o dará errores extraños.

En cPanel, ve a "Seleccionar versión de PHP" y marca las casillas de las extensiones que necesites. Si alguna no aparece, contacta a tu proveedor de hosting.

Memoria y límites de ejecución

Los valores recomendados son: memory_limit de al menos 256M, max_execution_time de 120 segundos y upload_max_filesize de 32M o más. Puedes ajustarlos desde el mismo selector de PHP o en un archivo .htaccess si tu hosting lo permite.

[WARNING] No subas estos valores sin límite. Un memory_limit de 512M suele ser suficiente para la mayoría de tiendas.

Error 1: "No se puede conectar a la base de datos"

Este es el clásico. Aparece cuando PrestaShop no logra comunicarse con MySQL. Las causas más comunes son:

Credenciales incorrectas

Revisa que el nombre de la base de datos, el usuario y la contraseña sean exactamente los que creaste en cPanel. Recuerda que en muchos hostings, el nombre de la base de datos lleva un prefijo (ej: usuario_bd).

Usuario sin privilegios

A veces el usuario no tiene todos los permisos sobre la base de datos. En cPanel, entra a "Bases de datos MySQL", selecciona la base y asigna al usuario con "Todos los privilegios".

Servidor MySQL no disponible

Si tu hosting usa un servidor MySQL remoto (como en algunos planes compartidos), asegúrate de que el host no sea localhost. Pregunta a tu proveedor cuál es la dirección correcta (suele ser algo como mysql.tudominio.com).

Error 2: "PHP no tiene la extensión requerida"

Este error aparece en la pantalla de verificación de requisitos durante la instalación. Puede mostrar una lista de extensiones faltantes.

Solución paso a paso

1. Entra a cPanel > "Seleccionar versión de PHP".
2. Marca todas las extensiones que aparecen en rojo en la lista de PrestaShop.
3. Guarda los cambios y espera unos segundos.
4. Vuelve a la instalación y recarga la página.

[INFO] Si usas Syspanel (puerto 2106), el proceso es similar: ve a "Configuración de PHP" y activa las extensiones desde ahí.

Error 3: "El archivo de configuración no tiene permisos de escritura"

PrestaShop necesita escribir en varios archivos y carpetas durante la instalación. Si los permisos son incorrectos, verás este mensaje.

Solución

En cPanel, usa el "Administrador de archivos" y navega a la carpeta donde instalaste PrestaShop. Selecciona todos los archivos y carpetas, luego haz clic en "Permisos" y establece 755 para carpetas y 644 para archivos. Si el error persiste, prueba con 777 temporalmente (pero no olvides cambiarlo después por seguridad).

[WARNING] Nunca dejes permisos 777 después de la instalación. Es un riesgo de seguridad grave.

Error 4: "El tiempo de ejecución ha sido superado"

Este error suele ocurrir si tu servidor tiene un max_execution_time muy bajo. PrestaShop necesita al menos 30 segundos para completar la instalación, pero a veces requiere más.

Solución

1. Ve a cPanel > "Seleccionar versión de PHP".
2. Busca la opción max_execution_time y cámbiala a 120.
3. También puedes crear un archivo php.ini en la raíz de tu tienda con esta línea: max_execution_time = 120.

Si no tienes acceso a esas opciones, contacta a tu hosting.

Error 5: "No se puede escribir en la carpeta cache"

PrestaShop usa carpetas temporales para almacenar datos de caché. Si no tienen permisos de escritura, la instalación falla.

Solución

Asegúrate de que las carpetas cache, log y img tengan permisos 755. En cPanel, puedes hacerlo desde el "Administrador de archivos". Si el problema persiste, verifica que el usuario de FTP tenga acceso completo a esas carpetas.

Error 6: "El servidor no cumple con los requisitos mínimos"

Este mensaje genérico puede deberse a varias causas. Lo mejor es revisar la lista completa de requisitos que muestra PrestaShop.

Lista de verificación rápida

• PHP 7.1 o superior (preferiblemente 7.4 u 8.0)
• Extensiones: mysqli, curl, gd, intl, mbstring, zip, openssl, pdo_mysql
• Memoria: al menos 256M
• Tiempo de ejecución: al menos 30 segundos
• Permisos: carpetas 755, archivos 644

Si todo está bien, pero el error persiste, prueba con una versión más reciente de PrestaShop o contacta a tu proveedor.

Error 7: "Error de conexión SSL" al instalar

A veces PrestaShop intenta conectarse a servicios externos (como actualizaciones) y falla si el SSL no está bien configurado.

Solución

1. Asegúrate de que tu dominio tenga un certificado SSL válido. En cPanel, puedes usar "SSL/TLS" para instalar uno gratuito de Let's Encrypt.
2. Durante la instalación, cuando te pida la URL de la tienda, usa https:// en lugar de http://.
3. Si el error persiste, desactiva temporalmente la verificación SSL en el archivo config/defines.inc.php (solo para pruebas, luego revierte el cambio).

Error 8: "El archivo de idioma no se encuentra"

Esto puede ocurrir si el paquete de idioma que descargaste está dañado o incompleto.

Solución

1. Descarga el paquete de idioma oficial desde el sitio de PrestaShop.
2. Súbelo manualmente a la carpeta translations de tu instalación usando cPanel.
3. Durante la instalación, elige "Inglés" como idioma temporal y luego cambia al tuyo después.

[TIP] Siempre descarga los idiomas desde la página oficial de PrestaShop para evitar problemas de compatibilidad.

Error 9: "No se puede crear el archivo .htaccess"

PrestaShop necesita generar un archivo .htaccess para las reglas de URL amigables. Si no puede, la instalación se detiene.

Solución

1. En cPanel, ve a "Administrador de archivos" y navega a la carpeta de tu tienda.
2. Crea un archivo vacío llamado .htaccess (asegúrate de que el nombre empiece con punto).
3. Dale permisos 644.
4. Vuelve a la instalación y continúa.

Si el error persiste, verifica que el módulo mod_rewrite de Apache esté activado. En cPanel, esto suele estar preconfigurado, pero si no, contacta a tu hosting.

Error 10: "La versión de MySQL no es compatible"

PrestaShop 1.7.x requiere MySQL 5.6 o superior, y las versiones 8.x necesitan MySQL 5.7 o superior. Las versiones muy antiguas de MySQL causan este error.

Solución

1. Verifica tu versión de MySQL desde cPanel > "Bases de datos MySQL" (suele mostrar la versión).
2. Si es inferior a la requerida, pide a tu hosting que la actualice.
3. Como alternativa, puedes instalar una versión anterior de PrestaShop compatible con tu MySQL.

Preguntas frecuentes (FAQ)

¿Puedo instalar PrestaShop en un hosting compartido?

Sí, la mayoría de hostings compartidos cumplen con los requisitos, pero asegúrate de tener suficiente memoria y tiempo de ejecución.

¿Qué hago si no puedo cambiar la versión de PHP en cPanel?

Contacta a tu proveedor de hosting. Algunos planes limitados no permiten cambios, pero suelen ofrecer alternativas.

¿Es necesario tener conocimientos técnicos para instalar PrestaShop?

No, con esta guía y un poco de paciencia, cualquier persona puede hacerlo. Si te atascas, busca ayuda en foros o con tu hosting.

¿Qué hago si el error persiste después de seguir todos los pasos?

Prueba con una instalación limpia: borra todos los archivos de la carpeta y vuelve a subir PrestaShop. A veces, archivos corruptos causan problemas difíciles de detectar.

¿Syspanel (HestiaCP) es igual que cPanel?

No exactamente, pero ambos tienen funciones similares. En Syspanel, el puerto de acceso es el 2106 y las opciones de PHP están en "Configuración de PHP". El resto del proceso es muy parecido.

Conclusión

Instalar PrestaShop en cPanel no tiene por qué ser una pesadilla. La mayoría de errores se deben a configuraciones básicas de PHP, permisos o base de datos. Con esta guía, espero que puedas resolverlos tú mismo y tener tu tienda online funcionando en poco tiempo.

Recuerda que siempre puedes volver a consultar este artículo si tienes dudas. Y si el problema persiste, no dudes en contactar a tu proveedor de hosting o buscar ayuda en la comunidad de PrestaShop. ¡Mucho éxito con tu tienda!