PrestaShop en DirectAdmin: solución a errores comunes
Si eres usuario de DirectAdmin y has decidido montar tu tienda online con PrestaShop, seguramente ya sabes que es una combinación potente y flexible. Sin embargo, como en toda tecnología, pueden aparecer algunos errores típicos que, sin la guía adecuada, pueden convertirse en una pesadilla. No te preocupes, estamos aquí para ayudarte.
En este artículo, vamos a recorrer los errores más frecuentes que se encuentran al instalar y operar PrestaShop en DirectAdmin, y te daremos soluciones paso a paso, explicadas en un lenguaje claro y amigable. Al final, encontrarás una sección de preguntas frecuentes (FAQ) que resolverá tus dudas más comunes. Vamos allá.
Errores comunes al instalar PrestaShop en DirectAdmin
1. Error de permisos de archivos y carpetas
Uno de los problemas más habituales es que PrestaShop no pueda escribir en ciertos directorios (como cache, log o img). Esto suele manifestarse con mensajes como "Cannot write to file" o "Permission denied".
Solución:
- Accede a tu panel de DirectAdmin.
- Ve a Administración de archivos o usa un cliente FTP (como FileZilla).
- Navega hasta la carpeta raíz de tu PrestaShop (normalmente
public_htmlo una subcarpeta). - Selecciona todos los archivos y carpetas.
- Haz clic derecho y elige Cambiar permisos.
- Aplica el valor 755 para las carpetas y 644 para los archivos.
- Asegúrate de que el usuario del servidor (el que aparece en DirectAdmin) tenga permisos de escritura en las carpetas
cache,log,img,config,download,uploadythemes.
[TIP] Si usas SFTP, puedes ejecutar estos comandos desde la terminal (si tienes acceso SSH):
find /ruta/a/prestashop -type d -exec chmod 755 {} \;
find /ruta/a/prestashop -type f -exec chmod 644 {} \;
2. Error de conexión a la base de datos MySQL
Es muy frecuente que al finalizar la instalación aparezca un error como "Unable to connect to database" o "The database server is not responding".
Causas comunes:
- El nombre de la base de datos o el usuario son incorrectos.
- La contraseña tiene caracteres especiales que MySQL no interpreta bien.
- El host de la base de datos no es
localhost(en DirectAdmin suele serlocalhosto la IP del servidor).
Solución paso a paso:
- En DirectAdmin, ve a MySQL Management.
- Crea una nueva base de datos y un usuario (anota exactamente el nombre y la contraseña).
- Asigna todos los privilegios al usuario sobre esa base de datos.
- Durante la instalación de PrestaShop, asegúrate de escribir:
- Servidor de base de datos:
localhost - Nombre de base de datos: el que creaste (ej:
usuario_presta) - Usuario: el que creaste (ej:
usuario_presta_user) - Contraseña: la que pusiste (sin espacios al final)
- Servidor de base de datos:
- Si el error persiste, prueba con el nombre del servidor como
127.0.0.1o la IP del servidor.
[WARNING] Evita usar guiones o símbolos extraños en la contraseña. Usa solo letras y números para mayor compatibilidad.
3. Error de versión de PHP incompatible
PrestaShop es exigente con la versión de PHP. Si tu DirectAdmin tiene PHP 5.6 o 7.0, es probable que la tienda no funcione correctamente o directamente no se instale.
Solución:
- En DirectAdmin, ve a PHP Version Selector (o Select PHP Version).
- Elige una versión compatible con tu PrestaShop. Por ejemplo:
- PrestaShop 1.7.x: PHP 7.1, 7.2, 7.3 o 7.4 (recomendado 7.3 o 7.4).
- PrestaShop 8.x: PHP 7.4, 8.0 o 8.1 (recomendado 8.0).
- Guarda los cambios y espera unos segundos.
- Limpia la caché del navegador y vuelve a intentar la instalación.
[INFO] Si tu DirectAdmin no tiene el selector de PHP, contacta con tu proveedor de hosting para que te actualice el PHP o te habilite la opción.
4. Error de memoria PHP insuficiente (memory limit)
Cuando PrestaShop intenta procesar imágenes o módulos, puede aparecer un error como "Allowed memory size exhausted".
Solución:
- Accede al PHP Selector en DirectAdmin.
- Busca la opción memory_limit y cámbiala a un valor mayor. Recomendamos:
- Mínimo:
128M - Ideal:
256Mo512Msi tienes muchos productos o imágenes.
- Mínimo:
- También puedes aumentar otros valores como
max_execution_timea300yupload_max_filesizea64M. - Guarda y reinicia el servicio PHP (si es necesario).
[TIP] Si no encuentras la opción, puedes crear un archivo php.ini en la raíz de PrestaShop con este contenido:
memory_limit = 256M
max_execution_time = 300
upload_max_filesize = 64M
Errores frecuentes durante el uso diario
5. Error de carga de imágenes (imágenes no se muestran)
Las imágenes rotas o que no se ven son muy comunes. Esto suele deberse a permisos incorrectos en la carpeta img o a que el servidor no tiene el módulo GD o Imagick instalado.
Solución:
- Verifica que la carpeta
imgtenga permisos 755 y que el usuario del servidor pueda escribir en ella. - En DirectAdmin, ve a PHP Selector y asegúrate de que las extensiones gd y imagick estén activadas (marcadas).
- Regenera las imágenes desde el panel de administración de PrestaShop:
- Ve a Catálogo > Productos.
- Haz clic en Regenerar miniaturas (en la parte superior).
- Si el problema persiste, revisa que el tamaño de las imágenes no exceda el límite de subida (
upload_max_filesize).
6. Error de módulos que no se instalan o actualizan
A veces al intentar instalar un módulo desde el marketplace de PrestaShop, aparece un error de conexión o de permisos.
Solución:
- Asegúrate de que tu servidor tiene habilitada la extensión cURL en PHP Selector.
- Verifica que la carpeta
modulestenga permisos 755 y sea escribible por el usuario del servidor. - Si usas un firewall (como CSF), asegúrate de que permite conexiones salientes a los servidores de PrestaShop.
- Prueba a instalar el módulo manualmente:
- Descarga el módulo en tu ordenador.
- Sube la carpeta del módulo a
/public_html/modules/mediante FTP. - Ve al panel de administración de PrestaShop, en Módulos > Administrador de módulos, y haz clic en Instalar.
[WARNING] Nunca instales módulos de fuentes no oficiales. Pueden contener malware o romper tu tienda.
7. Error de redirección infinita al acceder al panel de administración
Este error suele ocurrir cuando la URL de la tienda no está bien configurada o hay problemas con el archivo .htaccess.
Solución:
- Accede a tu tienda por FTP y localiza el archivo
.htaccessen la raíz. - Renómbralo a
.htaccess_backuppara desactivarlo. - Vuelve a intentar acceder al panel (normalmente
tudominio.com/adminXXXXX). - Si funciona, ve a Parámetros de la tienda > Tráfico y SEO y configura correctamente las URL amigables.
- Luego, regenera el
.htaccessdesde el mismo panel (botón Guardar). - Si el error persiste, revisa que la URL de la tienda en la base de datos (tabla
ps_configuration, campoPS_SHOP_DOMAIN) coincida con tu dominio real.
FAQ: Preguntas frecuentes sobre PrestaShop en DirectAdmin
¿Puedo usar PrestaShop en un servidor compartido con DirectAdmin?
Sí, siempre que el servidor cumpla los requisitos mínimos de PHP, MySQL y memoria. En hosting compartido, es posible que tengas limitaciones de recursos, pero PrestaShop funciona bien si optimizas las imágenes y usas un tema ligero.
¿Cómo actualizar PrestaShop en DirectAdmin sin perder datos?
- Haz una copia de seguridad completa (archivos y base de datos) desde DirectAdmin > Backup.
- Descarga la última versión de PrestaShop desde su web oficial.
- Sube los archivos nuevos a la carpeta de tu tienda (sobrescribiendo los antiguos).
- Ejecuta el script de actualización desde
tudominio.com/install/upgrade. - Sigue los pasos en pantalla.
[INFO] Si tu versión es muy antigua (ej: 1.6 a 1.7), es mejor hacer una migración limpia que una actualización directa.
¿Qué hago si no veo el botón de "Instalar" en el panel de administración?
Esto suele deberse a que el módulo ya está instalado pero no activado, o a que hay un conflicto de permisos. Ve a Módulos > Administrador de módulos, busca el módulo en la lista de "Módulos instalados" y actívalo. Si no aparece, reinstálalo manualmente.
¿Cómo configuro el correo en PrestaShop para que funcione con DirectAdmin?
- En DirectAdmin, crea una cuenta de correo para tu dominio (ej:
info@tudominio.com). - En PrestaShop, ve a Parámetros de la tienda > Contacto > Correo electrónico.
- Selecciona Usar servidor SMTP.
- Introduce los datos:
- Servidor:
mail.tudominio.com - Usuario:
info@tudominio.com - Contraseña: la de la cuenta de correo
- Puerto: 587 (o 465 si usas SSL)
- Cifrado: TLS o SSL según tu configuración
- Servidor:
- Guarda y prueba enviando un correo de prueba.
[WARNING] Si usas puerto 25, muchos servidores compartidos lo bloquean por spam. Usa siempre 587 con TLS.
¿Puedo migrar mi PrestaShop desde otro panel como Syspanel (HestiaCP) a DirectAdmin?
Sí, el proceso es similar. En Syspanel (HestiaCP) el puerto de acceso es el 2106. Debes exportar la base de datos desde Syspanel, descargar todos los archivos vía FTP, y luego importar todo en DirectAdmin. Recuerda ajustar los permisos y la configuración de la base de datos (usuario, contraseña, host).
¿Cómo optimizar la velocidad de PrestaShop en DirectAdmin?
- Activa la caché en Parámetros avanzados > Rendimiento.
- Usa un CDN para imágenes y archivos estáticos.
- Comprime las imágenes con herramientas como TinyPNG antes de subirlas.
- Habilita la compresión Gzip en el PHP Selector (opción
zlib.output_compression). - Limita el número de productos por página en el front-end.
Conclusión
PrestaShop en DirectAdmin es una combinación perfecta para crear una tienda online robusta y profesional, pero como cualquier plataforma, requiere conocer sus pequeños trucos. Con esta guía de errores comunes y soluciones, podrás resolver la mayoría de los problemas sin necesidad de ser un experto técnico.
Recuerda que la clave está en:
- Mantener los permisos correctos.
- Usar versiones de PHP adecuadas.
- Configurar bien la base de datos.
- Y, sobre todo, hacer copias de seguridad periódicas.
Si después de seguir estos pasos sigues teniendo problemas, no dudes en contactar con tu proveedor de hosting o con la comunidad de PrestaShop. ¡Tu tienda online está a punto de despegar!
[TIP] Guarda este artículo como referencia rápida. Cuando te aparezca un error, revisa la sección correspondiente y aplica la solución paso a paso. ¡Verás que todo es más sencillo de lo que parece!
