Errores de PrestaShop en cPanel: Soluciones Paso a Paso

Antes de empezar: ¿Por qué falla la instalación de PrestaShop en cPanel?

Instalar PrestaShop en cPanel es un proceso que, en teoría, debería ser sencillo: subes los archivos, creas una base de datos, ejecutas el instalador y listo. Sin embargo, la realidad es que los problemas de PrestaShop en cPanel son muy frecuentes, y casi siempre giran en torno a los mismos tres culpables: permisos incorrectos, memoria PHP insuficiente y versiones de PHP incompatibles.

Si estás aquí, probablemente ya viste la pantalla de error blanca, un mensaje de "500 Internal Server Error" o un aviso sobre extensiones de PHP que no están habilitadas. No te preocupes: en esta guía vamos a resolver los errores más comunes al instalar PrestaShop en cPanel paso a paso, con un lenguaje claro y sin tecnicismos innecesarios. Al final, tendrás tu tienda funcionando.

1. Requisitos mínimos que debes verificar antes de instalar PrestaShop

Antes de siquiera subir un archivo, es crucial que tu hosting cumpla con los requisitos. Muchos problemas de instalación se evitan simplemente revisando esto.

1.1 Versión de PHP compatible

PrestaShop 8.x (la versión actual) requiere PHP 7.2.5 o superior, aunque se recomienda PHP 7.4 u 8.0 para un rendimiento óptimo. Si tu cPanel tiene PHP 5.6 o inferior, la instalación fallará o mostrará errores extraños.

Cómo verificarlo en cPanel:

Busca la sección "Select PHP Version" o "MultiPHP Manager".
Asegúrate de que la versión seleccionada sea al menos 7.4.

1.2 Extensiones de PHP necesarias

PrestaShop necesita ciertas extensiones activadas. Si falta alguna, el instalador te mostrará un mensaje como "La extensión X no está disponible". Las más importantes son:

PDO_MySQL (para la base de datos).
Curl (para conexiones externas y módulos).
OpenSSL (para seguridad).
GD Library (para imágenes).
Zip (para instalar módulos y temas).

Puedes activarlas desde el mismo MultiPHP Manager o MultiPHP INI Editor en cPanel. Si no las encuentras, contacta a tu proveedor de hosting.

1.3 Espacio en disco y memoria

Asegúrate de tener al menos 500 MB de espacio libre y que el límite de memoria PHP (memory_limit) sea de al menos 256 MB. Esto último lo veremos en detalle más adelante, porque es una de las causas más comunes de los problemas de PrestaShop.

2. Pasos previos: subir PrestaShop correctamente

Muchos errores de instalación de PrestaShop en cPanel se deben a una subida incorrecta de los archivos. Te explico el método correcto:

2.1 Descargar e identificar la versión

Descarga el paquete comprimido (zip) desde el sitio oficial de PrestaShop.
Descomprímelo en tu computadora. Verás una carpeta que contiene la estructura de archivos.

2.2 Subir el contenido de la carpeta (no la carpeta en sí)

Este es un error clásico: subir la carpeta completa prestashop/ a public_html/. El resultado es que tu tienda queda en tudominio.com/prestashop en lugar de tudominio.com.

La forma correcta:

Entra a cPanel y abre el Administrador de archivos (File Manager).
Ve a public_html (si tu dominio es el principal).
Haz clic en "Cargar" y sube el archivo .zip que descargaste.
Una vez subido, haz clic derecho sobre el .zip y selecciona "Extraer".
Ahora verás una carpeta con el nombre de la versión (ej: prestashop-8.1.0).
Selecciona todos los archivos dentro de esa carpeta y muévelos a public_html. O simplemente mueve la carpeta y luego mueve su contenido.

[TIP] Si quieres instalar PrestaShop en una subcarpeta (ej: tudominio.com/tienda), crea la carpeta dentro de public_html y extrae ahí el contenido.

2.3 El problema del archivo .htaccess

Cuando extraes los archivos, puede que el archivo .htaccess no se vea porque los archivos ocultos están desactivados en el File Manager. Haz clic en "Configuración" (arriba a la derecha) y marca la casilla "Mostrar archivos ocultos (dotfiles)".

3. Los 5 errores más comunes al instalar PrestaShop en cPanel y su solución

Ahora sí, vamos a lo que viniste a buscar: la solución a los problemas concretos.

3.1 Error: "PrestaShop no puede conectarse a la base de datos"

Este es el error más común cuando se instala PrestaShop en cPanel. El instalador no logra conectar con MySQL.

Causas y soluciones:

Credenciales incorrectas: Revisa que el nombre de la base de datos, el usuario y la contraseña sean exactos. En cPanel, los nombres suelen llevar el prefijo de tu cuenta (ej: usuari0_bd_prestashop).
Usuario sin privilegios: Asegúrate de que el usuario de la base de datos tenga "TODOS LOS PRIVILEGIOS" sobre la base de datos. Ve a "Bases de datos MySQL" en cPanel, busca la base de datos y haz clic en "Privilegios del usuario".
Prefijo de tabla: Durante la instalación, te pedirá un prefijo. Si dejas el predeterminado (ps_), está bien. No lo cambies a menos que sepas lo que haces.

[WARNING] Si estás usando un hosting muy restrictivo, el servidor MySQL puede estar en un host remoto. En la instalación, el campo "Servidor de base de datos" debe ser localhost en el 99% de los casos de cPanel.

3.2 Error: Pantalla blanca o "500 Internal Server Error"

La temida pantalla blanca suele aparecer justo después de subir los archivos o durante la instalación. Esto casi siempre es un problema de permisos de archivos o de memoria PHP.

Solución para permisos de PrestaShop

Los permisos correctos son:

Carpetas: 755
Archivos: 644
La carpeta config y el archivo settings.inc.php: 755 y 644 respectivamente (aunque algunos hosts piden 777 temporalmente).

Cómo corregirlo en cPanel:

En el Administrador de archivos, selecciona todos los archivos de tu instalación de PrestaShop.
Haz clic en "Permisos" (o "Change Permissions").
Introduce 755 para carpetas y 644 para archivos. Si haces clic en "Cambiar recursivamente", se aplicará a todo.

[TIP] Después de la instalación, PrestaShop debería funcionar con permisos 755/644. Si tu hosting es muy estricto y da error, sube temporalmente la carpeta var/cache a 777, pero elimina el contenido de esa carpeta después.

Solución para memoria PHP insuficiente

PrestaShop necesita al menos 256 MB de memoria PHP. Si el límite es menor, verás errores como "Allowed memory size of X bytes exhausted".

Cómo aumentarlo en cPanel:

Ve a "Select PHP Version" y luego haz clic en "Switch to PHP Options".
Busca la opción memory_limit y cámbiala a 256M o 512M.
Guarda los cambios.

También puedes hacerlo creando o editando un archivo .htaccess en la raíz de tu instalación con esta línea:

php_value memory_limit 512M

[INFO] Si no encuentras la opción en cPanel, contacta a tu proveedor. Algunos hosts bloquean el cambio de memoria PHP a nivel de servidor.

3.3 Error: "La extensión cURL no está disponible" o "PDO no encontrado"

Estos errores indican que faltan extensiones de PHP. La solución es activarlas desde cPanel.

Pasos:

Ve a "Select PHP Version".
Marca las casillas de las extensiones que necesitas: curl, pdo_mysql, openssl, gd, zip, mbstring.
Haz clic en "Save".

Si no ves estas opciones, significa que tu plan de hosting no las incluye. En ese caso, tendrás que cambiar de proveedor o solicitar que las activen manualmente.

3.4 Error: "El archivo settings.inc.php no es escribible"

Durante la instalación, PrestaShop necesita escribir en el archivo config/settings.inc.php. Si no tiene permisos de escritura, el proceso se detiene.

Solución:

Temporalmente, cambia los permisos de la carpeta config a 777 (todo el mundo puede leer, escribir y ejecutar).
Ejecuta la instalación.
Cuando termine, vuelve a cambiar los permisos a 755.

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

3.5 Error: "No se puede crear el archivo .htaccess" o "No se puede escribir en la caché"

PrestaShop necesita escribir en las carpetas cache, log y themes. Si el servidor no permite la escritura, verás errores relacionados.

Solución:

Asegúrate de que las carpetas cache, log y var tengan permisos 755 (o 777 temporalmente).
Si el error persiste, comprueba que el propietario de los archivos es el mismo que el usuario de cPanel. A veces, al subir archivos por FTP, el propietario cambia y causa problemas.

Cómo verificar el propietario en cPanel:

En el Administrador de archivos, haz clic derecho en la carpeta y selecciona "Cambiar permisos".
Verás el "Propietario" del archivo. Debe coincidir con tu usuario de cPanel.

4. Problemas de instalación de PrestaShop en cPanel por versiones antiguas

Si estás intentando instalar una versión antigua de PrestaShop (1.6 o 1.7), es probable que te encuentres con incompatibilidades con PHP 8.x. Los hosts modernos ya no soportan PHP 5.6 o 7.0 de forma segura.

La solución más sencilla: instala la última versión de PrestaShop (8.x). Si necesitas una versión antigua por compatibilidad con un módulo, tendrás que buscar un hosting que permita seleccionar PHP 7.1 o inferior, y aun así, es arriesgado.

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el puerto de acceso es el 2106. Ten en cuenta que aunque la interfaz sea diferente, los pasos de instalación son los mismos: subir archivos, crear base de datos y ajustar PHP. La única diferencia es que en Syspanel la gestión de PHP a veces está en una sección llamada "Avanzado".

5. Preguntas frecuentes (FAQ) sobre errores de PrestaShop en cPanel

¿Cuánto tiempo tarda la instalación de PrestaShop?

Normalmente, entre 5 y 10 minutos si el hosting es decente. Si se queda colgado más de 15 minutos, revisa la memoria PHP y los permisos.

¿Puedo instalar PrestaShop en un subdominio?

Sí. Solo tienes que crear el subdominio en cPanel, ir a su carpeta raíz (dentro de public_html) y seguir los mismos pasos.

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

Ejecuta el comprobador de requisitos que viene en el paquete de instalación (archivo check-requirements.php). Súbelo a tu servidor y ábrelo en el navegador. Te dirá qué falta.

¿Qué hago si después de instalar veo un error de conexión a la base de datos en el back office?

Esto suele pasar si cambiaste la contraseña de MySQL después de la instalación. Edita el archivo config/settings.inc.php y actualiza las credenciales manualmente.

¿Es necesario usar el instalador web de PrestaShop?

Sí, es la forma más fácil. No intentes configurar la tienda manualmente sin el instalador, a menos que seas un desarrollador muy experimentado.

6. Resumen: checklist final para evitar problemas de PrestaShop en cPanel

Antes de dar por terminada la instalación, revisa esta lista:

PHP 7.4 o superior seleccionado en cPanel.
Extensiones curl, pdo_mysql, openssl, gd y zip activadas.
Archivos subidos a la carpeta correcta (public_html o subcarpeta).
Base de datos creada con usuario y privilegios completos.
Permisos de carpetas en 755 y archivos en 644.
memory_limit configurado a 256M o más.
Carpeta config con permisos 777 durante la instalación y 755 después.
.htaccess visible y sin errores.

Si has seguido todos estos pasos, tu instalación de PrestaShop en cPanel debería completarse sin contratiempos. Recuerda que la mayoría de los problemas de PrestaShop no son errores del software, sino de configuración del servidor. Con un poco de paciencia y esta guía, los resolverás.

Y si algo sigue fallando, no dudes en mirar los logs de error de cPanel (sección "Errores" o "Error Log") para obtener pistas más exactas. ¡Buena suerte con tu tienda!