Solucionar errores instalación PrestaShop en cPanel | SysAdmin

Instalar PrestaShop en un servidor con cPanel puede parecer sencillo, pero la realidad es que surgen muchos errores PrestaShop cPanel que pueden frustrar incluso a usuarios con algo de experiencia. Desde problemas con los permisos de archivos hasta conflictos con la versión de PHP, en esta guía te explicamos los fallos más comunes y, lo más importante, cómo solucionar errores PrestaShop paso a paso.

Si estás buscando una solución para instalar PrestaShop problemas y no sabes por dónde empezar, has llegado al lugar indicado. Vamos a desglosar cada error, su causa y la solución más efectiva para que tu tienda online funcione sin cPanel PrestaShop fallos.

Requisitos previos antes de instalar PrestaShop en cPanel

Antes de lanzarte a la instalación, asegúrate de que tu hosting cumple con los requisitos mínimos de PrestaShop. Muchos errores PrestaShop cPanel se deben a un entorno no compatible.

Versión de PHP: PrestaShop 8.x requiere PHP 7.4 o superior (recomendado PHP 8.0 o 8.1). Verifica en cPanel > "Seleccionar versión de PHP".
Memoria PHP: Debe ser al menos 256 MB. Se configura en el archivo php.ini o desde el selector de PHP de cPanel.
Extensiones PHP: Necesitas tener activas: curl, gd, json, mbstring, openssl, pdo_mysql, xml, zip y fileinfo.
Base de datos: MySQL 5.7+ o MariaDB 10.2+.
Espacio en disco: Al menos 500 MB para la instalación base.

[WARNING] Si usas un plan de hosting compartido básico, es posible que no puedas modificar ciertos parámetros de PHP. En ese caso, contacta con tu proveedor.

Error 1: Pantalla en blanco o error 500 al instalar PrestaShop

Este es uno de los cPanel PrestaShop fallos más desesperantes. La pantalla en blanco suele indicar un error fatal de PHP que no se muestra por falta de configuración de errores.

Causas principales

Versión de PHP incorrecta: PrestaShop no es compatible con PHP 5.x o versiones muy antiguas de PHP 7.
Límite de memoria insuficiente: El proceso de instalación necesita más memoria de la asignada.
Permisos de archivos incorrectos: Los archivos de PrestaShop deben tener permisos 644 y las carpetas 755.
Archivo .htaccess corrupto: Un .htaccess mal generado puede provocar errores 500.

Solución paso a paso

Habilitar la visualización de errores: Temporalmente, edita el archivo config/defines.inc.php (si existe) y cambia _PS_MODE_DEV_ a true. Si no existe, crea un archivo php.ini en la raíz de tu instalación con el siguiente contenido:
```
display_errors = On
error_reporting = E_ALL
```
Esto te mostrará el error específico en lugar de la pantalla en blanco.
Verificar la versión de PHP: Accede a cPanel > "Seleccionar versión de PHP" y elige PHP 8.0 o 8.1. Aplica los cambios.
Aumentar el límite de memoria: Desde el mismo selector de PHP, haz clic en "Opciones" o "Switch to PHP Options" y busca memory_limit. Cámbialo a 256M o 512M.
Corregir permisos: Conéctate por FTP o desde el "Administrador de archivos" de cPanel. Selecciona toda la carpeta de PrestaShop y cambia los permisos a 755 para carpetas y 644 para archivos.
- Para carpetas: find /ruta/a/prestashop -type d -exec chmod 755 {} \;
- Para archivos: find /ruta/a/prestashop -type f -exec chmod 644 {} \;
Renombrar el .htaccess: Temporalmente, renombra el archivo .htaccess a .htaccess_backup e intenta la instalación de nuevo. Si funciona, el problema era el archivo.

[TIP] Si después de esto sigues con el error, revisa los logs de error de cPanel (Errores de Apache) para ver la línea exacta del fallo.

Error 2: "El archivo de configuración no se puede escribir" o "Permisos de escritura"

Este mensaje aparece cuando el instalador de PrestaShop no puede escribir en los archivos de configuración (config/settings.inc.php o app/config/parameters.php).

Causa

El usuario del servidor web (normalmente nobody o www-data) no tiene permisos de escritura en la carpeta de PrestaShop.
El archivo config/settings.inc.php ya existe y está protegido contra escritura.

Solución

Eliminar archivos de configuración previos: Si ya has intentado instalar antes, elimina los archivos config/settings.inc.php y app/config/parameters.php (si existen).
Dar permisos 777 temporalmente: Durante la instalación, puedes dar permisos 777 a la carpeta config y al archivo settings.inc.php (si se crea). Importante: después de la instalación, vuelve a cambiarlos a 755 para la carpeta y 644 para el archivo.
Verificar el propietario del archivo: En cPanel, los archivos suelen pertenecer al usuario de cPanel. Si el servidor web es otro usuario, puede haber conflicto. Usa el "Administrador de archivos" y revisa los permisos. Si ves que el propietario es root o nobody, contacta con tu hosting.

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

Error 3: "No se puede conectar a la base de datos" o "Error al crear la base de datos"

Este error suele aparecer en el paso 3 o 4 del instalador, cuando introduces los datos de la base de datos MySQL.

Causas

Nombre de base de datos incorrecto: En cPanel, el nombre suele tener un prefijo (ej: usuario_prestashop). Debes incluir ese prefijo.
Usuario de base de datos incorrecto: El usuario también tiene prefijo (ej: usuario_admin).
Usuario sin privilegios: El usuario no tiene todos los privilegios sobre la base de datos.
Servidor MySQL no accesible: El servidor de base de datos puede ser localhost, pero a veces es un nombre diferente (ej: mysql.tudominio.com).

Solución

Crear la base de datos y el usuario desde cPanel:
- Ve a "Bases de datos MySQL".
- Crea una nueva base de datos (ej: miusuario_prestashop).
- Crea un nuevo usuario (ej: miusuario_prestashop_user).
- Asigna el usuario a la base de datos con todos los privilegios.
Verificar los datos en el instalador:
- Servidor de base de datos: Normalmente localhost. Si dudas, revisa en cPanel > "Bases de datos MySQL" > "Información de la base de datos".
- Nombre de base de datos: El completo, con el prefijo.
- Usuario: El completo, con el prefijo.
- Contraseña: La que pusiste al crear el usuario.
Probar la conexión: Desde el "Administrador de archivos" de cPanel, crea un archivo test_db.php con este contenido:
```
<?php
$link = mysqli_connect('localhost', 'tu_usuario', 'tu_contraseña', 'tu_base_de_datos');
if (!$link) {
    die('Error de conexión: ' . mysqli_connect_error());
}
echo 'Conectado correctamente';
mysqli_close($link);
?>
```
Ejecútalo desde tu navegador (tudominio.com/test_db.php). Si funciona, el problema está en los datos que pusiste en el instalador.

[INFO] Si usas un hosting con servidores MySQL remotos, el servidor no será localhost. Pregunta a tu proveedor cuál es la dirección correcta.

Error 4: Problemas con las extensiones PHP durante la instalación

El instalador de PrestaShop verifica las extensiones necesarias. Si alguna falta, te mostrará un mensaje de error en rojo.

Extensiones comunes que faltan

curl: Para conexiones externas.
gd: Para procesar imágenes.
mbstring: Para caracteres UTF-8.
zip: Para descomprimir módulos y temas.
fileinfo: Para detectar tipos de archivo.

Solución

Desde el selector de PHP de cPanel: Busca la opción "Extensions" o "PHP Extensions" y activa todas las que falten. Luego haz clic en "Save" o "Apply".
Si no aparece la extensión: Contacta con tu proveedor de hosting. Algunas extensiones requieren permisos especiales.
Verificar después de activar: Vuelve a ejecutar el instalador de PrestaShop. Si el error persiste, reinicia el servicio de PHP desde cPanel (a veces hay que esperar unos minutos).

[TIP] Si no puedes activar fileinfo, prueba a instalar una versión de PrestaShop 1.7.x, que es menos restrictiva.

Error 5: "El dominio no está apuntando a la carpeta correcta" o "No se encuentra la tienda"

Este error PrestaShop cPanel ocurre cuando instalas PrestaShop en una subcarpeta o el dominio raíz no está bien configurado.

Causas

Has subido los archivos a una carpeta incorrecta (ej: public_html/prestashop en lugar de public_html).
El dominio principal no está configurado para apuntar a la carpeta donde instalaste PrestaShop.
Hay un archivo index.html o index.php de otro CMS que interfiere.

Solución

Identificar la carpeta correcta: En cPanel, la carpeta raíz de tu dominio principal suele ser public_html. Si tienes un addon domain, la carpeta suele ser public_html/tudominio.com.
Mover los archivos: Si subiste los archivos a una subcarpeta (ej: public_html/tienda), debes moverlos a la raíz. Con el "Administrador de archivos", corta todos los archivos de la subcarpeta y pégalos en public_html.
Redirigir el dominio (si es necesario): Si quieres que tu tienda esté en tudominio.com/tienda, no necesitas mover nada. Solo asegúrate de que el instalador se ejecute desde tudominio.com/tienda.
Eliminar archivos conflictivos: Borra cualquier index.html, index.php o default.php que no pertenezca a PrestaShop en la carpeta raíz.

[WARNING] Si tienes un sitio web WordPress en la raíz, no instales PrestaShop en la misma carpeta. Crea una subcarpeta como /tienda.

Error 6: "No se puede escribir en la carpeta cache" o "No se puede escribir en la carpeta log"

Este error suele aparecer después de la instalación, al intentar acceder al back office o al front office.

Causas

Las carpetas cache, log y tmp no tienen permisos de escritura para el servidor web.
El propietario de las carpetas no es el usuario del servidor web.

Solución

Permisos 755 o 777 temporalmente: Desde FTP o el "Administrador de archivos", cambia los permisos de las siguientes carpetas a 755 (o 777 si falla):
- /cache
- /log
- /img
- /upload
- /download
- /themes/default-bootstrap/lang
- /translations
- /config
- /app/config
Propietario correcto: Si los permisos no funcionan, el problema puede ser el propietario. Pide a tu hosting que asigne el usuario correcto a estas carpetas.
Después de la instalación: Vuelve a poner permisos 755 en todas las carpetas excepto cache y log, que pueden quedarse en 777 si es necesario.

[INFO] En algunos hosting, el usuario del servidor web es diferente al de FTP. Si es tu caso, necesitarás configurar el suPHP o fastcgi para que los archivos se ejecuten como tu usuario de cPanel.

Error 7: Problemas con la URL amigable (URL rewriting) y errores 404

Después de instalar, las URLs de los productos pueden dar error 404 o no funcionar correctamente.

Causas

El módulo mod_rewrite de Apache no está activado.
El archivo .htaccess no se ha generado correctamente.
La opción "URLs amigables" no está activada en el back office.

Solución

Activar mod_rewrite: En cPanel, ve a "Apache Handlers" o "Apache Modules" y asegúrate de que mod_rewrite está activado. Si no aparece, contacta con tu hosting.
Generar el .htaccess: Accede al back office de PrestaShop (si puedes) > "Configuración de la tienda" > "Configuración de SEO y URLs". Asegúrate de que "URLs amigables" esté en "Sí". Luego haz clic en "Guardar". Esto regenera el .htaccess.
Si no puedes acceder al back office: Crea manualmente un archivo .htaccess en la raíz de PrestaShop con el contenido por defecto. Puedes descargar el contenido estándar de PrestaShop desde su documentación o usar el generado por el instalador (si lo tienes en algún backup).
Verificar permisos del .htaccess: El archivo .htaccess debe tener permisos 644.

[TIP] Si usas un hosting Nginx, las URLs amigables se configuran de forma diferente. Pide ayuda a tu proveedor.

Error 8: "Error de carga de módulos" o "Módulo no encontrado"

Al instalar módulos desde el back office, puede aparecer un error de carga o que el módulo no se encuentra.

Causas

Permisos incorrectos en la carpeta /modules.
Falta la extensión zip o curl.
Límite de tiempo de ejecución de PHP demasiado bajo.

Solución

Permisos en la carpeta modules: Asegúrate de que la carpeta /modules tenga permisos 755 y que el usuario del servidor web pueda escribir en ella.
Activar extensiones: Verifica que zip y curl estén activadas en el selector de PHP de cPanel.
Aumentar el tiempo de ejecución: En el selector de PHP, busca max_execution_time y cámbialo a 300 (5 minutos).
Instalación manual: Si el error persiste, descarga el módulo en ZIP, súbelo a la carpeta /modules y descomprímelo. Luego actívalo desde el back office en "Módulos" > "Módulos instalados".

[WARNING] No instales módulos de fuentes no oficiales. Pueden contener malware o causar conflictos con tu tienda.

Error 9: Problemas con el correo electrónico (SMTP) en PrestaShop

Después de la instalación, los correos de confirmación de pedido no se envían.

Causas

El servidor SMTP no está configurado correctamente.
El puerto SMTP está bloqueado por el hosting.
La función mail() de PHP está deshabilitada.

Solución

Configurar SMTP: En el back office de PrestaShop, ve a "Parámetros avanzados" > "Correo electrónico". Selecciona "Configurar SMTP" e introduce los datos de tu servidor de correo (puedes usar Gmail, tu hosting, etc.).
Usar SMTP de tu hosting: Normalmente, el servidor