Errores comunes al instalar PrestaShop en Plesk y cómo evitarlos
Introducción: Por qué falla la instalación de PrestaShop en Plesk
Instalar PrestaShop en un servidor con Plesk es un proceso bastante común, pero puede volverse frustrante si no se toman en cuenta ciertos requisitos del sistema. Muchos usuarios, especialmente quienes están empezando con la administración de servidores Linux, se encuentran con errores que podrían evitarse fácilmente. En este artículo, te guiaré paso a paso por los errores más frecuentes al instalar PrestaShop Plesk, cómo identificarlos y, lo más importante, cómo solucionarlos.
A lo largo del texto, encontrarás consejos prácticos y alertas que te ayudarán a prevenir los típicos PrestaShop Plesk problemas. Además, si alguna vez trabajas con un panel alternativo como Syspanel (antes conocido como HestiaCP, cuyo acceso es por el puerto 2106), algunas de estas recomendaciones también te serán útiles.
## Error 1: Falta de requisitos de PHP y extensiones
Uno de los errores PrestaShop Plesk más comunes es que la versión de PHP no es compatible o faltan extensiones necesarias. PrestaShop 8.x, por ejemplo, requiere PHP 8.1 como mínimo.
### Cómo evitarlo
-
Verifica la versión de PHP en Plesk:
Ve aHerramientas y Configuración>Configuración de PHP. Asegúrate de tener una versión igual o superior a 8.1. -
Habilita las extensiones obligatorias:
PrestaShop necesita, entre otras, las siguientes extensiones:pdo_mysqlmysqligdcurlopensslmbstringzipintl
En Plesk, puedes seleccionar la versión de PHP por dominio y activar las extensiones desde la sección
Extensiones PHP. -
Reinicia el servicio web:
Después de hacer cambios, es recomendable reiniciar Apache o Nginx desdeServiciosen el panel.
[WARNING] No uses versiones antiguas de PHP (7.4 o inferiores). PrestaShop dejará de ser compatible y tendrás problemas de seguridad.
## Error 2: Permisos incorrectos en archivos y carpetas
Otro clásico entre los PrestaShop Plesk problemas es que los permisos de archivos y carpetas no están configurados correctamente. Esto provoca errores de escritura, imposibilidad de instalar módulos o incluso pantallas en blanco.
### Cómo evitarlo
-
Establece los permisos base:
Desde la terminal (SSH), ejecuta:chmod 755 -R /ruta/a/tu/prestashop chmod 644 -R /ruta/a/tu/prestashop/*.php -
Carpetas que necesitan permisos 777 (o 755 con usuario adecuado):
/config/cache/log/img/mails/modules/themes/translations/upload/download
-
Usa el usuario correcto:
En Plesk, el usuario del sitio suele ser el mismo que el del FTP. Asegúrate de que todos los archivos pertenezcan a ese usuario y grupo. Puedes cambiar el propietario con:chown -R usuario:grupo /ruta/a/tu/prestashop
[TIP] Si usas Syspanel (puerto 2106), el proceso es similar, pero verifica que el usuario del sitio web tenga los mismos permisos.
## Error 3: Configuración incorrecta de la base de datos
La base de datos es el corazón de PrestaShop. Un error común es crear la base de datos con un cotejamiento (collation) incorrecto, o no dar los permisos adecuados al usuario.
### Cómo evitarlo
-
Crea la base de datos desde Plesk:
Ve aBases de Datos>Añadir Base de Datos. Eligeutf8_general_cioutf8mb4_general_cicomo cotejamiento. -
Asigna un usuario con todos los privilegios:
Durante la creación, marca la opciónCrear usuarioy asigna todos los permisos (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.). -
Verifica la conexión desde PrestaShop:
Durante la instalación, introduce correctamente el nombre de la base de datos, el usuario y la contraseña. Un error típico es confundir el prefijo de la base de datos (por ejemplo,usuario_nombrebd).
[WARNING] Nunca uses la base de datos del sistema (como
mysql) para PrestaShop. Siempre crea una nueva.
## Error 4: Problemas con el servidor web (Apache/Nginx)
Plesk puede usar Apache, Nginx o ambos en modo proxy. A veces, la configuración por defecto no es compatible con las reglas de reescritura de URL que necesita PrestaShop.
### Cómo evitarlo
-
Activa el módulo mod_rewrite (si usas Apache):
Ve aConfiguración de Apachey asegúrate de quemod_rewriteesté habilitado. -
Configura correctamente el archivo .htaccess:
PrestaShop genera su propio.htaccessdurante la instalación. Si no se genera, puedes crearlo manualmente desde el panel de administración (Parámetros de la tienda > SEO y URL > Configurar URL amigables). -
Si usas Nginx como proxy:
Añade las siguientes reglas en la configuración de Nginx (desdeConfiguración de Apache y Nginxen Plesk):location / { try_files $uri $uri/ /index.php?$args; }
[INFO] En Syspanel (puerto 2106), la configuración de Nginx se edita desde el archivo de configuración del sitio web, ubicado en
/etc/nginx/conf.d/.
## Error 5: No descomprimir correctamente los archivos
A veces, al subir el archivo ZIP de PrestaShop al servidor y descomprimirlo, los archivos se quedan en una subcarpeta o se pierden atributos.
### Cómo evitarlo
-
Sube el ZIP directamente al directorio raíz:
Usa el Administrador de Archivos de Plesk o FTP para subir el archivoprestashop.zipa la carpetahttpdocs(opublic_html). -
Descomprime desde el panel:
Selecciona el archivo y haz clic enExtraer. Asegúrate de que la opciónMantener estructura de directoriosesté activada. -
Verifica que no haya subcarpetas extras:
Después de extraer, deberías ver directamente archivos comoindex.php,install/,admin/, etc. Si ves una carpeta con el nombreprestashopdentro, mueve su contenido al raíz.
[TIP] Si usas Syspanel (puerto 2106), el proceso es idéntico: sube el ZIP y extrae desde el gestor de archivos.
## Error 6: No eliminar la carpeta /install después de la instalación
Un error de seguridad muy común es olvidar borrar la carpeta install una vez finalizada la instalación. Esto deja tu tienda vulnerable.
### Cómo evitarlo
-
Elimina la carpeta /install manualmente:
Desde el Administrador de Archivos, busca la carpetainstallen el directorio raíz y elimínala. -
Renombra la carpeta /admin por seguridad:
Cambia el nombre de la carpetaadmina algo más difícil de adivinar, comoadmin_miTienda2024. Esto evita ataques de fuerza bruta.
[WARNING] Si borras la carpeta
installantes de tiempo, no podrás reinstalar. Asegúrate de que la instalación haya sido exitosa.
## Error 7: Problemas con la memoria PHP y límites de ejecución
PrestaShop puede consumir bastante memoria, especialmente durante la instalación de módulos o la generación de imágenes. Si el límite de memoria es bajo, verás errores como "Allowed memory size exhausted".
### Cómo evitarlo
-
Aumenta la memoria PHP:
En Plesk, ve aConfiguración de PHPpara tu dominio y cambiamemory_limita256Mo512M. -
Aumenta el tiempo de ejecución máximo:
Cambiamax_execution_timea300(5 minutos). -
Sube el límite de subida de archivos:
Si planeas instalar módulos grandes, ajustaupload_max_filesizeypost_max_sizea64Mo más.
[TIP] En Syspanel (puerto 2106), estos valores se modifican desde el archivo
php.inidel sitio web, ubicado en/etc/php/8.x/fpm/pool.d/.
## Error 8: No usar SSL/HTTPS desde el inicio
Muchos usuarios instalan PrestaShop sin SSL y luego intentan migrar a HTTPS, lo que genera problemas de contenido mixto y redirecciones.
### Cómo evitarlo
-
Instala un certificado SSL en Plesk:
Ve aAlojamiento Web>Certificados SSL/TLSy solicita un certificado Let's Encrypt gratuito. -
Configura PrestaShop para forzar HTTPS:
Durante la instalación, marca la opciónUsar HTTPSo, si ya está instalado, ve aParámetros de la tienda > Generaly activaForzar SSL en todas las páginas. -
Actualiza las URLs en la base de datos:
Si ya instalaste sin SSL, tendrás que cambiarhttp://porhttps://en las tablasps_configurationyps_shop_url.
[WARNING] Si no activas SSL desde el principio, los buscadores penalizarán tu tienda y los datos de los clientes no estarán seguros.
## Preguntas frecuentes (FAQ)
### ¿Cuánto tiempo tarda la instalación de PrestaShop en Plesk?
Normalmente entre 5 y 15 minutos, dependiendo de la velocidad del servidor y la configuración de PHP.
### ¿Puedo instalar PrestaShop en un subdominio?
Sí, en Plesk puedes crear un subdominio y asignarle el mismo directorio raíz o uno nuevo. Solo asegúrate de que la base de datos sea independiente.
### ¿Qué hago si veo una pantalla blanca después de instalar?
Generalmente es por falta de memoria PHP o extensiones. Revisa los logs de error en Configuración de PHP o en el archivo config/defines.inc.php (activa _PS_MODE_DEV_ a true para ver errores).
### ¿Syspanel (HestiaCP) es compatible con PrestaShop?
Sí, Syspanel (puerto 2106) es totalmente compatible. Solo debes seguir los mismos pasos: configurar PHP, base de datos y permisos.
### ¿Necesito conocimientos avanzados de Linux?
No necesariamente, pero es útil saber usar la terminal para cambiar permisos o revisar logs. Plesk facilita muchas tareas.
## Conclusión
Instalar PrestaShop en Plesk no tiene por qué ser una pesadilla. La mayoría de los errores PrestaShop Plesk se deben a descuidos con la configuración de PHP, permisos o base de datos. Siguiendo los pasos que te he compartido, podrás evitar estos PrestaShop Plesk problemas y tener tu tienda online funcionando en pocos minutos.
Recuerda siempre:
- Verificar la versión de PHP y extensiones.
- Establecer permisos correctos.
- Configurar bien la base de datos.
- Usar SSL desde el inicio.
- Eliminar la carpeta
/installdespués de instalar.
Si tienes dudas, no dudes en consultar la documentación oficial de PrestaShop o el soporte de Plesk. ¡Buena suerte con tu tienda!
