Solución a errores comunes de instalación de PrestaShop en Plesk
Instalar PrestaShop en un servidor Plesk es una tarea bastante habitual, pero a veces pueden surgir pequeños contratiempos que te hacen perder tiempo. Desde problemas con los permisos de archivos hasta errores de conexión a la base de datos, pasando por conflictos con la versión de PHP o el módulo SEO Friendly URLs. En este artículo, vamos a desgranar los errores más comunes de instalación de PrestaShop en Plesk y te daremos soluciones paso a paso para que puedas tener tu tienda online funcionando en minutos.
Si estás leyendo esto porque te has topado con un mensaje de error, no te preocupes. La mayoría de los problemas tienen una solución sencilla que puedes aplicar tú mismo desde el panel de Plesk. Vamos a ello.
1. Error de conexión a la base de datos durante la instalación
Este es, sin duda, uno de los errores de instalación PrestaShop Plesk más frecuentes. Aparece cuando el instalador de PrestaShop no puede comunicarse con la base de datos MySQL que has creado.
Síntoma típico: Ves un mensaje como "No se puede conectar a la base de datos" o "Error al crear la base de datos".
Causas principales:
- El nombre de la base de datos, el usuario o la contraseña son incorrectos.
- El usuario de la base de datos no tiene todos los privilegios necesarios.
- El servidor de base de datos no está accesible (a veces en Plesk el host no es "localhost" sino "127.0.0.1" o el nombre del servidor).
Solución paso a paso:
- Verifica los datos en Plesk: Ve a tu panel de Plesk, busca la sección "Bases de datos" y anota exactamente el nombre de la base de datos, el usuario y la contraseña. Copia y pega estos datos en el instalador, no los escribas a mano.
- Comprueba los privilegios del usuario: En Plesk, dentro de la base de datos, asegúrate de que el usuario asociado tenga marcados todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.). Si no está seguro, elimina el usuario y vuelve a asignarlo con todos los permisos.
- Host de la base de datos: En el campo "Servidor de base de datos" del instalador de PrestaShop, prueba primero con
localhost. Si no funciona, usa127.0.0.1. En algunos casos, Plesk puede requerir el nombre completo del servidor (algo comomysql.tudominio.com). Si no estás seguro, consulta con tu proveedor de hosting.
[TIP] Si usas un hosting compartido, el nombre de la base de datos suele incluir un prefijo con tu nombre de usuario (ej: usuario_bd_prestashop). Asegúrate de escribirlo completo.
2. Problemas con los permisos de archivos y carpetas
PrestaShop necesita escribir en ciertos directorios (como config, cache, img, log, upload, download) para funcionar correctamente. Si los permisos no son los adecuados, la instalación se detendrá o la tienda dará errores extraños.
Síntoma típico: Mensajes como "No se puede escribir en el directorio /config" o "Error al crear el archivo settings.inc.php".
Causa principal: El usuario del servidor web (normalmente www-data o apache) no tiene permisos de escritura en las carpetas necesarias.
Solución paso a paso:
- Accede al Administrador de Archivos de Plesk. Puedes hacerlo desde el panel de control de tu hosting.
- Navega hasta la carpeta raíz donde has instalado PrestaShop (normalmente
httpdocsopublic_html). - Selecciona TODAS las carpetas que mencionamos arriba (
config,cache,img,log,upload,download, etc.). - Cambia los permisos a 755 para las carpetas y a 644 para los archivos. En Plesk, puedes hacer esto desde el menú "Permisos" o "Cambiar permisos".
- Importante: Asegúrate de que el propietario de los archivos sea el usuario del sistema (normalmente el mismo que tu cuenta de Plesk). Si no, puedes usar la opción "Reparar permisos" que suelen incluir algunos paneles.
[WARNING] No pongas permisos 777 en todas las carpetas. Es un riesgo de seguridad grave. Usa 755 para carpetas y 644 para archivos.
3. Error de versión de PHP no compatible
PrestaShop es exigente con la versión de PHP. Cada versión de PrestaShop requiere una versión específica de PHP. Instalar una versión incorrecta es una fuente constante de problemas PrestaShop Plesk.
Síntoma típico: La instalación no avanza, ves una pantalla en blanco o un mensaje de error sobre "requisitos de PHP no cumplidos".
Causa principal: Tienes seleccionada una versión de PHP que no es compatible con la versión de PrestaShop que estás instalando.
Solución paso a paso:
- Identifica la versión de PrestaShop que estás instalando. Por ejemplo, PrestaShop 1.7.8 funciona bien con PHP 7.4 o 8.0. PrestaShop 8.x necesita PHP 8.1 o superior.
- Ve a la sección "PHP Settings" en el panel de tu dominio dentro de Plesk.
- Cambia la versión de PHP a una que sea compatible. Te recomiendo usar siempre la versión recomendada por PrestaShop para tu versión.
- Guarda los cambios y vuelve a intentar la instalación.
[INFO] Si no sabes qué versión de PHP elegir, consulta la documentación oficial de PrestaShop. Lo más seguro es usar PHP 8.1 para PrestaShop 8.x y PHP 7.4 para versiones 1.7.x.
4. Error con el módulo "SEO Friendly URLs" (rewrite_module)
Para que las URLs amigables de PrestaShop funcionen (ej: tutienda.com/categoria/producto en lugar de tutienda.com/index.php?id_product=1), el servidor web debe tener activado el módulo mod_rewrite de Apache.
Síntoma típico: Después de la instalación, las URLs de tu tienda no funcionan correctamente, dan error 404 o te redirigen mal.
Causa principal: El módulo mod_rewrite no está habilitado en la configuración de Apache de tu dominio.
Solución paso a paso:
- Accede a "Apache & nginx Settings" dentro de la configuración de tu dominio en Plesk.
- Busca la opción "Additional directives for HTTPS" (o similar). Si no la ves, busca en la sección de "Additional configuration directives".
- Añade estas líneas al final del cuadro de texto:
<IfModule mod_rewrite.c> RewriteEngine On </IfModule> - Guarda los cambios. Plesk reiniciará automáticamente el servidor web para aplicar la configuración.
- Ve al back office de tu PrestaShop (tu-dominio.com/adminXXXXX), entra en "Configuración de la tienda" -> "Parámetros de la tienda" -> "Tráfico y SEO" y activa "URLs amigables".
[TIP] Si después de esto sigues teniendo problemas, asegúrate de que el archivo .htaccess en la raíz de tu PrestaShop esté presente y tenga contenido. Si no, puedes regenerarlo desde el back office desactivando y volviendo a activar las URLs amigables.
5. Error de memoria PHP insuficiente (memory_limit)
PrestaShop, especialmente durante la instalación y la carga de productos con muchas imágenes, puede consumir bastante memoria PHP. Si el límite es demasiado bajo, la instalación fallará o verás errores de "Fatal error: Allowed memory size exhausted".
Síntoma típico: La instalación se queda colgada en algún punto, o ves un error en blanco con un mensaje de memoria.
Causa principal: El límite de memoria PHP (memory_limit) es demasiado bajo (por defecto suele ser 128M o incluso 64M).
Solución paso a paso:
- Ve a "PHP Settings" de tu dominio en Plesk.
- Busca la opción "memory_limit".
- Cámbiala a un valor más alto. Te recomiendo al menos 256M para la instalación, y 512M si tu tienda va a ser grande. Puedes ponerlo a "256M" o "512M".
- Guarda los cambios.
- Reintenta la instalación. Si el error persiste, sube el límite a 1024M temporalmente.
[WARNING] No dejes el memory_limit en 1024M permanentemente si no es necesario. Es un ajuste de rendimiento. Una vez instalada la tienda, puedes bajarlo a 256M o 512M.
6. Error de instalación por falta de extensiones PHP (como cURL, GD, etc.)
PrestaShop necesita varias extensiones de PHP para funcionar. Las más comunes son cURL (para conexiones externas), GD (para procesar imágenes), PDO (para la base de datos) y OpenSSL (para seguridad).
Síntoma típico: Durante la comprobación de requisitos previos a la instalación, ves una lista de extensiones que están "No disponible" o "Desactivada".
Causa principal: Esas extensiones no están habilitadas en la configuración de PHP de tu dominio.
Solución paso a paso:
- Ve a "PHP Settings" de tu dominio en Plesk.
- Busca la lista de extensiones (suele llamarse "Extensions" o "PHP extensions").
- Asegúrate de que las siguientes extensiones estén marcadas como "Activo" (o "On"):
curlgdpdopdo_mysqlopenssljsonmbstringzipfileinfointl
- Si alguna no está activada, actívala y guarda los cambios.
- Reintenta la instalación.
[INFO] En algunos planes de hosting compartido, la activación de extensiones puede requerir que contactes con el soporte técnico. En Plesk dedicado o VPS, suele ser inmediato.
7. Error de instalación por límite de tiempo de ejecución (max_execution_time)
La instalación de PrestaShop puede llevar varios minutos, especialmente si tienes una conexión lenta o muchos módulos. Si el límite de tiempo de ejecución de PHP es demasiado bajo, el proceso se corta.
Síntoma típico: La instalación se queda en "Cargando..." y después de un rato aparece un error o la página se vuelve blanca.
Causa principal: El valor max_execution_time está en 30 segundos (por defecto) y la instalación necesita más tiempo.
Solución paso a paso:
- Ve a "PHP Settings" en Plesk.
- Busca "max_execution_time".
- Cámbialo a 300 (5 minutos) o incluso 600 (10 minutos) para la instalación.
- Guarda los cambios.
- Reintenta la instalación.
[TIP] Después de la instalación, puedes bajar este valor a 120 o 180 segundos para producción.
8. Problemas con el archivo .htaccess y las reglas de reescritura
A veces, el archivo .htaccess que genera PrestaShop durante la instalación no se crea correctamente o entra en conflicto con reglas existentes de Plesk (por ejemplo, para redirecciones de dominio o SSL).
Síntoma típico: Tras la instalación, la tienda carga mal, da errores 500 o las URLs no funcionan.
Causa principal: El .htaccess está corrupto, vacío o tiene reglas incorrectas.
Solución paso a paso:
- Conéctate al servidor por FTP o usa el Administrador de Archivos de Plesk.
- Localiza el archivo
.htaccessen la carpeta raíz de tu PrestaShop. - Haz una copia de seguridad del archivo (por si acaso).
- Elimina el archivo
.htaccess(no te preocupes, lo puedes regenerar). - Ve al back office de PrestaShop (si puedes acceder) y desactiva y vuelve a activar las URLs amigables. Esto regenerará el
.htaccesscorrectamente. - Si no puedes acceder al back office, crea un archivo
.htaccessnuevo con el siguiente contenido básico:
(Esto es solo para que la tienda funcione de forma básica, luego deberás regenerarlo desde el back office).RewriteEngine On RewriteRule ^(.*)$ /index.php [QSA,L]
Preguntas Frecuentes (FAQ)
¿Por qué mi instalación de PrestaShop en Plesk da error de "500 Internal Server Error"?
Suele deberse a un error en el archivo .htaccess, a un problema de permisos en la carpeta config o a una versión de PHP incorrecta. Revisa los puntos 2, 3 y 8 de este artículo.
¿Puedo instalar PrestaShop en un subdominio con Plesk?
Sí, perfectamente. El proceso es el mismo. Solo asegúrate de que la carpeta de destino del subdominio esté vacía y que tengas los permisos correctos.
¿Qué hago si el instalador de PrestaShop no encuentra la base de datos?
Revisa el punto 1. Asegúrate de que el nombre de la base de datos, el usuario y la contraseña son exactamente los que ves en Plesk. Prueba con 127.0.0.1 como host si localhost no funciona.
¿Cómo puedo saber qué versión de PHP necesito para mi PrestaShop?
Consulta la documentación oficial de PrestaShop. En general, PrestaShop 1.7.8 necesita PHP 7.4, y PrestaShop 8.x necesita PHP 8.1 o 8.2.
¿Es necesario activar el módulo mod_rewrite en Plesk?
Sí, para que las URLs amigables funcionen. Si no lo activas, tu tienda tendrá URLs largas y poco amigables para el SEO. Sigue los pasos del punto 4.
Conclusión
Como has visto, la mayoría de los errores comunes de instalación de PrestaShop en Plesk tienen solución y no requieren ser un experto en servidores. Con un poco de paciencia y siguiendo estos pasos, podrás tener tu tienda online funcionando sin problemas.
Recuerda siempre:
- Verificar los permisos de archivos y carpetas.
- Elegir la versión de PHP correcta.
- Asegurarte de que las extensiones PHP necesarias están activadas.
- Configurar correctamente la base de datos y el host.
Si después de todo esto el error persiste, no dudes en contactar con el soporte técnico de tu hosting. Ellos podrán revisar la configuración específica de tu servidor Plesk.
¡Esperamos que este artículo te haya sido de gran ayuda! Ahora ya puedes solucionar errores PrestaShop como un profesional. ¡Buena suerte con tu tienda online!
