Errores comunes en la instalación de PrestaShop y cómo solucionarlos
¡Bienvenido! Si estás aquí, probablemente has intentado instalar PrestaShop y te has encontrado con algún obstáculo. No te preocupes, es más común de lo que crees. Instalar una tienda online puede parecer complejo, pero la mayoría de los problemas tienen soluciones sencillas. En esta guía, vamos a repasar los errores prestashop más frecuentes durante la instalación y te daremos pasos claros para solucionar problemas prestashop.
Vamos a desglosar cada error, desde los problemas de configuración del servidor hasta los conflictos con archivos. Al final, tendrás un checklist para que tu instalación sea un éxito.
1. Error de memoria PHP (Fatal error: Allowed memory size exhausted)
Este es uno de los prestashop errores instalacion más habituales. Aparece porque PrestaShop necesita un mínimo de memoria para ejecutarse, y tu servidor tiene un límite demasiado bajo. El mensaje típico es algo como: "Fatal error: Allowed memory size of 33554432 bytes exhausted".
¿Cómo solucionarlo?
El problema es que el límite de memoria de PHP es muy bajo (normalmente 32MB o 64MB). PrestaShop recomienda al menos 256MB.
Paso 1: Localiza el archivo php.ini
Este archivo controla la configuración de PHP. Puedes encontrarlo en la raíz de tu hosting o en una carpeta como /etc/. Si usas un panel de control como Syspanel (accesible por el puerto 2106), busca la sección de "PHP Settings" o "Configuración de PHP".
Paso 2: Aumenta el límite
Busca la línea: memory_limit = 64M (o un valor similar). Cámbiala a: memory_limit = 256M. Si no ves la línea, puedes añadirla al final del archivo.
Paso 3: Guarda y reinicia el servidor web
Guarda los cambios y, desde tu panel, reinicia Apache o Nginx. En Syspanel, suele haber un botón "Reiniciar servicios".
[TIP] Si no encuentras el php.ini, puedes crear un archivo llamado php.ini en la raíz de tu instalación de PrestaShop y escribir dentro: memory_limit = 256M. Esto anulará la configuración global.
2. Error "500 Internal Server Error" al acceder a la tienda
Un error 500 puede deberse a muchas causas, pero en la instalación suele ser por permisos incorrectos de archivos o carpetas, o por un archivo .htaccess mal configurado.
Causa más común: Permisos de archivos
PrestaShop necesita que ciertas carpetas tengan permisos de escritura para que el instalador pueda crear archivos de configuración.
Paso 1: Conéctate a tu servidor por FTP o mediante el administrador de archivos de Syspanel (puerto 2106).
Paso 2: Cambia los permisos de las siguientes carpetas a 755 (o 777 si es necesario, pero 755 suele ser suficiente):
/config//cache//log//img//mails//modules//themes//translations//upload//download/
En la mayoría de clientes FTP, haz clic derecho sobre la carpeta, selecciona "Permisos de archivo" y escribe 755. Marca "Recurrir en subdirectorios" si aparece.
Causa secundaria: Archivo .htaccess corrupto
A veces, un .htaccess generado por otro script o por un plugin de caché causa conflictos.
Paso 1: Renombra el archivo .htaccess a .htaccess_old (desde FTP o el administrador de archivos).
Paso 2: Intenta acceder de nuevo a tu tienda. Si funciona, PrestaShop regenerará el .htaccess automáticamente la próxima vez que guardes la configuración de la tienda.
3. Error de conexión a la base de datos (Error establishing a database connection)
Este error aparece cuando el instalador no puede conectar con MySQL o MariaDB. Las causas pueden ser datos incorrectos o que el servidor de base de datos no esté accesible.
Solución paso a paso
Paso 1: Verifica los datos de conexión
Durante la instalación, te pide: servidor de base de datos, nombre de usuario, contraseña y nombre de la base de datos. Asegúrate de que:
- El servidor suele ser "localhost" (o "127.0.0.1"), a menos que tu hosting te dé uno específico.
- El usuario y la contraseña son los correctos. Si usas Syspanel, puedes crear una base de datos y un usuario desde la sección "Bases de datos".
Paso 2: Comprueba que la base de datos existe
A veces el instalador no crea la base de datos automáticamente. Debes crearla manualmente desde tu panel de control. En Syspanel, ve a "Bases de datos" > "Crear nueva base de datos". Anota el nombre exacto.
Paso 3: Verifica los privilegios del usuario
El usuario debe tener todos los privilegios sobre la base de datos. En Syspanel, al crear el usuario, asegúrate de marcar "Todos los privilegios".
[WARNING] No uses caracteres especiales ni espacios en el nombre de la base de datos. PrestaShop puede tener problemas con ellos.
4. Error "PrestaShop no puede instalar porque la versión de PHP es demasiado baja"
PrestaShop 8 requiere PHP 7.4 o superior. Si tu servidor tiene una versión anterior, la instalación se detendrá.
Cómo actualizar PHP
Paso 1: Accede a tu panel de control. En Syspanel (puerto 2106), busca la sección "PHP Version" o "Seleccionar versión de PHP".
Paso 2: Selecciona la versión recomendada. PrestaShop 1.7 y 8 funcionan bien con PHP 8.0 o 8.1. Elige la más reciente que esté disponible.
Paso 3: Guarda los cambios. El panel puede tardar unos segundos en aplicar la nueva versión. Luego reinicia el servidor web desde la misma sección.
[INFO] Si no ves la opción de cambiar PHP, contacta a tu proveedor de hosting. Algunos planes compartidos no permiten cambiar la versión.
5. Error de tiempo de ejecución (Max execution time exceeded)
Durante la instalación, especialmente si tienes muchos módulos o una base de datos grande, PHP puede agotar el tiempo máximo de ejecución (normalmente 30 segundos).
Aumenta el límite de tiempo
Paso 1: Edita el php.ini (como en el error de memoria). Busca la línea: max_execution_time = 30. Cámbiala a: max_execution_time = 300 (5 minutos).
Paso 2: También puedes editarlo desde el archivo .htaccess (si no tienes acceso al php.ini). Añade esta línea al final del .htaccess en la raíz de tu tienda:
php_value max_execution_time 300
6. Error de escritura en la carpeta de archivos temporales
A veces, el instalador no puede escribir archivos temporales porque la carpeta /tmp no existe o no tiene permisos.
Solución
Paso 1: Crea la carpeta /tmp en la raíz de tu instalación de PrestaShop (junto a las carpetas como /config, /img, etc.).
Paso 2: Dale permisos 755 (o 777 si persiste el error).
Paso 3: Verifica que tu php.ini tenga configurado el directorio temporal. Busca: upload_tmp_dir = "/tmp". Si no está, añádelo.
7. Error "No se puede abrir el archivo de configuración"
Este error suele aparecer cuando el archivo settings.inc.php (en la carpeta /config) no tiene permisos de escritura o está corrupto.
Cómo arreglarlo
Paso 1: Elimina el archivo settings.inc.php de la carpeta /config (si existe) para que el instalador lo regenere.
Paso 2: Dale permisos 777 a la carpeta /config temporalmente durante la instalación. Después de instalar, puedes volver a 755.
Paso 3: Vuelve a ejecutar la instalación desde el principio.
8. Error de compatibilidad con módulos o temas
Si descargaste un tema o módulo antes de instalar PrestaShop, puede causar conflictos.
Solución
Paso 1: Desactiva todos los módulos no esenciales durante la instalación. Solo instala los que vienen por defecto.
Paso 2: Si el error persiste, borra la carpeta /modules y vuelve a subir la versión limpia de PrestaShop. Luego, durante la instalación, no selecciones ningún módulo adicional.
[TIP] Siempre instala PrestaShop en su estado más básico. Luego, añade módulos y temas uno por uno para identificar posibles conflictos.
9. Error de URL amigable (URL rewriting)
Si después de instalar ves URLs con "index.php?..." en lugar de "/producto.html", es porque las URL amigables no están activadas o el servidor no las soporta.
Cómo activarlas
Paso 1: Ve a "Configuración de la tienda" > "Parámetros de la tienda" > "Tráfico y SEO".
Paso 2: Activa "URL amigables" y guarda los cambios.
Paso 3: Si no funciona, verifica que el módulo mod_rewrite de Apache esté activado. En Syspanel, busca "Apache Modules" y asegúrate de que "rewrite" esté habilitado.
10. Problemas con el certificado SSL (https)
Si intentas instalar PrestaShop en un dominio con HTTPS, pero el instalador muestra errores de conexión segura.
Solución
Paso 1: Asegúrate de que el certificado SSL esté correctamente instalado. En Syspanel, ve a "SSL Certificates" y verifica que el estado sea "Active".
Paso 2: Durante la instalación, en el paso de "Configuración de la tienda", marca la opción "SSL activo" y "SSL en todas las páginas".
Paso 3: Si el error persiste, desactiva temporalmente el SSL, instala PrestaShop en HTTP, y luego actívalo desde el panel de administración.
FAQ: Preguntas Frecuentes
¿Qué hago si después de instalar no puedo acceder al panel de administración?
Revisa que la carpeta /admin (o el nombre que le hayas dado) tenga permisos 755. También verifica que el archivo .htaccess dentro de esa carpeta no esté bloqueando el acceso.
¿Por qué aparece "PrestaShop no puede escribir en la carpeta /config"?
Es un problema de permisos. Dale permisos 777 a la carpeta /config durante la instalación. Luego, después de instalar, cámbiala a 755 por seguridad.
¿Puedo instalar PrestaShop en un subdominio o subdirectorio?
Sí, perfectamente. Solo asegúrate de que la base de datos y los archivos estén en la ubicación correcta. El instalador te pedirá la URL base.
¿Qué versión de PHP es mejor para PrestaShop 8?
PHP 8.0 o 8.1. Evita PHP 8.2 si tienes módulos antiguos, ya que puede haber incompatibilidades.
¿Cómo sé si mi hosting es compatible con PrestaShop?
La mayoría de hostings compartidos lo son, pero verifica que cumplan: PHP 7.4+, MySQL 5.6+, y al menos 256MB de memoria. Si usas Syspanel, puedes revisar estos requisitos en la sección "Información del sistema".
Conclusión
Instalar PrestaShop puede tener sus pequeños desafíos, pero con esta guía tienes las herramientas para solucionar problemas prestashop de manera efectiva. Recuerda siempre verificar los errores prestashop más comunes: permisos, memoria PHP, versión de PHP y conexión a la base de datos.
Si sigues estos pasos, tu tienda online estará funcionando en poco tiempo. ¡No te rindas! Y si tienes dudas, vuelve a consultar esta guía. ¡Buena suerte con tu tienda!
