DirectAdmin: Solución de errores comunes al instalar PrestaShop

¿Te has decidido a montar tu tienda online con PrestaShop y tu hosting usa DirectAdmin? Es una combinación potente, pero a veces pueden surgir pequeños contratiempos. No te preocupes, es más común de lo que crees. En esta guía extensa y muy práctica, vamos a desgranar los errores PrestaShop DirectAdmin más frecuentes y te daremos la solución errores PrestaShop paso a paso, como si estuviera un técnico a tu lado.

Vamos a convertir esa frustración en una instalación exitosa. Prepárate para tener tu tienda funcionando en un abrir y cerrar de ojos. Hablaremos de todo: desde problemas con los requisitos de PHP hasta conflictos con los permisos de archivos, pasando por esos molestos errores en la base de datos.

Preparando el Terreno: Requisitos Previos en DirectAdmin

Antes de lanzarnos a solucionar errores, asegurémonos de que la base es sólida. Instalar PrestaShop DirectAdmin es sencillo si el servidor está configurado correctamente. Muchos de los problemas que verás después nacen aquí.

Verifica la Versión de PHP

PrestaShop es exigente con la versión de PHP. Si usas una obsoleta, la instalación fallará o te dará errores extraños.

1. Accede a tu panel de DirectAdmin.
2. Busca la sección "Administrador de PHP" o "Select PHP Version".
3. Asegúrate de tener seleccionada una versión PHP 8.0 o superior (PHP 8.1 o 8.2 son las más recomendadas hoy en día).
4. Marca las extensiones necesarias. Las imprescindibles para PrestaShop son:
   • curl
   • dom
   • fileinfo
   • gd
   • intl
   • mbstring
   • mysqli
   • openssl
   • pdo_mysql
   • zip
   • json (suele venir por defecto)
   • xml

[WARNING] Si no ves todas estas opciones, contacta con tu proveedor de hosting. Algunas extensiones pueden necesitar activación a nivel de servidor. No saltarse este paso es la clave para evitar PrestaShop problemas más adelante.

Configura el Límite de Memoria (Memory Limit)

Un error muy común durante la instalación de PrestaShop es el famoso "white screen of death" o errores de memoria insuficiente. La solución es sencilla.

1. En el mismo "Select PHP Version", busca la opción "Switch to PHP Settings" (o similar).
2. Localiza el parámetro memory_limit.
3. Cámbialo a un valor mínimo de 256M (megabytes). Para tiendas con muchos productos o módulos, 512M es una opción más segura.
4. Guarda los cambios.

Crea una Base de Datos Vacía

PrestaShop necesita una base de datos para guardar toda la información de tu tienda. Crearla en DirectAdmin es muy simple.

1. En tu panel, busca el icono "MySQL Management".
2. Haz clic en "Create new database".
3. Ponle un nombre a tu base de datos (ej. mitienda_presta).
4. IMPORTANTE: Anota en un bloc de notas el nombre de la base de datos, el usuario y la contraseña que acabas de crear. Los necesitarás en el paso 4 de la instalación de PrestaShop.

Errores Comunes al Instalar PrestaShop y Cómo Solucionarlos

Ahora sí, vamos al lío. Aquí tienes los fallos que más verás y cómo arreglarlos.

Error 1: "El archivo no se puede cargar" o "La extensión no es válida"

Esto suele pasar al intentar subir el archivo .zip de PrestaShop desde el instalador de DirectAdmin (si tu hosting lo tiene) o al subir módulos.

Solución:

• Opción A (Recomendada): Sube el ZIP manualmente por FTP.
  1. Conéctate a tu servidor usando un cliente FTP como FileZilla.
  2. Navega hasta la carpeta public_html (o la carpeta donde quieras instalar PrestaShop, por ejemplo, public_html/tienda).
  3. Arrastra el archivo .zip de PrestaShop desde tu ordenador a esa carpeta.
  4. Una vez subido, desde el Administrador de Archivos de DirectAdmin, localiza el ZIP, haz clic derecho y selecciona "Extract".
• Opción B: Aumenta los límites de subida.
  • En "Select PHP Settings", busca upload_max_filesize y post_max_size. Pon ambos a 128M o más.

Error 2: Página en Blanco (White Screen) o Error 500

Este es uno de los PrestaShop problemas más desconcertantes. No ves nada, solo una pantalla en blanco.

Solución paso a paso:

1. Activa la visualización de errores de PHP. Temporalmente, para ver qué está fallando.
   • En el "Administrador de PHP", en "Switch to PHP Settings", busca display_errors y cámbialo a On.
   • También busca error_reporting y ponlo en E_ALL.
   • Guarda y recarga la página. Ahora, en lugar de un blanco, verás un mensaje de error real (ej. "Allowed memory size exhausted...").
2. Aumenta el Memory Limit. Si el error es de memoria, vuelve a la sección anterior y súbelo a 512M.
3. Revisa el archivo .htaccess. A veces, un .htaccess corrupto da error 500.
   • Ve al Administrador de Archivos.
   • Busca el archivo .htaccess en la carpeta de instalación.
   • Si existe, renómbralo a .htaccess_old para desactivarlo.
   • Vuelve a cargar tu sitio. Si funciona, el problema era el .htaccess. Puedes generar uno nuevo desde el panel de administración de PrestaShop más tarde (en Parámetros de la tienda > Tráfico y SEO > SEO y URLs, y guardar de nuevo).

Error 3: Problemas con la Base de Datos (Tablas no creadas, errores de conexión)

Durante la instalación, PrestaShop se conecta a la base de datos que creaste. Si falla, no podrás continuar.

Solución rápida:

1. Verifica los datos de conexión. Revisa que el nombre de la base de datos, el usuario y la contraseña que escribiste en el asistente de instalación de PrestaShop sean exactamente los mismos que anotaste en DirectAdmin. Un simple error tipográfico es la causa más común.
2. El usuario debe tener todos los privilegios. En tu panel de DirectAdmin, ve a "MySQL Management", busca la base de datos y asegúrate de que el usuario asociado tenga marcados todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.).
3. Revisa el prefijo de las tablas. Por defecto, PrestaShop usa ps_. Si ya has tenido una instalación anterior, asegúrate de cambiar el prefijo en el instalador (ej. ps_new_) para evitar conflictos.

Error 4: El Instalador se "Congela" en el Paso 3 o 4

Te quedas atascado en "Comprobación de compatibilidad" o en "Instalación de la base de datos".

Solución:

• Timeout de PHP. La instalación puede llevar más tiempo del que el servidor permite.
  1. En "Select PHP Settings", busca max_execution_time.
  2. Cámbialo a un valor alto, por ejemplo, 300 (segundos).
• Permisos de archivos incorrectos. PrestaShop necesita poder escribir en ciertas carpetas.
  1. Ve al Administrador de Archivos.
  2. Navega a tu carpeta de instalación de PrestaShop.
  3. Haz clic derecho en las carpetas config, cache, log, img, mails, modules, themes, translations, upload y download y selecciona "Change Permissions".
  4. Pon los permisos en 755 para las carpetas y 644 para los archivos (si ves algún archivo con permisos extraños, ponlo en 644). A veces, para la instalación, poner las carpetas en 777 es necesario, pero cámbialas de vuelta a 755 después de la instalación por seguridad.

[INFO] Si usas un panel alternativo como Syspanel (antes conocido como HestiaCP), recuerda que el puerto de acceso es el 2106. La gestión de PHP y bases de datos es muy similar, pero la ubicación de las opciones puede variar ligeramente. Si estás en Syspanel, busca "PHP-FPM" o "Administrador de paquetes" para ajustar los límites.

Preguntas Frecuentes (FAQ) sobre DirectAdmin y PrestaShop

Aquí tienes las dudas que más nos llegan al soporte técnico.

¿Cuál es la mejor versión de PHP para PrestaShop en DirectAdmin?

Respuesta: La versión PHP 8.1 es actualmente el punto óptimo entre compatibilidad y rendimiento. PHP 8.2 también funciona perfectamente. Evita PHP 7.4 o inferior, ya que PrestaShop 8 no es compatible.

¿Cómo cambio la versión de PHP en DirectAdmin?

Respuesta: Es muy sencillo. Busca el icono "Select PHP Version" en tu panel. Ahí podrás elegir la versión de PHP que se usará para tu cuenta de hosting. Recuerda guardar los cambios.

Después de instalar, la tienda se ve muy lenta. ¿Qué hago?

Respuesta: La lentitud post-instalación es común. Prueba estas soluciones:

1. Activa la caché de PrestaShop: Ve a Parámetros de la tienda > Rendimiento > Caché. Actívala y elige "Sistema de archivos".
2. Combina y comprime archivos CSS/JS: En la misma página de Rendimiento, activa "Combinar archivos CSS" y "Combinar archivos JavaScript".
3. Optimiza las imágenes: Usa un módulo de compresión de imágenes o comprime las imágenes antes de subirlas.

He instalado PrestaShop, pero al entrar al panel de administración me da error 403 Forbidden.

Respuesta: Este error suele ser un problema de permisos en la carpeta admin (o el nombre que le hayas dado a tu carpeta de administración).

1. Ve al Administrador de Archivos.
2. Busca la carpeta de administración.
3. Cambia sus permisos a 755.
4. Si el error persiste, revisa el archivo .htaccess dentro de esa carpeta. Podría tener reglas de bloqueo demasiado estrictas.

Conclusión: Tu Tienda ya está en Marcha

Como has visto, la mayoría de errores PrestaShop DirectAdmin tienen solución y, a menudo, se deben a pequeños detalles de configuración. Con esta guía, ya tienes las herramientas para diagnosticar y arreglar los problemas más comunes al instalar PrestaShop DirectAdmin.

Recuerda siempre:

1. Verifica los requisitos (PHP, extensiones, memoria) antes de empezar.
2. Anota los datos de tu base de datos correctamente.
3. Ajusta los permisos de las carpetas si es necesario.
4. No tengas miedo de buscar ayuda. Si un error persiste, tu proveedor de hosting (especialmente si es compatible con DirectAdmin PrestaShop) puede echarte una mano con la configuración del servidor.

Ahora, ¡ve y construye esa tienda online que tienes en mente! El camino puede tener algún pequeño bache, pero con paciencia y estos trucos, llegarás a la meta. ¡Mucho éxito con tu proyecto!