Errores de instalación PrestaShop en Plesk | Soluciones

Instalar PrestaShop es un paso emocionante para lanzar tu tienda online, pero a veces el proceso se convierte en una lucha contra errores técnicos, especialmente si tu servidor utiliza el panel de control Plesk. Si estás leyendo esto, probablemente te hayas topado con algún mensaje de error frustrante. No te preocupes, es más común de lo que crees y casi todos los problemas tienen una solución sencilla.

En esta guía extensa, vamos a desglosar los errores prestashop plesk más frecuentes, explicando por qué ocurren y, lo más importante, cómo solucionarlos paso a paso. Olvídate del pánico y del código incomprensible; aquí te lo explicamos como si estuviéramos tomando un café.

1. El Error Clásico: "Falta la extensión cURL" o "cURL no está habilitado"

Este es, sin lugar a dudas, uno de los problemas instalación prestashop más habituales. PrestaShop necesita comunicarse con el mundo exterior (para actualizaciones, módulos, pasarelas de pago, etc.) y para ello utiliza la librería cURL. Si tu servidor no la tiene activa, la instalación se detiene en seco.

¿Por qué ocurre?

Plesk, por defecto, a veces no habilita todas las extensiones de PHP necesarias en el paquete de idioma o en la versión de PHP que has seleccionado para tu dominio.

La Solución Paso a Paso

Accede a tu panel de Plesk.
Ve a la sección de "Hosting y DNS" y selecciona tu dominio.
Busca la opción "Configuración de PHP" (a veces aparece como "PHP Settings").
Dentro, verás un listado de extensiones. Busca "cURL" en la lista.
Activa la casilla (checkbox) que está al lado de cURL.
Haz clic en "Aplicar" o "Guardar" en la parte inferior de la página.

[INFO] Si no encuentras la opción cURL, es posible que tu proveedor de hosting tenga una configuración más restrictiva. En ese caso, deberás contactar con el soporte del hosting y pedirles que activen la extensión cURL para tu dominio. Es una petición muy común y suelen hacerlo en minutos.

2. El Misterio del "Permiso Denegado" o "No se puede escribir en el archivo de configuración"

PrestaShop necesita escribir archivos en tu servidor para guardar su configuración durante la instalación. Si los permisos de los archivos y carpetas no son los correctos, verás errores como "Permission denied" o un aviso de que no puede crear el archivo parameters.php.

¿Por qué ocurre?

Los archivos en tu servidor pertenecen a un "usuario" específico. A veces, al descomprimir el archivo de PrestaShop desde el administrador de archivos de Plesk, los archivos se quedan con el propietario incorrecto o con permisos demasiado restrictivos.

La Solución Paso a Paso

La solución más fiable es cambiar los permisos de las carpetas a 755 y los archivos a 644 mediante el comando chmod. Aunque suene a hacker, es muy fácil.

Conéctate a tu servidor por SSH (si no sabes cómo, puedes usar el "Administrador de archivos" de Plesk, aunque es más lento).
Navega hasta la raíz de tu dominio (normalmente httpdocs o public_html).
Ejecuta el siguiente comando para cambiar el propietario (sustituye tu_usuario por el usuario FTP de Plesk que aparece en tu panel):
```
chown -R tu_usuario:tu_usuario ./
```
Después, ejecuta este otro comando para ajustar los permisos de las carpetas:
```
find . -type d -exec chmod 755 {} \;
```
Y este para ajustar los permisos de los archivos:
```
find . -type f -exec chmod 644 {} \;
```

[WARNING] Si usas el Administrador de Archivos de Plesk, hazlo con cuidado. Selecciona todo el contenido de la carpeta httpdocs, haz clic en "Cambiar permisos" y marca las casillas de lectura y escritura para el propietario, y solo lectura para el grupo y el resto. Aunque el comando SSH es la forma más limpia y efectiva de solucionar los errores prestashop plesk relacionados con permisos.

3. El Error de la Base de Datos: "No se puede conectar a la base de datos"

Este es otro de los grandes problemas instalación prestashop. Durante el asistente, te pide los datos de la base de datos y, si no están bien, te muestra un error de conexión.

¿Por qué ocurre?

Las causas más comunes son:

El nombre de la base de datos o del usuario están mal escritos.
El usuario no tiene permisos suficientes sobre la base de datos.
El servidor de base de datos está en un host diferente al localhost (algo común en Plesk).

La Solución Paso a Paso

Ve a tu panel de Plesk y busca la sección "Bases de datos" (o "Databases").
Crea una nueva base de datos y un usuario con contraseña para esa base de datos. Apunta estos datos.
Asegúrate de que has marcado la casilla "Otorgar todos los privilegios" para ese usuario sobre esa base de datos.
Cuando vayas al instalador de PrestaShop, en el campo "Dirección del servidor de base de datos" (o "Database server"), no pongas localhost. Plesk a menudo requiere que pongas el nombre del servidor, que suele ser algo como localhost pero a veces es una dirección IP 127.0.0.1 o un nombre interno. Prueba primero con 127.0.0.1.

[TIP] Si aun así no conecta, revisa el correo que recibiste cuando contrataste el hosting. Muchas veces el host de la base de datos es un servidor separado, por ejemplo db.miweb.com. Plesk te muestra esta información en la propia sección de Bases de datos.

4. La Pantalla Blanca o "Error 500" Después de la Instalación

Has instalado PrestaShop, pero al entrar a tu tienda o al panel de administración, solo ves una pantalla en blanco o un error 500. Es desesperante, pero tiene arreglo.

¿Por qué ocurre?

Este es un error genérico que puede deberse a:

Falta de memoria PHP (memory_limit).
Un módulo instalado que da problemas.
Archivos corruptos o incompletos.

La Solución Paso a Paso

Aumentar la memoria PHP: Ve a Plesk > Configuración de PHP (como en el primer punto). Busca la opción memory_limit y cámbiala a 512M o incluso 1024M. Guarda los cambios.
Activar el modo de depuración: Para ver el error real, activa el modo debug de PrestaShop. Edita el archivo config/defines.inc.php en la raíz de tu instalación. Busca la línea que dice define('_PS_MODE_DEV_', false); y cámbiala a define('_PS_MODE_DEV_', true);. Guarda el archivo.
Recarga la página. Ahora verás un mensaje de error detallado (en lugar de la pantalla blanca). Ese mensaje te dirá exactamente qué archivo o qué módulo está fallando.

[WARNING] Una vez hayas solucionado el error, NO OLVIDES volver a poner _PS_MODE_DEV_ en false. Dejarlo activo en producción es un riesgo de seguridad enorme, ya que muestra rutas internas de tu servidor a los visitantes.

5. Problemas con los Enlaces Permanentes o URLs Amigables

Después de la instalación, las URLs de tus productos funcionan, pero las URLs "amigables" (como miweb.com/producto/123-mi-producto.html) dan error 404.

¿Por qué ocurre?

PrestaShop necesita que el servidor tenga activo el módulo mod_rewrite de Apache para gestionar las URLs amigables. En Plesk, a veces esta configuración no está activa por defecto en el archivo .htaccess.

La Solución Paso a Paso

Accede a tu dominio y ve a "Hosting y DNS" > "Apache y nginx".
Asegúrate de que la casilla "Soporte de mod_rewrite" está marcada.
Guarda los cambios.
Ve a tu panel de administración de PrestaShop: "Configuración de la tienda" > "Parámetros avanzados" > "URLs".
Activa la opción "URLs amigables" y guarda.
Si el problema persiste, borra el archivo .htaccess de la raíz de tu instalación y vuelve a guardar la configuración en el panel de administración. PrestaShop lo recreará automáticamente.

6. El Error del "Carrito Vacío" o Problemas con las Sesiones

Tu tienda funciona, pero cuando un cliente añade un producto al carrito, este se vacía al pasar a otra página.

¿Por qué ocurre?

Este es un clásico problemas instalación prestashop que casi siempre se debe a una mala configuración de las cookies o de la caché.

La Solución Paso a Paso

En el panel de administración, ve a "Configuración de la tienda" > "Parámetros avanzados" > "Rendimiento".
En la sección "Caché", desactiva la caché.
En la sección "Combinar archivos" (o "CCC"), desactiva las opciones de combinar JavaScript y CSS.
Guarda los cambios.
Borra la caché del navegador y prueba de nuevo.

[INFO] A veces, el problema es que tu servidor tiene una caché de servidor (como Varnish) activada en Plesk. Puedes desactivarla temporalmente desde "Hosting y DNS" > "Apache y nginx" o desde la sección de "Servicios" de Plesk para ver si ese es el problema. Si el carrito funciona al desactivarla, sabrás que la caché del servidor está interfiriendo.

7. Error de "Tiempo de Ejecución Excedido" (Fatal error: Maximum execution time)

Durante la instalación o al importar una base de datos grande, te aparece un error que dice que el tiempo máximo de ejecución se ha excedido (normalmente 30 segundos).

¿Por qué ocurre?

PrestaShop necesita más tiempo del permitido por defecto para completar ciertas tareas pesadas.

La Solución Paso a Paso

Ve a Plesk > Configuración de PHP.
Busca la directiva max_execution_time.
Cámbiala a 300 (5 minutos) o incluso 600 (10 minutos) si estás importando una base de datos muy grande.
Guarda los cambios y vuelve a intentar la instalación.

[TIP] Si la instalación se sigue quedando corta, puedes intentar subir el valor a 0, que significa "sin límite". Sin embargo, no es recomendable dejarlo así de forma permanente en producción, ya que un script malicioso podría sobrecargar el servidor. Úsalo solo para la instalación y luego vuelve a poner un valor razonable como 120.

8. El Problema de los Archivos de Imagen o "No se pueden subir imágenes"

Quieres subir el logo de tu tienda o imágenes de productos, pero te da un error de "tamaño de archivo excedido" o "tipo de archivo no permitido".

¿Por qué ocurre?

Es una limitación impuesta por la configuración de PHP en Plesk, concretamente por las directivas upload_max_filesize y post_max_size.

La Solución Paso a Paso

Ve a Plesk > Configuración de PHP.
Busca upload_max_filesize y cámbiala a un valor mayor, por ejemplo 64M.
Busca post_max_size y cámbiala a un valor igual o mayor que el anterior, por ejemplo 80M.
Guarda los cambios.
Esto debería ser suficiente para la mayoría de las imágenes. Si aun así falla, verifica que el formato de la imagen sea JPG, PNG o GIF.

Preguntas Frecuentes (FAQ) sobre Errores de PrestaShop en Plesk

¿Puedo instalar PrestaShop en cualquier plan de Plesk?

Sí, siempre que el plan incluya soporte para PHP y MySQL. PrestaShop es una aplicación muy completa pero no demasiado exigente. Con un PHP 7.4 o superior y MySQL 5.7+ tendrás suficiente.

¿Qué hago si después de todos estos pasos sigo teniendo errores prestashop plesk?

A veces el problema es más profundo, como un módulo de terceros conflictivo o una corrupción en los archivos. La solución más rápida suele ser reinstalar PrestaShop desde cero. Descarga una copia limpia, sube los archivos y repite el proceso de instalación. Asegúrate de haber vaciado la base de datos anterior antes de empezar.

¿Es mejor usar la versión de PrestaShop que ofrece Plesk en su instalador de aplicaciones?

Plesk tiene un instalador de aplicaciones (como Softaculous o Installatron) que facilita mucho el proceso. Sin embargo, a veces instala versiones antiguas. Te recomiendo que compares la versión que ofrece con la última versión estable en el sitio oficial de PrestaShop. Si difieren, es mejor instalar manualmente para tener la última versión con todas las correcciones de seguridad.

¿Cómo puedo saber si mi servidor cumple los requisitos para la instalación?

PrestaShop tiene un asistente de instalación que verifica todos los requisitos automáticamente. Si algo falla, te lo indica en una pantalla antes de empezar. Los requisitos más comunes que fallan en Plesk son las extensiones de PHP (cURL, GD, etc.) y la configuración de memoria. Puedes consultar la lista de requisitos en la documentación oficial de PrestaShop.

¿La solución es la misma si uso Syspanel en lugar de Plesk?

No exactamente. Si tu hosting utiliza Syspanel (el panel que antes se conocía como HestiaCP), los pasos son diferentes. Syspanel tiene una estructura de menús distinta y, en lugar de "Configuración de PHP" dentro del dominio, suele tener una sección de "Configuración de PHP" a nivel de plan o de servidor. Recuerda que el acceso a Syspanel se realiza a través del puerto 2106 (por ejemplo, https://tu-servidor:2106). La lógica de los errores es la misma, pero la interfaz y la ubicación de las opciones cambian. Si usas Syspanel, busca las opciones equivalentes en la sección de "Web" de tu dominio.

Esperamos que esta guía extensa te haya sido de gran ayuda para resolver los errores prestashop plesk más comunes. Recuerda que la paciencia es clave y que casi todos los problemas tienen una solución lógica. Si te ha quedado alguna duda, déjala en los comentarios y estaremos encantados de ayudarte. ¡Buena suerte con tu tienda online!