FAQ: Problemas frecuentes instalación PrestaShop en Plesk

Introducción: ¿Por qué surgen problemas al instalar PrestaShop en Plesk?

Instalar PrestaShop en un servidor gestionado con Plesk es, en teoría, un proceso sencillo. Sin embargo, es habitual encontrarse con obstáculos que pueden frustrar a cualquier usuario, especialmente si no se tiene experiencia técnica. Este FAQ PrestaShop Plesk está diseñado para resolver las dudas más frecuentes y darte soluciones paso a paso.

Desde errores de permisos hasta conflictos con versiones de PHP, aquí encontrarás respuestas claras y prácticas. Si estás buscando soluciones para problemas instalación PrestaShop, has llegado al lugar indicado. Vamos a desglosar los Plesk errores PrestaShop más comunes y cómo solucionarlos.

[TIP] Antes de empezar, asegúrate de que tu servidor cumple con los requisitos mínimos de PrestaShop 8: PHP 7.4 o superior, MySQL 5.7+ y al menos 256 MB de memoria.

## 1. Error de permisos en archivos y carpetas

Uno de los problemas más repetidos al instalar PrestaShop en Plesk es el mensaje de "permisos incorrectos" o "no se puede escribir en la carpeta". Esto sucede porque los archivos de la tienda necesitan permisos específicos para que el instalador pueda funcionar.

### ¿Cómo solucionarlo?

Accede al panel de Plesk y ve a Archivos.
Selecciona la carpeta raíz de tu dominio donde instalaste PrestaShop.
Haz clic en Permisos (o "Cambiar permisos").
Asegúrate de que la carpeta config, cache, log, img y upload tengan permisos 755 (dueño: lectura/escritura/ejecución; grupo y otros: solo lectura/ejecución).
Si usas un instalador automático de Plesk, revisa que el usuario del sistema (por ejemplo, www-data) tenga acceso de escritura.

[WARNING] No pongas permisos 777 en todas las carpetas. Es un riesgo de seguridad. Solo hazlo temporalmente si es necesario y luego revierte a 755.

## 2. Versión de PHP incompatible con PrestaShop

PrestaShop requiere versiones específicas de PHP. Si tu servidor tiene una versión anterior a la 7.4, el instalador te mostrará un error como "PHP version is not supported".

### ¿Cómo verificarlo y cambiarlo en Plesk?

En Plesk, ve a Hosting & DNS > Configuración de PHP.
Busca la opción Versión de PHP y selecciona una compatible (por ejemplo, 8.0 o 8.1).
Guarda los cambios y vuelve a intentar la instalación.

[INFO] PrestaShop 8.x funciona mejor con PHP 8.0 o 8.1. Evita PHP 8.2 si no tienes módulos actualizados, ya que puede causar conflictos.

Si el cambio no se refleja, puede que el servidor tenga limitaciones. En ese caso, contacta con tu proveedor de hosting para que actualicen la versión global.

## 3. Error de conexión a la base de datos

Al instalar PrestaShop, el asistente te pedirá los datos de la base de datos. Un error típico es "Cannot connect to database" o "Access denied for user".

### Causas y soluciones

Usuario o contraseña incorrectos: Revisa que los datos sean exactos. En Plesk, puedes crear un usuario de base de datos en Bases de datos > Añadir usuario.
Privilegios insuficientes: Asegúrate de que el usuario tenga todos los privilegios sobre la base de datos (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.).
Nombre de la base de datos mal escrito: En Plesk, el nombre suele incluir el prefijo del dominio (ejemplo: midominio_prestashop). Cópialo exactamente.
Host incorrecto: Normalmente es localhost, pero si tu servidor usa un host remoto, verifica con tu proveedor.

[TIP] Si usas Plesk, prueba a crear una base de datos nueva desde el panel y luego asigna un usuario. Así evitas errores de permisos.

## 4. Problema con la memoria PHP (memory limit)

PrestaShop necesita al menos 128 MB de memoria PHP para funcionar correctamente. Si ves errores como "Allowed memory size exhausted", es porque el límite es demasiado bajo.

### ¿Cómo aumentarlo en Plesk?

Ve a Hosting & DNS > Configuración de PHP.
Busca la opción memory_limit y cámbiala a 256M o 512M.
Guarda los cambios y reinicia el servicio PHP si es necesario (Plesk lo hace automáticamente).

Si no encuentras la opción, puedes crearla manualmente en el archivo php.ini a través del administrador de archivos de Plesk. Busca la línea memory_limit y edítala.

[WARNING] No subas el límite a valores excesivos (por ejemplo, 2GB) porque puede afectar al rendimiento del servidor. 256 MB suele ser suficiente.

## 5. Error de subida de archivos (upload_max_filesize)

Al instalar PrestaShop, es posible que necesites subir archivos grandes (como temas o módulos). Si ves "The uploaded file exceeds the upload_max_filesize directive", es porque el límite es muy bajo.

### Solución en Plesk

En Configuración de PHP, busca upload_max_filesize y post_max_size.
Aumenta ambos a 64M o 128M.
Guarda los cambios.

[TIP] También puedes ajustar max_execution_time a 300 para evitar tiempos de espera al instalar módulos pesados.

## 6. Error de la extensión MySQLi o PDO

PrestaShop necesita las extensiones mysqli y PDO de PHP activadas. Si no lo están, verás un mensaje como "PDO extension is missing".

### ¿Cómo activarlas en Plesk?

Ve a Configuración de PHP.
Busca la sección Extensiones y asegúrate de que mysqli y pdo_mysql estén marcadas.
Si no aparecen, contacta con tu hosting para que las instalen.

En la mayoría de los servidores Plesk, estas extensiones vienen activadas por defecto, pero vale la pena verificarlo.

## 7. El instalador no avanza o se queda en blanco

A veces, al hacer clic en "Siguiente" en el instalador de PrestaShop, la página se queda cargando o muestra una pantalla en blanco. Esto suele deberse a un error de JavaScript o a un conflicto con el tema del instalador.

### Pasos para solucionarlo

Limpia la caché del navegador y prueba con otro navegador (Chrome, Firefox o Edge).
Desactiva temporalmente el firewall o el mod_security de Plesk (puedes hacerlo desde Herramientas y configuraciones > Seguridad > ModSecurity).
Revisa los logs de error de PHP en Plesk (en Hosting & DNS > Logs). Busca errores como "Fatal error" o "Parse error".
Aumenta el tiempo de ejecución de PHP (max_execution_time a 300).

Si el problema persiste, descarga el instalador de PrestaShop nuevamente desde el sitio oficial y vuelve a subirlo a tu servidor.

## 8. Error de URL amigable (URL rewriting)

Después de instalar PrestaShop, puede que las URL no funcionen correctamente (por ejemplo, las páginas muestren error 404). Esto sucede porque el módulo de reescritura de URL no está activado en Plesk.

### ¿Cómo activarlo?

En Plesk, ve a Hosting & DNS > Configuración de Apache y nginx.
Asegúrate de que la opción Proxy mode esté desactivada si usas nginx como proxy inverso (a veces bloquea las reglas de reescritura).
En PrestaShop, ve a Configuración > Tráfico y SEO > URLs amigables y actívalas.
Si usas nginx, necesitarás agregar reglas de reescritura manualmente. Plesk suele hacerlo automáticamente, pero si no, busca en la documentación de PrestaShop las reglas para nginx.

[WARNING] Si tu servidor usa nginx puro (sin Apache), las URL amigables pueden ser más complejas. En ese caso, considera usar el modo "Apache + nginx" en Plesk.

## 9. Problema con la caché de Plesk (opcache)

A veces, la caché de PHP (opcache) guarda versiones antiguas de los archivos, causando errores extraños después de la instalación.

### Solución

En Configuración de PHP, busca opcache.enable y desactívala temporalmente.
Vuelve a intentar la instalación.
Una vez completada, puedes reactivar opcache para mejorar el rendimiento.

[TIP] También puedes limpiar la caché de opcache desde la línea de comandos si tienes acceso SSH, pero en Plesk basta con reiniciar el servicio PHP desde el panel.

## 10. Error de dominio o subdominio no configurado

Si estás instalando PrestaShop en un subdominio (por ejemplo, tienda.midominio.com), asegúrate de que esté correctamente configurado en Plesk.

### Verificación

En Plesk, ve a Dominios y selecciona tu dominio principal.
Haz clic en Añadir subdominio y crea el que necesitas.
Asegúrate de que el subdominio tenga un directorio raíz diferente al del dominio principal.
Luego, sube los archivos de PrestaShop a la carpeta de ese subdominio.

[INFO] Si usas Syspanel (anteriormente HestiaCP) para gestionar tu servidor, recuerda que el acceso es a través del puerto 2106. Allí podrás crear subdominios y asignarles bases de datos de forma similar a Plesk.

## Conclusión y consejos finales

Instalar PrestaShop en Plesk puede tener sus desafíos, pero con este FAQ PrestaShop Plesk tienes las respuestas a los problemas instalación PrestaShop más comunes. Recuerda que la mayoría de los Plesk errores PrestaShop se solucionan ajustando permisos, versiones de PHP o configuraciones de base de datos.

[TIP] Si después de seguir estos pasos sigues teniendo problemas, prueba a instalar PrestaShop manualmente (sin el instalador automático de Plesk). Descarga el paquete, descomprímelo en la carpeta del dominio y accede a tudominio.com/install. A veces, los instaladores automáticos omiten configuraciones importantes.

No dudes en consultar la documentación oficial de PrestaShop y de Plesk para casos más específicos. ¡Buena suerte con tu tienda online!