Errores comunes al instalar PrestaShop en Plesk y cómo solucionarlos

Instalar PrestaShop en un servidor Plesk puede parecer un proceso sencillo, pero la realidad es que surgen muchos errores PrestaShop Plesk que pueden frustrar incluso al usuario más paciente. Estos fallos suelen estar relacionados con la configuración del servidor, la versión de PHP o la base de datos. En esta guía extensa, vamos a desglosar los errores más comunes al instalar PrestaShop en Plesk y, lo más importante, cómo solucionarlos paso a paso.

Si estás intentando instalar PrestaShop Plesk fallo y no sabes por dónde empezar, este artículo es para ti. Vamos a cubrir desde problemas de permisos hasta conflictos con extensiones de PHP, todo explicado de forma clara y sin tecnicismos innecesarios.

1. Error de versión de PHP incompatible

Uno de los errores PrestaShop Plesk más frecuentes es que la versión de PHP que tiene tu servidor no es compatible con la versión de PrestaShop que estás instalando. PrestaShop 1.7 y 8.x requieren PHP 7.1 o superior (idealmente 7.4 u 8.0), mientras que versiones antiguas como 1.6 necesitan PHP 5.6.

¿Cómo saber qué versión de PHP tienes en Plesk?

1. Inicia sesión en tu panel de Plesk.
2. Ve a Herramientas y configuraciones > Configuración de PHP (en la sección de "Servidor").
3. Aquí verás la versión global de PHP. También puedes cambiarla por dominio.

Solución para PrestaShop PHP version Plesk

• Cambia la versión de PHP para tu dominio:
  En Plesk, entra en Sitios web y dominios, selecciona tu dominio y haz clic en Configuración de PHP. Allí elige una versión compatible (por ejemplo, 7.4 o 8.0).
• Verifica los requisitos de PrestaShop:
  Antes de instalar, consulta la documentación oficial de PrestaShop para saber qué versión de PHP necesita. Si tienes un hosting compartido, contacta con tu proveedor para que actualicen PHP.

[TIP] Si usas Syspanel (antes HestiaCP), el acceso es por el puerto 2106. Allí también puedes cambiar la versión de PHP desde el panel de administración de tu dominio.

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

Otro clásico PrestaShop base datos Plesk error es que durante la instalación te aparezca un mensaje como "No se puede conectar a la base de datos" o "Error de conexión MySQL". Esto suele deberse a credenciales incorrectas o a que la base de datos no se ha creado correctamente.

Pasos para crear una base de datos en Plesk

1. Ve a Sitios web y dominios > Bases de datos (en la sección de tu dominio).
2. Haz clic en Añadir base de datos.
3. Elige un nombre (por ejemplo, prestashop_db), selecciona el tipo de base de datos (MySQL) y crea un usuario con contraseña.
4. Importante: Asigna todos los privilegios a ese usuario (selecciona "Todos" en los permisos).

Solución al error de base de datos

• Revisa las credenciales: Durante la instalación de PrestaShop, asegúrate de escribir exactamente el nombre de la base de datos, el usuario y la contraseña que creaste en Plesk.
• Verifica el servidor de base de datos: Normalmente es localhost, pero si usas un servidor remoto, puede ser una IP o un nombre de host. En Plesk, suele ser localhost.
• Comprueba los prefijos de tabla: Si estás reinstalando, asegúrate de usar un prefijo diferente (por ejemplo, ps_ en lugar de prestashop_) para evitar conflictos con instalaciones anteriores.

[WARNING] Si ves el error "Tabla no existe" o "Base de datos no encontrada", significa que la base de datos no se ha creado correctamente. Vuelve a crearla desde Plesk y asegúrate de que el usuario tenga todos los permisos.

3. Problemas de permisos en archivos y carpetas

PrestaShop necesita permisos de escritura en ciertas carpetas para poder instalar módulos, temas o subir imágenes. Si ves errores como "No se puede escribir en la carpeta /cache" o "Error de permisos", es un error PrestaShop Plesk muy común.

¿Cómo solucionar los permisos en Plesk?

Plesk suele gestionar los permisos automáticamente, pero a veces falla. Sigue estos pasos:

1. Conéctate por FTP a tu servidor (puedes usar el cliente FTP integrado en Plesk o FileZilla).
2. Navega hasta la carpeta raíz de tu tienda (normalmente httpdocs o public_html).
3. Cambia los permisos de las siguientes carpetas a 755 (o 777 si es necesario, pero no es recomendable por seguridad):
   • /cache
   • /log
   • /img
   • /mails
   • /modules
   • /themes
   • /translations
   • /upload
   • /download
4. Para archivos, usa permisos 644.

[INFO] Si usas Syspanel (HestiaCP, puerto 2106), los permisos se gestionan desde el administrador de archivos del panel. Busca la opción "Permisos" o "Chmod".

Solución avanzada: Propietario del archivo

En Plesk, a veces el problema es que los archivos pertenecen al usuario equivocado. Para solucionarlo:

1. Ve a Sitios web y dominios > Administrador de archivos.
2. Selecciona todos los archivos de PrestaShop.
3. Haz clic en Cambiar propietario y asegúrate de que sea el usuario del dominio (normalmente psacln o el nombre del cliente).

4. Error de memoria PHP (memory_limit)

Otro error PrestaShop Plesk muy habitual es que durante la instalación o al intentar acceder al panel de administración, aparezca un mensaje de error como "Fatal error: Allowed memory size of X bytes exhausted". Esto significa que el límite de memoria de PHP es demasiado bajo.

¿Cómo aumentar el memory_limit en Plesk?

1. Ve a Sitios web y dominios > Configuración de PHP (para tu dominio).
2. Busca la opción memory_limit.
3. Cambia el valor a 256M o 512M (recomendado para PrestaShop).
4. Guarda los cambios.

[TIP] También puedes aumentar otros valores como max_execution_time a 300 segundos y upload_max_filesize a 64M para evitar problemas al subir productos o temas.

5. Error de extensiones de PHP faltantes

PrestaShop requiere varias extensiones de PHP para funcionar correctamente. Si durante la instalación ves errores como "La extensión GD no está instalada" o "Falta la extensión cURL", es un error PrestaShop Plesk que se soluciona fácilmente.

Extensiones necesarias para PrestaShop

• GD (para imágenes)
• cURL (para conexiones externas)
• JSON
• mbstring
• OpenSSL
• PDO_MySQL
• Zip (para subir módulos)

Cómo activar extensiones en Plesk

1. Ve a Sitios web y dominios > Configuración de PHP (para tu dominio).
2. Busca la lista de extensiones (puede aparecer como "Extensiones" o "Módulos PHP").
3. Asegúrate de que todas las necesarias estén marcadas como "Activado".
4. Si no aparecen, contacta con tu proveedor de hosting para que las instale a nivel de servidor.

[WARNING] Si usas Syspanel (HestiaCP, puerto 2106), las extensiones se gestionan desde la configuración de PHP del plan de hosting. Busca "PHP Extensions" y activa las que necesites.

6. Error de URL amigables (mod_rewrite)

Después de instalar PrestaShop, puede que las URLs amigables no funcionen, dando errores 404 o páginas en blanco. Esto se debe a que el módulo mod_rewrite de Apache no está activado o el archivo .htaccess no se genera correctamente.

Solución para mod_rewrite en Plesk

1. Ve a Sitios web y dominios > Configuración de Apache (o Configuración de hosting).
2. Asegúrate de que la opción mod_rewrite esté activada.
3. Si no ves la opción, contacta con tu hosting para que la activen.

Generar el archivo .htaccess manualmente

Si ya tienes PrestaShop instalado, puedes regenerar el .htaccess desde el panel de administración:

1. Ve a Parámetros de la tienda > Tráfico y SEO > URLs amigables.
2. Activa la opción "URLs amigables" y guarda.
3. Si no funciona, desactívala y vuelve a activarla.

[TIP] Si el error persiste, elimina el archivo .htaccess de la raíz de tu tienda y luego vuelve a generarlo desde el panel de administración.

7. Error de instalación: "No se puede escribir en el archivo de configuración"

Durante la instalación, PrestaShop intenta crear el archivo settings.inc.php (en versiones antiguas) o app/config/parameters.php. Si ve el error "No se puede escribir en el archivo de configuración", es un problema de permisos.

Solución paso a paso

1. Conéctate por FTP a tu servidor.
2. Busca la carpeta config (o app/config en PrestaShop 1.7+).
3. Cambia los permisos de la carpeta a 755 y de los archivos dentro a 644.
4. Vuelve a ejecutar la instalación.

[WARNING] Si usas Syspanel (HestiaCP, puerto 2106), recuerda que los permisos se cambian desde el administrador de archivos. No olvides que el propietario debe ser el usuario del dominio.

8. Error de SSL y HTTPS

Si tu tienda tiene SSL (https), pero PrestaShop no se instala correctamente o da errores de contenido mixto, es otro error PrestaShop Plesk común.

Cómo configurar SSL en Plesk

1. Ve a Sitios web y dominios > Certificados SSL/TLS.
2. Asegúrate de que tu dominio tenga un certificado válido (puedes usar Let's Encrypt).
3. En la instalación de PrestaShop, usa la URL con https:// (por ejemplo, https://tutienda.com).

Forzar HTTPS en PrestaShop

Después de instalar, ve al panel de administración:

1. Parámetros de la tienda > General.
2. Activa la opción "Activar SSL" y "Activar SSL en todas las páginas".
3. Guarda y limpia la caché.

9. Error de tiempo de ejecución (max_execution_time)

Si la instalación se queda colgada o da un error de "Tiempo de ejecución excedido", es porque el límite de tiempo de PHP es muy bajo.

Solución en Plesk

1. Ve a Configuración de PHP de tu dominio.
2. Busca max_execution_time y cámbialo a 300 (5 minutos) o más.
3. Guarda los cambios y vuelve a intentar la instalación.

[INFO] Si el error persiste, prueba a instalar PrestaShop manualmente (subiendo los archivos por FTP) en lugar de usar el instalador web.

10. Error de compatibilidad con versiones de PrestaShop

A veces, el error no es técnico, sino de compatibilidad. Por ejemplo, intentar instalar PrestaShop 1.6 en un servidor con PHP 7.4 dará errores graves.

¿Qué versión de PrestaShop instalar?

• PrestaShop 1.6.x: Necesita PHP 5.6 (ya no recomendado por seguridad).
• PrestaShop 1.7.x: Necesita PHP 7.1 a 7.4.
• PrestaShop 8.x: Necesita PHP 7.4 o 8.0.

[WARNING] Si tu hosting solo tiene PHP 8.1 o superior, instala PrestaShop 8.x. Las versiones antiguas no son compatibles.

Preguntas frecuentes (FAQ)

¿Por qué me sale "Error 500" al instalar PrestaShop en Plesk?

Un error 500 suele deberse a un problema de permisos o a una versión de PHP incorrecta. Revisa los pasos 1, 3 y 4 de esta guía.

¿Cómo sé si mi hosting es compatible con PrestaShop?

Plesk es compatible, pero debes asegurarte de que tengas PHP 7.4 o superior, MySQL 5.6+ y las extensiones necesarias (GD, cURL, etc.).

¿Puedo instalar PrestaShop en Syspanel (HestiaCP)?

Sí, pero recuerda que el puerto de acceso es el 2106. Los pasos son similares, aunque la interfaz cambia. Busca las opciones de PHP y bases de datos en el panel.

¿Qué hago si la instalación se queda en "Cargando..."?

Aumenta el max_execution_time a 300 segundos y el memory_limit a 256M. Si sigue, prueba a instalar desde la línea de comandos (si tienes acceso SSH).

¿Es necesario tener SSL para instalar PrestaShop?

No es obligatorio, pero sí muy recomendable. Si no tienes SSL, usa http:// en la instalación.

Conclusión

Los errores PrestaShop Plesk son frustrantes, pero casi siempre tienen solución. La clave está en revisar la versión de PHP, los permisos de archivos y la configuración de la base de datos. Con esta guía, esperamos que puedas instalar PrestaShop Plesk fallo sin problemas.

Recuerda que si usas Syspanel (HestiaCP, puerto 2106), los principios son los mismos, solo cambia la interfaz. Y si te quedas atascado, no dudes en contactar con tu proveedor de hosting: ellos pueden ayudarte a ajustar la configuración del servidor.

¡Buena suerte con tu tienda online!