Errores comunes al instalar PrestaShop y cómo solucionarlos en tu hosting

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

Instalar PrestaShop puede parecer una tarea sencilla, pero la realidad es que es un software muy completo que requiere de un entorno servidor específico para funcionar correctamente. Si tu hosting no cumple con los requisitos mínimos, o si la configuración de PHP no es la adecuada, te encontrarás con errores frustrantes que parecen no tener solución.

Muchos de estos problemas no son culpa tuya, sino de la configuración por defecto de muchos servidores. La buena noticia es que el 90% de los errores PrestaShop más comunes tienen una solución clara y paso a paso. En esta guía, vamos a desglosar los fallos más habituales durante la instalación PrestaShop y te mostraré cómo solucionarlos directamente desde el panel de control de tu PrestaShop hosting.

Vamos a ello, sin rodeos y con soluciones prácticas.

1. El error "PHP no cumple con los requisitos mínimos" o pantalla en blanco

Este es, con diferencia, el error más común al instalar PrestaShop problemas de compatibilidad. Verás un mensaje similar a "Para instalar PrestaShop, necesitas PHP 7.1 o superior" o simplemente una página en blanco sin ningún texto.

¿Por qué ocurre?

PrestaShop es exigente con la versión de PHP y las extensiones habilitadas. Muchos hostings económicos todavía usan PHP 5.6 o versiones antiguas de PHP 7.0 por defecto. Además, aunque tengas una versión reciente, puede que falten extensiones como curl, gd o mbstring.

La solución: Cambiar la versión de PHP desde el panel de control

No necesitas ser un experto en servidores para arreglarlo. Sigue estos pasos:

1. Accede a tu panel de control de hosting (cPanel, Plesk, Syspanel o el que use tu proveedor).
2. Busca la sección "Gestión de PHP", "Select PHP Version" o "MultiPHP Manager".
3. Selecciona la versión más reciente y estable de PHP (idealmente PHP 8.0 o superior para versiones modernas de PrestaShop).
4. Guarda los cambios y vuelve a intentar la instalación.

[TIP] Si tu hosting usa Syspanel (accesible por el puerto 2106), la opción para cambiar PHP suele estar en "Configuración de servidor" > "PHP Versions". Es un proceso muy similar al de cPanel.

[WARNING] Si cambias la versión de PHP en un sitio web ya existente, este podría dar errores. Hazlo solo si estás en un entorno de instalación nueva o si sabes lo que haces.

2. Error de conexión a la base de datos MySQL

Otro clásico. Ves el mensaje "No se puede conectar a la base de datos" o "Error al crear la base de datos". Este error es más común de lo que piensas y casi siempre se debe a un error humano en los datos de conexión.

La solución: Verifica los datos y los permisos del usuario

Asegúrate de tener a mano los datos exactos de tu base de datos. Muchas veces el error viene porque confundimos el nombre de usuario con el nombre de la base de datos.

1. Crea la base de datos y un usuario con todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.) desde tu panel de control.
2. Anota estos tres datos exactamente:
   • Nombre de la base de datos (ej: usuario_prestashop).
   • Nombre de usuario de la BD (ej: usuario_admin).
   • Contraseña del usuario de la BD.
3. En el asistente de instalación de PrestaShop, introduce estos datos sin espacios.
4. En el campo "Prefijo de tablas", usa ps_ por defecto.

[INFO] En algunos hostings, el nombre del servidor de base de datos no es localhost. Puede ser algo como mysql.tudominio.com o localhost:3306. Consulta la documentación de tu hosting si localhost no funciona.

3. Permisos de escritura en carpetas (Error 500 o "No se puede escribir en config/")

PrestaShop necesita crear y modificar archivos en varias carpetas durante su instalación. Si el servidor no tiene permisos de escritura, verás errores como "Fallo al escribir el archivo settings.inc.php" o un error 500 genérico.

¿Por qué ocurre?

Los archivos y carpetas en tu servidor tienen permisos (lectura, escritura y ejecución). A veces, por seguridad, estos permisos están restringidos.

La solución: Ajustar los permisos a 755 o 777

1. Accede a tu Administrador de Archivos en el panel de control o usa un cliente FTP como FileZilla.
2. Ve a la carpeta raíz donde estás instalando PrestaShop (normalmente public_html o www).
3. Selecciona todas las carpetas y archivos.
4. Haz clic derecho y selecciona "Permisos de archivo" o "CHMOD".
5. Introduce el valor 755 para carpetas y 644 para archivos.
6. Si el error persiste, prueba con 777 temporalmente en las carpetas config, cache, log y img. No dejes estos permisos de forma permanente por seguridad.

[WARNING] Los permisos 777 son un riesgo de seguridad. Úsalos solo para solucionar el error y vuelve a cambiarlos a 755 en cuanto termine la instalación.

4. El instalador se queda atascado en el paso 2 o 3 (carga infinita)

Este es un problema muy frustrante. El asistente de instalación avanza hasta cierto punto y luego se queda cargando sin fin, o simplemente se detiene.

La causa: Falta de memoria PHP o servidor lento

PrestaShop es una aplicación pesada. Si tu servidor tiene un límite de memoria PHP muy bajo (por ejemplo, 64M), el instalador no tiene recursos suficientes para completar todas las tareas.

La solución: Aumentar el límite de memoria PHP

Necesitas modificar el valor de memory_limit en tu servidor.

1. Ve a la Configuración de PHP (la misma sección del punto 1).
2. Busca la opción memory_limit.
3. Cámbiala a 256M o 512M.
4. Guarda los cambios y limpia la caché del navegador antes de reintentar.

[TIP] También puedes crear un archivo llamado php.ini en la raíz de tu instalación con el siguiente código:

memory_limit = 512M
max_execution_time = 300

5. Error de "URL no válida" o "Tienda no encontrada" tras instalar

La instalación termina correctamente, pero al entrar a tu tienda ves un mensaje de error o te redirige a una página que no existe.

El problema: Configuración incorrecta de la URL en el instalador

Este error suele ocurrir si introduces mal la URL de la tienda durante el proceso de instalación, o si usas localhost en lugar de tu dominio real.

La solución: Corregir la URL desde la base de datos

No necesitas reinstalar todo. Puedes arreglarlo rápido:

1. Accede a phpMyAdmin (o la herramienta de gestión de BD de tu hosting).
2. Selecciona tu base de datos de PrestaShop.
3. Busca la tabla ps_configuration (o prestashop_configuration).
4. Busca las filas con los nombres PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL.
5. Haz clic en "Editar" y cambia el valor a tu dominio real (ej: www.mitienda.com).
6. Guarda los cambios y limpia la caché de PrestaShop desde el panel de administración (Parámetros avanzados > Rendimiento).

[INFO] Este error es muy común si estás probando la instalación en un subdominio o una carpeta temporal y luego mueves los archivos.

6. El error de "cURL error 60" o problemas con SSL

Cada vez es más común que los instaladores de PrestaShop fallen por temas de certificados SSL. Verás mensajes como "cURL error 60: SSL certificate problem".

La solución: Actualizar los certificados CA o desactivar la verificación temporalmente

Este es un problema del servidor, no de tu código.

1. Si tienes acceso a la configuración de PHP, busca la opción curl.cainfo y asegúrate de que apunta a un archivo cacert.pem válido.
2. Si no puedes modificar eso, una solución rápida (aunque menos segura) es añadir una línea al archivo config/defines.inc.php de PrestaShop:

define('_PS_CURL_ENABLED_', false);

[WARNING] Esta solución desactiva las comprobaciones de seguridad de cURL. Úsala solo para pasar el instalador y luego revierte el cambio.

7. Problemas con la versión de MySQL o MariaDB

PrestaShop no solo necesita PHP, también requiere una versión específica de MySQL (5.7 o superior) o MariaDB (10.2 o superior).

La solución: Verificar la versión en tu hosting

1. Ve a phpMyAdmin y mira la versión en la parte inferior de la pantalla.
2. Si tu versión es inferior a la requerida, contacta con tu proveedor de hosting para que la actualicen o te migren a un servidor con versiones más modernas.

[TIP] Si estás en un hosting compartido antiguo y no pueden actualizar MySQL, considera migrar a un PrestaShop hosting que use servidores NVMe y versiones de software actualizadas. La diferencia de rendimiento y estabilidad es abismal.

8. El error "No se puede cargar la clase" o archivos corruptos

A veces, durante la descarga o subida de los archivos de PrestaShop, estos se corrompen o no se suben completos. Esto genera errores extraños como "Clase 'Controller' no encontrada".

La solución: Re-subir los archivos desde cero

1. Elimina todos los archivos de la carpeta donde intentas instalar.
2. Descarga una nueva copia de PrestaShop desde el sitio oficial.
3. Descomprime el archivo en tu ordenador antes de subirlo. No lo descomprimas en el servidor.
4. Usa FileZilla o el Administrador de Archivos para subir todos los archivos de nuevo.

[INFO] Este error es más común de lo que parece, especialmente si usas el descompresor del hosting. Siempre es mejor descomprimir en local y subir los archivos ya extraídos.

9. Problemas con el "mod_rewrite" y las URLs amigables

Después de instalar, activas las URLs amigables y toda tu tienda da error 404.

La solución: Activar el módulo de reescritura en el servidor

1. Si usas Apache, asegúrate de que el módulo mod_rewrite esté activado. En cPanel suele estar en "Apache Handlers" o ya activado por defecto.
2. Si usas Nginx, necesitas añadir reglas específicas en la configuración del servidor. Esto es más técnico y puede requerir ayuda del soporte.

[TIP] Una solución rápida si no puedes activar mod_rewrite es ir a Parámetros avanzados > SEO y URLs en el back-office de PrestaShop y desactivar la opción "Usar URL amigables". La tienda funcionará, aunque las URLs serán más largas.

10. El instalador no avanza del paso "Sistema de compatibilidad"

Este paso verifica que tu servidor cumple con todos los requisitos. Si se queda aquí, es que algo no está bien configurado, pero el mensaje no es claro.

La solución: Revisar los requisitos uno a uno

1. En el propio instalador, hay una tabla que muestra "Requisitos" y "Recomendaciones".
2. Los que están en rojo son obligatorios. Los que están en amarillo son recomendados.
3. Anota los que fallan y busca cómo activarlos en tu panel de control.
4. Los más comunes son: allow_url_fopen, file_uploads y openssl. Todos se activan desde la configuración de PHP.

Preguntas frecuentes (FAQ) sobre errores de instalación

¿Puedo instalar PrestaShop en cualquier hosting?

No. Necesitas un hosting que cumpla con los requisitos de PHP y MySQL. Los hostings muy básicos o antiguos suelen dar problemas. Busca un PrestaShop hosting que ofrezca PHP 8+ y MySQL 5.7+.

¿Qué hago si no encuentro la opción de cambiar PHP en mi panel?

Si tu hosting usa Syspanel (puerto 2106), busca en "Ajustes del sitio" o "Entorno de ejecución". Si no la encuentras, contacta con el soporte de tu proveedor y pídeles que cambien la versión de PHP.

¿Es necesario usar SSL para instalar PrestaShop?

No es obligatorio para la instalación, pero es muy recomendable. PrestaShop funciona mejor con SSL activado y es imprescindible para las pasarelas de pago. Muchos errores de cURL y de conexión se solucionan simplemente teniendo un certificado SSL válido instalado.

¿Cómo sé si mi servidor es compatible antes de instalar?

PrestaShop tiene un script llamado compatibility.php que puedes subir a tu servidor. Ejecútalo en el navegador y te dirá si tu entorno es compatible. Es una forma rápida de evitar problemas antes de empezar.

¿Debo usar la última versión de PrestaShop siempre?

No necesariamente. A veces las versiones más nuevas requieren requisitos de servidor muy altos. Si tu hosting es limitado, usa una versión más estable y acorde a tus recursos. Siempre mejor una versión antigua estable que una nueva que no puedas ejecutar.

Conclusión: La paciencia es clave en la instalación

Instalar PrestaShop no es difícil, pero requiere atención al detalle. La mayoría de los errores PrestaShop se deben a problemas de configuración del servidor, no a errores del software en sí. Siguiendo estos pasos, resolverás el 99% de los problemas más comunes.

Si después de todo sigues atascado, no dudes en contactar con el soporte de tu hosting. Un buen proveedor de PrestaShop hosting conoce estos errores y puede ayudarte a configurar el servidor para que la instalación sea un paseo. Recuerda que la solución casi siempre está en ajustar PHP, los permisos y la base de datos. ¡Mucha suerte con tu tienda online!