Errores comunes al instalar PrestaShop en DirectAdmin y cómo solucionarlos

Antes de Empezar: La Base de Todo Problema con PrestaShop en DirectAdmin

Instalar PrestaShop en un servidor con panel DirectAdmin es una tarea muy común, pero no está exenta de obstáculos. A menudo, los errores no son culpa del código de PrestaShop, sino de la configuración del servidor o de pequeños detalles que pasamos por alto.

Antes de lanzarnos a la sopa de letras de códigos de error, es crucial entender un principio básico: PrestaShop es un software muy exigente con los requisitos del servidor. No es como instalar un plugin de WordPress. Necesita versiones específicas de PHP, extensiones concretas activadas y permisos de archivos perfectos para funcionar sin problemas.

Cuando veas un error, respira hondo. Casi todos tienen solución y, en la mayoría de los casos, no necesitarás ser un gurú de la programación para arreglarlo. Solo necesitas seguir una guía lógica y metódica.

En este artículo, vamos a desglosar los fallos más comunes que encontrarás al instalar PrestaShop en DirectAdmin, explicando por qué ocurren y, lo más importante, cómo solucionarlos paso a paso. Vamos a ello.

Error 1: La Pantalla en Blanco (WSOD - White Screen of Death)

Este es, sin duda, el error más frustrante. Subes los archivos, configuras la base de datos, intentas acceder a tu tienda y... nada. Una pantalla completamente blanca. Es como si el servidor se hubiera tragado tu web.

¿Por Qué Ocurre?

La pantalla blanca casi siempre es culpa de un error fatal de PHP que está siendo ocultado. PrestaShop intenta ejecutar un código, encuentra un problema grave (como una función no definida o un conflicto de memoria) y se detiene en seco, sin mostrar ningún mensaje en pantalla.

Las causas más comunes en DirectAdmin son:

Versión de PHP incorrecta: PrestaShop 1.7 y 1.8 (las versiones modernas) requieren PHP 7.1 o superior, siendo PHP 7.4 o 8.0 lo ideal. Si tu dominio usa PHP 5.6, la pantalla blanca es casi segura.
Límite de memoria agotado: El proceso de instalación de PrestaShop es muy "hambriento" en recursos. Si el límite de memoria PHP es muy bajo (por ejemplo, 32M), fallará.
Extensiones PHP desactivadas: PrestaShop necesita extensiones como curl, openssl, pdo, mysqli, gd, zip, etc. Si alguna crucial está desactivada, el código no puede continuar.

Solución Paso a Paso

[INFO] Activa la visualización de errores de PHP temporalmente para ver qué está fallando. Esto es como abrir el capó del coche para ver el motor.

Accede a tu panel de control de DirectAdmin.
Busca la sección "Administración de PHP" o "Configuración de PHP". En DirectAdmin, normalmente se llama "PHP Version Selector" o "CustomBuild".
Dentro de esta sección, podrás cambiar la versión de PHP para tu dominio. Selecciona la versión más reciente y estable (PHP 8.0 o 8.1 es una buena opción para PrestaShop 8).
Activa las extensiones necesarias. En la misma pantalla, verás una lista de extensiones. Asegúrate de que estén activadas (marcadas) al menos: curl, gd, intl, mbstring, mysqli, openssl, zip, pdo.
Aumenta el límite de memoria. Busca la opción memory_limit y cámbiala a 512M o incluso -1 (sin límite) durante la instalación. Después podrás bajarlo a 256M.
Guarda los cambios y vuelve a intentar la instalación.

Si el problema persiste, necesitas ver el error real.

Ve a tu gestor de archivos en DirectAdmin (o usa FTP).
Busca el archivo config/defines.inc.php en la raíz de tu instalación de PrestaShop.
Ábrelo con el editor de texto y busca la línea que dice define('_PS_MODE_DEV_', false);.
Cámbiala a define('_PS_MODE_DEV_', true);. Esto activará el modo de desarrollo y mostrará los errores en pantalla.
Guarda el archivo e intenta acceder de nuevo. Ahora verás el error específico, que suele ser mucho más fácil de diagnosticar.

Error 2: "Fatal error: Allowed memory size of X bytes exhausted"

Este es un clásico. Verás este mensaje justo en el momento en que intentas instalar la tienda o importar una base de datos grande.

¿Por Qué Ocurre?

Es exactamente lo que dice: el script de PrestaShop necesita más memoria de la que PHP le permite usar. Es como si intentaras meter una maleta gigante en un maletero de coche pequeño; no cabe.

Solución Paso a Paso

Accede al "PHP Version Selector" en DirectAdmin (igual que en el error anterior).
Busca la opción memory_limit.
Aumenta el valor a 512M o -1. -1 es una solución rápida para la instalación, pero no la recomiendo para un sitio en producción.
Guarda los cambios.

[TIP] Si no encuentras la opción en el selector de PHP, siempre puedes crear o editar un archivo llamado php.ini en la raíz de tu dominio y añadir la línea: memory_limit = 512M. DirectAdmin respetará este archivo si está en la carpeta correcta.

Error 3: "No se pudo conectar a la base de datos" o "Error al conectar a MySQL"

Este error es muy común y suele aparecer en el paso 3 o 4 del asistente de instalación de PrestaShop.

¿Por Qué Ocurre?

La causa casi siempre es un error humano al introducir los datos de la base de datos. Pero también puede ser un problema de permisos de MySQL.

Solución Paso a Paso

Verifica los datos de acceso. Asegúrate de que estás introduciendo el nombre de la base de datos correcto, el usuario correcto y la contraseña correcta.
Comprueba el prefijo de la base de datos. Algunos hosts usan prefijos (ej. tuusuario_). En DirectAdmin, normalmente el nombre de la base de datos y el usuario llevan el prefijo de tu cuenta de hosting. Por ejemplo, si tu usuario es juan, la base de datos podría llamarse juan_prestashop y el usuario juan_presta.
Revisa los permisos del usuario MySQL. A veces, el usuario no tiene todos los privilegios sobre la base de datos.
- Ve a la sección "MySQL Management" en DirectAdmin.
- Busca tu base de datos y el usuario asociado.
- Haz clic en "Editar" o "Privilegios".
- Marca TODOS los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.) y guarda.

[WARNING] Si estás usando una IP para el servidor MySQL, no la uses. En DirectAdmin, el host de la base de datos es casi siempre localhost.

Error 4: El Instalador se Queda Atascado en "Instalando" o se Reinicia

A veces, el progreso de la instalación llega al 80% o 90% y se queda congelado para siempre, o la página se recarga y empieza de nuevo.

¿Por Qué Ocurre?

Esto es un problema de tiempo de ejecución de PHP (max_execution_time). El proceso de instalación (especialmente la creación de tablas y la inserción de datos) lleva tiempo. Si PHP tiene un límite de 30 segundos y el proceso necesita 60, se corta a mitad de camino.

Solución Paso a Paso

Vuelve al "PHP Version Selector" en DirectAdmin.
Busca la opción max_execution_time.
Cámbiala a 300 (5 minutos) o incluso 600 (10 minutos) para la instalación.
Guarda y limpia la caché del navegador. Borra también las tablas de la base de datos que se hayan creado a medias (si puedes) o crea una base de datos nueva para empezar de cero.

Error 5: Error 500 - Internal Server Error

El temido Error 500. Es un error genérico del servidor, pero en el contexto de DirectAdmin y PrestaShop, suele tener un culpable claro.

¿Por Qué Ocurre?

Permisos de archivos incorrectos. Los archivos de PrestaShop deben tener permisos 644 y las carpetas 755. Si algo se subió con permisos 777 o 600, el servidor no puede leerlo correctamente.
Archivo .htaccess corrupto. PrestaShop genera un archivo .htaccess en la raíz. Si está mal configurado, puede provocar un Error 500.
Problemas con el módulo de Apache. A veces, la configuración de Apache de DirectAdmin entra en conflicto.

Solución Paso a Paso

Corrige los permisos de los archivos.
- Ve al "File Manager" de DirectAdmin.
- Selecciona todos los archivos y carpetas de tu instalación de PrestaShop.
- Haz clic en el botón "Change Permissions".
- Asegúrate de que los archivos estén en 644 y las carpetas en 755. Puedes hacerlo manualmente o usar la opción de "aplicar a todos los archivos y subcarpetas" de forma recursiva.
Renombra el archivo .htaccess.
- En el File Manager, busca el archivo .htaccess en la raíz.
- Cámbiale el nombre a .htaccess.bak. Esto lo desactivará.
- Intenta cargar tu tienda. Si ahora funciona (aunque sea con errores de URL), el problema era el .htaccess. Puedes generar uno nuevo desde el panel de administración de PrestaShop (Parámetros avanzados -> Rendimiento -> "Generar .htaccess").

Error 6: Problemas con la URL o Bucle de Redirección

Has instalado PrestaShop, pero al acceder a la tienda te redirige constantemente a la página de instalación, o la URL no funciona correctamente.

¿Por Qué Ocurre?

La configuración de la tienda no se ha guardado correctamente. Las URLs de la tienda se guardan en la tabla ps_shop_url de la base de datos.
El archivo settings.inc.php está desactualizado. Este archivo (en la carpeta config/) contiene la configuración de conexión a la base de datos y las URLs.

Solución Paso a Paso

Accede a tu base de datos a través de phpMyAdmin (en DirectAdmin, se encuentra en la sección "MySQL Management").
Abre la tabla ps_shop_url.
Verifica que los campos domain y domain_ssl tengan la URL correcta de tu tienda (sin http:// o https://). Por ejemplo, midominio.com.
Si la URL es incorrecta, cámbiala y guarda.

[TIP] Si no sabes qué URL poner, usa la que aparece en la barra de direcciones de tu navegador cuando intentas acceder a la tienda, pero sin el http:// o https://.

Error 7: "El directorio no es escribible" o Permisos Denegados

Durante la instalación, PrestaShop te dice que ciertas carpetas no tienen permisos de escritura.

¿Por Qué Ocurre?

PrestaShop necesita escribir en carpetas como cache, log, img, config, etc., para almacenar archivos temporales, cachés y subir imágenes. Si estas carpetas no tienen el permiso adecuado, la instalación se detiene.

Solución Paso a Paso

Ve al "File Manager" de DirectAdmin.
Navega a la carpeta de tu instalación de PrestaShop.
Localiza las carpetas problemáticas (normalmente son cache, log, img, config, var, translations).
Haz clic derecho sobre cada carpeta y selecciona "Change Permissions".
Cambia los permisos a 755 o, si el error persiste, a 775. En algunos casos extremos, 777 funciona, pero intenta evitarlo por seguridad.

[WARNING] Usar permisos 777 en un servidor de producción es un riesgo de seguridad. Úsalo solo como último recurso y cámbialo tan pronto como termines la instalación.

Error 8: La Instalación se Queda en "Configuración de la Tienda" y no Avanza

Este es un error específico de PrestaShop 1.7 y versiones posteriores. El instalador se queda atascado en el paso final, "Configuración de la Tienda", sin importar lo que hagas.

¿Por Qué Ocurre?

Suele estar relacionado con un problema en la generación de las claves de seguridad o con una incompatibilidad con la versión de PHP o la extensión openssl.

Solución Paso a Paso

Verifica que la extensión openssl está activada en el PHP Version Selector de DirectAdmin.
Limpia la caché del navegador y las cookies.
Intenta con otro navegador (Chrome, Firefox, Edge) o en modo incógnito.
Si el problema persiste, cambia la versión de PHP. Si estás en PHP 8.1, prueba con PHP 8.0 o 7.4. A veces, la última versión de PHP no es totalmente compatible con la versión de PrestaShop que estás instalando.

Error 9: "Fatal error: Call to undefined function curl_init()"

Este error indica que la extensión curl de PHP no está instalada o activada en tu servidor DirectAdmin.

¿Por Qué Ocurre?

PrestaShop utiliza curl para muchas cosas, como verificar actualizaciones, conectar con pasarelas de pago y hacer peticiones externas. Si no está disponible, falla.

Solución Paso a Paso

Ve al "PHP Version Selector" en DirectAdmin.
Busca la extensión curl en la lista.
Actívala marcando la casilla correspondiente.
Guarda los cambios. DirectAdmin recompilará PHP con la nueva extensión (esto puede tardar unos minutos).
Vuelve a intentar la instalación.

Error 10: Problemas con las Imágenes o el Generador de Miniaturas

Una vez instalada la tienda, las imágenes no se muestran o no se generan las miniaturas de los productos.

¿Por Qué Ocurre?

La extensión gd de PHP no está activada.
La carpeta img no tiene permisos de escritura.

Solución Paso a Paso

Activa la extensión gd en el PHP Version Selector de DirectAdmin.
Regenera las miniaturas desde el panel de administración de PrestaShop (Parámetros avanzados -> Rendimiento -> "Regenerar miniaturas").
Asegúrate de que la carpeta img y sus subcarpetas tengan permisos 755 (o 775).

Preguntas Frecuentes (FAQ) sobre Errores de PrestaShop en DirectAdmin

¿Qué hago si veo un error que no está en esta lista?

Lo primero, activa el modo de desarrollo de PrestaShop (cambiando _PS_MODE_DEV_ a true en config/defines.inc.php). Esto te mostrará el error real y específico. Anota el mensaje y búscalo en Google. Es muy probable que alguien más haya tenido el mismo problema.

¿Es mejor usar PHP 7.4 o PHP 8.0 para PrestaShop?

Para PrestaShop 1.7.7 y versiones posteriores, PHP 7.4 es la opción más estable y segura. PHP