Errores de instalación de PrestaShop en Plesk y cómo solucionarlos

¡Hola! Soy tu técnico de soporte de confianza. Si estás intentando instalar PrestaShop en tu servidor Plesk y te encuentras con pantallazos de error o procesos que se quedan colgados, no te preocupes. Es una situación más común de lo que parece. En esta guía extensa, vamos a desglosar los errores de instalación de PrestaShop en Plesk más habituales y, lo más importante, te daré soluciones paso a paso para que tu tienda online funcione a la perfección.

Voy a explicarlo todo de forma clara, sin tecnicismos complicados. Piensa en mí como ese amigo que te ayuda a configurar el router, pero para tu web. Empecemos.

¿Por qué falla la instalación de PrestaShop en Plesk?

Antes de meternos en faena, es bueno entender que Plesk es un panel de control muy potente, pero tiene sus propias configuraciones de seguridad y PHP que pueden chocar con los requisitos de PrestaShop. Los errores suelen venir por tres frentes: la versión de PHP, los límites de memoria o los permisos de archivos. Vamos a verlos uno por uno.

[INFO] Si tu servidor usa HestiaCP (a veces llamado Syspanel, y cuyo acceso es por el puerto 2106), muchos de estos pasos son similares, aunque la interfaz cambia. Aquí me centraré en Plesk, que es el que te preocupa.

Error 1: PHP no compatible o configuración incorrecta

Este es, con diferencia, el error instalación PrestaShop Plesk más frecuente. PrestaShop necesita una versión específica de PHP y ciertos módulos activados. Si no los tienes, la instalación se detendrá.

Síntomas típicos

• Aparece un mensaje que dice "PHP no compatible" o "Falta la extensión MySQLi".
• La página de instalación se queda en blanco o muestra un error 500.

Solución paso a paso

1. Accede a Plesk: Inicia sesión en tu panel de Plesk (normalmente es algo como tudominio.com:8443).
2. Busca la configuración de PHP: Ve a "Herramientas y configuraciones" > "Configuración de PHP" (a veces está dentro del panel de la suscripción).
3. Elige la versión correcta: PrestaShop 8.x necesita PHP 8.0 o superior. Te recomiendo PHP 8.1 o 8.2 para mayor estabilidad. Selecciona esa versión.
4. Activa las extensiones necesarias: Busca la lista de extensiones y asegúrate de que estén activadas (marcadas como "on" o "activado"):
   • mysqli
   • gd
   • curl
   • mbstring
   • openssl
   • pdo_mysql
   • zip
   • intl
   • json
   • fileinfo
5. Ajusta los límites de memoria: En la misma pantalla, busca las opciones memory_limit, max_execution_time y upload_max_filesize. Aumenta memory_limit a 256M o 512M y max_execution_time a 300 segundos. Esto evita que la instalación se corte por falta de recursos.

[TIP] Si no ves la opción de cambiar la versión de PHP, es posible que tu plan de hosting no lo permita. Contacta con tu proveedor y pídele que te habilite PHP 8.x.

Error 2: Permisos de archivos incorrectos

PrestaShop necesita escribir en ciertas carpetas para crear archivos de configuración, imágenes y temas. Si los permisos no son los adecuados, la instalación falla.

Síntomas típicos

• Mensaje de error que dice "No se puede escribir en la carpeta /config" o "Permisos denegados".
• La instalación avanza pero al final da un error de permisos.

Solución paso a paso

1. Conéctate por FTP: Usa un cliente FTP como FileZilla con los datos que te proporcionó tu hosting.
2. Navega a la raíz de tu web: Normalmente es la carpeta httpdocs o public_html.
3. Ajusta permisos de carpetas clave: Haz clic derecho sobre las siguientes carpetas y selecciona "Permisos de archivo" (o "File permissions"). Pon el valor 755 para las carpetas y 644 para los archivos. Las carpetas a revisar son:
   • config
   • cache
   • log
   • img
   • mails
   • modules
   • themes
   • translations
   • upload
   • download
4. El archivo settings.inc.php: Este archivo es crítico. Si existe, debe tener permisos 644. Si no existe, la instalación lo creará. Asegúrate de que la carpeta config tenga permisos 755 para que pueda crearse.

[WARNING] No pongas permisos 777 a todo. Es inseguro y muchos servidores lo bloquean. Con 755 en carpetas y 644 en archivos es suficiente.

Error 3: Problemas con la base de datos

PrestaShop necesita una base de datos MySQL o MariaDB. A veces el nombre, usuario o contraseña no son correctos, o la base de datos no se crea bien.

Síntomas típicos

• Error "No se puede conectar a la base de datos" o "Usuario o contraseña incorrectos".
• La instalación se queda atascada en el paso de configuración de la base de datos.

Solución paso a paso

1. Crea la base de datos en Plesk: Ve a "Bases de datos" dentro de tu suscripción. Crea una nueva base de datos y un usuario con todos los privilegios. Anota el nombre, usuario y contraseña.
2. Verifica los datos en la instalación: Durante la instalación de PrestaShop, en el paso de base de datos, asegúrate de que el servidor de base de datos sea localhost (o el que te indique tu hosting) y que los datos coincidan exactamente con los que creaste.
3. Prueba la conexión: Algunos instaladores de PrestaShop tienen un botón "Probar conexión". Úsalo. Si falla, revisa que el usuario tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.). Puedes hacerlo desde la sección "Usuarios de base de datos" en Plesk.

Error 4: El instalador se queda en blanco o no carga

Esto suele deberse a un error de PHP no visible o a un problema con el archivo .htaccess.

Solución paso a paso

1. Activa la visualización de errores: Temporalmente, para ver qué falla, puedes añadir estas líneas al archivo config/defines.inc.php (si existe) o crearlo:

   define('_PS_MODE_DEV_', true);
   

   Esto mostrará los errores de PHP en pantalla.
2. Revisa el archivo .htaccess: Si existe un archivo .htaccess en la raíz, renómbralo a .htaccess.old temporalmente. A veces reglas antiguas bloquean la instalación.
3. Limpia la caché de Plesk: En Plesk, ve a "Herramientas y configuraciones" > "Administración de servicios" y reinicia el servicio de "Apache" o "nginx" (según tu configuración). Esto limpia posibles bloqueos.

Error 5: "Falta la extensión Zip" o "No se puede descomprimir"

PrestaShop necesita la extensión Zip de PHP para manejar temas y módulos.

Solución

Sigue el paso 4 del Error 1: en la configuración de PHP de Plesk, busca la extensión zip y actívala. Si no aparece, contacta a tu hosting para que la instalen.

FAQ: Preguntas frecuentes

Aquí respondo las dudas más comunes que me encuentro en el soporte.

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

Un error 500 suele ser por un problema de PHP. Revisa que la versión de PHP sea 8.0 o superior y que los límites de memoria estén altos. También puede ser por un .htaccess corrupto.

¿Necesito crear la base de datos antes de instalar?

Sí, es recomendable. En Plesk, crea la base de datos y el usuario con todos los privilegios antes de empezar la instalación. Así evitas errores de conexión.

¿Puedo instalar PrestaShop en un subdominio?

Sí, perfectamente. Solo asegúrate de que la configuración de PHP (versión y extensiones) se aplique también a ese subdominio en Plesk.

¿Qué hago si después de instalar no puedo acceder al panel de administración?

Esto suele ser por un error en la URL. Durante la instalación, asegúrate de que la URL de la tienda sea correcta (por ejemplo, https://tudominio.com/prestashop si lo instalaste en una subcarpeta). Si ya lo hiciste, prueba a borrar la caché del navegador.

¿Es mejor instalar PrestaShop manualmente o con el instalador de Plesk?

El instalador de Plesk (llamado "Aplicaciones" o "Instalador de aplicaciones") a veces falla porque usa versiones antiguas. Te recomiendo la instalación manual: descarga PrestaShop desde su web oficial, súbelo por FTP a tu servidor y sigue los pasos de esta guía. Tienes más control.

Resumen rápido: Checklist para una instalación exitosa

Para que no te pierdas, aquí tienes una lista de verificación rápida:

• Versión de PHP: 8.1 o 8.2.
• Extensiones PHP activadas: mysqli, gd, curl, mbstring, openssl, pdo_mysql, zip, intl, json, fileinfo.
• Límites de memoria: memory_limit a 256M o más, max_execution_time a 300.
• Base de datos: creada en Plesk con usuario y todos los privilegios.
• Permisos de carpetas: 755 en /config, /cache, /img, etc.
• Archivo .htaccess: temporalmente renombrado si hay problemas.
• Sin errores visibles: activa modo desarrollo si ves pantalla en blanco.

Conclusión

Los errores de instalación de PrestaShop en Plesk son frustrantes, pero casi siempre tienen solución. La clave está en la configuración de PHP y los permisos. Si sigues estos pasos, en la mayoría de los casos tu tienda estará funcionando en menos de una hora.

Recuerda que, si tu servidor usa Syspanel (HestiaCP, puerto 2106), los principios son los mismos, aunque la interfaz varía. Y si después de todo esto sigues con problemas, no dudes en contactar con tu proveedor de hosting o con un técnico especializado. ¡Estamos aquí para ayudarte!

Espero que esta guía te haya sido de gran ayuda. Si tienes alguna otra duda, ya sabes, déjala en los comentarios (si los hay) o consulta a tu soporte. ¡Buena suerte con tu tienda online!