Resolución de errores comunes al instalar PrestaShop en cPanel

Antes de Empezar: Entendiendo el Problema

Instalar PrestaShop en un servidor con cPanel puede parecer una tarea sencilla, pero a menudo nos encontramos con errores frustrantes que detienen el proceso. La mayoría de estos problemas no son complejos y tienen soluciones claras, pero si no sabes dónde mirar, pueden consumirte horas de tiempo.

En esta guía, vamos a desglosar los errores PrestaShop más comunes al instalar en cPanel, explicando paso a paso cómo solucionar cada uno. No necesitas ser un experto en programación; solo sigue las instrucciones y presta atención a los detalles.

[TIP]: Antes de comenzar cualquier instalación, asegúrate de tener un backup de tu base de datos y archivos. Esto te ahorrará dolores de cabeza si algo sale mal.

---

Error 1: "Archivo de configuración no encontrado" o "Configuración incompleta"

Este es probablemente el primer obstáculo que verás. El instalador de PrestaShop te dice que no encuentra el archivo settings.inc.php o que está incompleto.

¿Por qué ocurre?

Casi siempre es un problema de permisos de archivos. El script de instalación necesita escribir en el directorio config/ de tu instalación, pero si los permisos son demasiado restrictivos, no puede hacerlo.

La Solución Paso a Paso

1. Ve a tu Administrador de Archivos en cPanel.
2. Navega hasta la carpeta donde subiste PrestaShop (ej: public_html/tienda).
3. Localiza la carpeta config.
4. Haz clic derecho sobre ella y selecciona "Cambiar permisos".
5. Cambia los permisos a 755 (esto da permisos de lectura y ejecución a todos, y escritura solo al propietario).
6. Dentro de la carpeta config, busca el archivo settings.inc.php (si existe). Si existe, cambia sus permisos a 644.
7. Vuelve a intentar la instalación.

Si el archivo no existe, el problema puede ser que la carpeta config no tenga el permiso de escritura correcto. En ese caso, prueba con 777 temporalmente para la instalación y luego vuelve a cambiarlo a 755 al finalizar.

[WARNING]: Nunca dejes los permisos en 777 de forma permanente. Es un riesgo de seguridad grave. Úsalo solo para solucionar el error y revierte los cambios inmediatamente después.

---

Error 2: "Error de conexión a la base de datos" o "No se puede conectar al servidor MySQL"

Este es otro clásico. El instalador no logra comunicarse con tu base de datos, lo que impide continuar.

Causas Comunes

• Nombre de la base de datos incorrecto.
• Usuario de la base de datos incorrecto.
• Contraseña equivocada.
• El usuario no tiene privilegios sobre la base de datos.
• El servidor de base de datos no está disponible (raro, pero posible).

La Solución Paso a Paso

1. Ve a "Bases de datos MySQL" en cPanel.
2. Verifica que la base de datos que creaste exista. Si no, créala ahora.
3. Verifica que el usuario exista. Si no, créalo.
4. Asegúrate de que el usuario esté añadido a la base de datos con TODOS LOS PRIVILEGIOS. Este es el paso que más se olvida.
5. En el instalador de PrestaShop, al pedirte los datos, escribe:
   • Servidor de base de datos: localhost (en el 99% de los casos es esto).
   • Nombre de la base de datos: El nombre completo que ves en cPanel (ej: usuario_prestashop).
   • Usuario: El nombre completo del usuario (ej: usuario_admin).
   • Contraseña: La contraseña exacta que asignaste al usuario.
   • Prefijo de tablas: ps_ (puedes cambiarlo por seguridad, pero déjalo así para simplificar).

[TIP]: En cPanel, los nombres de bases de datos y usuarios siempre llevan el prefijo del usuario principal de la cuenta. Asegúrate de copiarlos exactamente como aparecen.

---

Error 3: "La tienda no se muestra correctamente" o "Solo aparece una página en blanco"

Después de una instalación "exitosa", ves una página en blanco o un error de PHP. Esto es muy frustrante.

¿Por qué ocurre?

Suele ser un problema de versión de PHP o de extensiones de PHP faltantes. PrestaShop es exigente y necesita una configuración específica del servidor.

La Solución Paso a Paso

1. Ve a "Select PHP Version" (o "MultiPHP Manager") en cPanel.
2. Asegúrate de estar usando una versión de PHP compatible con tu versión de PrestaShop. Por ejemplo, PrestaShop 1.7 funciona mejor con PHP 7.1 a 7.4. PrestaShop 8.0 necesita PHP 7.2 o superior (8.0 es ideal).
3. En la misma pantalla, revisa que las extensiones estén habilitadas. Busca y activa estas (si no están ya):
   • curl
   • gd
   • mbstring
   • openssl
   • pdo_mysql
   • zip
   • intl
4. Guarda los cambios.

Si el problema persiste, es posible que necesites aumentar el límite de memoria de PHP. Ve a "MultiPHP INI Editor" y cambia el valor de memory_limit a 256M o 512M.

[INFO]: Una página en blanco también puede ser causada por un error fatal de PHP. Para ver el error, activa el modo debug de PrestaShop editando el archivo config/defines.inc.php y cambiando _PS_MODE_DEV_ de false a true. Esto te mostrará el error exacto en pantalla.

---

Error 4: "Error 500 - Internal Server Error" al acceder a la tienda

Un error 500 es genérico, pero en cPanel casi siempre se debe a un archivo .htaccess corrupto o a una configuración incorrecta de PHP.

La Solución Paso a Paso

1. Ve al Administrador de Archivos.
2. Busca el archivo .htaccess en la raíz de tu instalación de PrestaShop.
3. Renómbralo a .htaccess.bak (esto lo desactiva).
4. Intenta acceder a tu tienda de nuevo.

Si funciona, el problema es el .htaccess. Puedes regenerarlo desde el Back-Office de PrestaShop: ve a Parámetros Avanzados > Rendimiento y haz clic en "Regenerar el archivo .htaccess".

Si renombrarlo no arregla nada, el problema puede ser la versión de PHP. Prueba a cambiar a una versión anterior o posterior desde "Select PHP Version" y observa si el error desaparece.

[WARNING]: Si no puedes acceder al Back-Office para regenerar el archivo, puedes intentar crear uno nuevo manualmente con el contenido básico de PrestaShop. Busca en Google "contenido .htaccess PrestaShop 1.7" y copia el código en un archivo nuevo llamado .htaccess.

---

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

PrestaShop necesita escribir en varias carpetas para funcionar correctamente. Si los permisos no son los adecuados, verás estos errores.

La Solución Paso a Paso

1. Ve al Administrador de Archivos.
2. Navega a la raíz de tu instalación de PrestaShop.
3. Localiza las siguientes carpetas y cambia sus permisos a 755:
   • cache
   • log
   • img
   • mails
   • modules
   • themes
   • translations
   • upload
   • var (en versiones 1.7+)
   • app (en versiones 1.7+)
4. Si el error persiste, cambia los permisos de estas carpetas a 777 temporalmente, instala o soluciona el problema, y luego revierte a 755.

[TIP]: Para simplificar, puedes seleccionar todas las carpetas mencionadas, hacer clic en "Cambiar permisos" y poner 755. Es un buen hábito de seguridad.

---

Error 6: "La URL de la tienda no es correcta" o "Redireccionamientos infinitos"

Este error ocurre a menudo cuando mueves la tienda de un directorio a otro o cambias el dominio.

La Solución Paso a Paso

1. Accede a tu phpMyAdmin desde cPanel.
2. Selecciona la base de datos de tu PrestaShop.
3. Busca la tabla ps_shop_url (el prefijo puede ser diferente si lo cambiaste).
4. Haz clic en "Editar" (el icono de lápiz).
5. Revisa los campos domain, domain_ssl y physical_uri.
   • domain: Debe ser tu dominio sin www (ej: mitienda.com).
   • domain_ssl: Debe ser tu dominio con https:// (ej: https://mitienda.com).
   • physical_uri: Si está en la raíz, debe ser /. Si está en una subcarpeta, debe ser /subcarpeta/.
6. Guarda los cambios.

También puedes forzar la URL correcta desde el archivo config/settings.inc.php (o app/config/parameters.php en 1.7+) buscando las líneas que definen PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL.

---

Error 7: "No se puede instalar el módulo" o "Error al descargar el módulo"

A veces, la instalación base funciona, pero al intentar instalar un módulo o plantilla, falla.

Causas y Soluciones

• Permisos de la carpeta modules: Asegúrate de que tenga permisos 755 o 777 temporalmente.
• Límite de memoria PHP: Aumenta el memory_limit a 256M o 512M en "MultiPHP INI Editor".
• Tiempo de ejecución máximo: Aumenta max_execution_time a 300 o más en el mismo editor.
• El archivo ZIP está corrupto: Descarga el módulo de nuevo e inténtalo.
• Conflicto de versiones: Asegúrate de que el módulo sea compatible con tu versión de PrestaShop.

---

Error 8: Problemas con el SSL / Certificado

Si tu tienda no carga con https:// o tienes errores de contenido mixto, sigue estos pasos.

La Solución Paso a Paso

1. Asegúrate de tener un certificado SSL instalado en cPanel (puedes usar AutoSSL).
2. En el Back-Office de PrestaShop, ve a Parámetros Avanzados > Rendimiento.
3. Activa la opción "Forzar SSL".
4. Ve a Parámetros Avanzados > General y asegúrate de que la URL de la tienda comience con https://.
5. Limpia la caché de PrestaShop desde Parámetros Avanzados > Rendimiento.

---

Preguntas Frecuentes (FAQ)

¿Cuál es la versión de PHP más estable para PrestaShop?

Para PrestaShop 1.7, PHP 7.4 es una excelente opción. Para PrestaShop 8, PHP 8.0 o 8.1 es recomendado. Evita versiones demasiado antiguas o demasiado nuevas que puedan no ser compatibles.

¿Debo usar localhost como servidor de base de datos?

Sí, en cPanel, el servidor de base de datos es siempre localhost. No uses la IP del servidor.

¿Cómo puedo saber si mi hosting es compatible con PrestaShop?

Revisa los requisitos del sistema en la documentación oficial de PrestaShop. En general, cualquier hosting con cPanel, PHP 7.4+ y MySQL 5.6+ debería funcionar.

¿Qué hago si todos estos errores persisten?

Si has intentado todo y nada funciona, el problema puede ser más profundo (por ejemplo, un conflicto con un módulo del hosting). Te recomiendo contactar con el soporte de tu proveedor de hosting, proporcionándoles el mensaje de error exacto.

¿Puedo instalar PrestaShop en un subdirectorio?

Sí, es posible. Solo asegúrate de que la physical_uri en la base de datos refleje el subdirectorio correctamente y que el .htaccess esté configurado para ello.

---

Conclusión y Consejos Finales

Instalar PrestaShop en cPanel no tiene por qué ser una pesadilla. La mayoría de los cPanel errores se reducen a tres causas principales: permisos de archivos, configuración de la base de datos y versión de PHP.

Mi consejo final es que trabajes de forma metódica:

1. Verifica los permisos de las carpetas antes de empezar.
2. Crea la base de datos y el usuario con todos los privilegios.
3. Configura la versión de PHP correcta y las extensiones necesarias.

Siguiendo esta guía, podrás resolver la mayoría de los problemas de instalación fallida sin necesidad de ser un experto. Y recuerda, si te quedas atascado, siempre puedes buscar ayuda en los foros de PrestaShop o en el soporte de tu hosting.

[INFO]: Este artículo cubre los errores más comunes, pero la tecnología cambia. Siempre consulta la documentación oficial de PrestaShop para obtener la información más actualizada sobre requisitos y compatibilidad.