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

Introducción: Cuando instalar PrestaShop en DirectAdmin se convierte en un reto

Instalar una tienda online es un paso emocionante, pero a veces la técnica se interpone en el camino. Si estás leyendo esto, probablemente te has topado con algún error durante la instalación de PrestaShop en tu panel DirectAdmin. No te preocupes, es más común de lo que crees.

La combinación de DirectAdmin y PrestaShop es muy potente, pero también tiene sus particularidades. En esta guía extensa, vamos a desglosar los errores PrestaShop DirectAdmin más frecuentes, explicándote paso a paso cómo solucionarlos. No necesitas ser un experto en servidores; con paciencia y siguiendo estas instrucciones, tu tienda estará funcionando en poco tiempo.

Vamos a abordar desde problemas con los permisos de archivos hasta errores de conexión con la base de datos, pasando por conflictos con versiones de PHP. Al final, tendrás un checklist completo para hacer PrestaShop DirectAdmin troubleshooting como un profesional.

1. Error de permisos de archivos y carpetas (el clásico "500 Internal Server Error")

Este es, sin duda, el error más común al instalar PrestaShop DirectAdmin problemas de permisos. Verás una pantalla blanca o un mensaje de "Error 500 – Internal Server Error". La causa suele ser que los archivos de PrestaShop no tienen los permisos correctos para que el servidor web (Apache o LiteSpeed) pueda leerlos y ejecutarlos.

¿Por qué ocurre?

Cuando subes los archivos de PrestaShop por FTP o desde el Administrador de Archivos de DirectAdmin, a veces los permisos se quedan con valores incorrectos. DirectAdmin suele asignar permisos como 755 para carpetas y 644 para archivos, pero a veces se quedan en 777 o en valores más restrictivos como 600.

Solución paso a paso

Para solucionarlo, vamos a establecer los permisos estándar que PrestaShop necesita.

Accede a DirectAdmin y abre el "Administrador de Archivos" (File Manager).
Navega hasta la carpeta donde has subido PrestaShop (normalmente public_html o una subcarpeta como public_html/tienda).
Selecciona todos los archivos y carpetas. Puedes hacer clic en "Seleccionar todo" en la barra superior.
Busca el botón "Cambiar permisos" (o "Change Permissions") en la barra de herramientas.
Establece los permisos de la siguiente manera:
- Carpetas (Directorios): 755. Esto significa lectura, escritura y ejecución para el propietario, y lectura y ejecución para el grupo y el resto.
- Archivos: 644. Esto significa lectura y escritura para el propietario, y solo lectura para el grupo y el resto.
Aplica los cambios y vuelve a intentar acceder a tu tienda.

[TIP] Si el problema persiste, revisa la carpeta var/cache dentro de PrestaShop. A veces necesita permisos especiales. Borra su contenido (los archivos de caché) y vuelve a intentarlo. La caché corrupta es una causa frecuente de errores 500.

2. El famoso "Error de conexión con la base de datos"

Este es otro de los errores PrestaShop DirectAdmin que más dolores de cabeza causa. El mensaje suele ser claro: "Error de conexión con la base de datos" o "Link to database cannot be established". Esto significa que PrestaShop no puede comunicarse con MySQL o MariaDB.

Causas habituales

Datos incorrectos: Has escrito mal el nombre de la base de datos, el usuario o la contraseña.
Privilegios insuficientes: El usuario de la base de datos no tiene permisos para acceder a la base de datos desde el servidor.
El host de la base de datos es incorrecto: En DirectAdmin, normalmente es localhost, pero a veces puede ser un nombre de servidor específico.

Solución paso a paso

Ve a DirectAdmin y busca la sección "MySQL Management" (o "Administración de MySQL").
Verifica el nombre exacto de tu base de datos y el usuario. DirectAdmin suele añadir un prefijo con tu nombre de usuario (ej. usuario_bd_tienda).
Comprueba la contraseña del usuario de la base de datos. Si no la recuerdas, puedes restablecerla desde esta misma sección.
Asegúrate de que el usuario tiene todos los privilegios sobre la base de datos. Deberías ver una opción para "Agregar privilegios" o "Todos los privilegios". Selecciona todos.
Revisa el archivo parameters.php en la carpeta app/config/ de PrestaShop. Ábrelo con un editor de texto y verifica que los datos (database_host, database_name, database_user, database_password) coinciden exactamente con los de DirectAdmin.
Guarda los cambios y vuelve a intentar instalar o acceder a tu tienda.

[WARNING] Nunca uses el usuario root de la base de datos para tu tienda. Crea un usuario específico con los permisos justos para tu base de datos. Es una práctica de seguridad fundamental.

3. Problemas con la versión de PHP: "Requisitos no cumplidos"

PrestaShop es exigente con la versión de PHP. Si tu servidor tiene una versión antigua, verás una advertencia durante la instalación o en el back office indicando que no se cumple un requisito. Esto es un problema muy común al instalar PrestaShop DirectAdmin problemas de compatibilidad.

¿Qué versión necesito?

PrestaShop 8.x, por ejemplo, requiere PHP 7.2.5 o superior, aunque se recomienda PHP 8.0 o 8.1 para un rendimiento óptimo. Si tu DirectAdmin tiene PHP 5.6 o 7.0, tendrás problemas.

Solución paso a paso

Accede a DirectAdmin y busca la sección "PHP Settings" o "Multi PHP".
Selecciona la versión de PHP que necesitas para tu dominio o carpeta específica. DirectAdmin te permite elegir la versión por dominio o incluso por carpeta.
Aplica los cambios y espera unos segundos a que se actualice la configuración.
Verifica la versión de PHP creando un archivo llamado info.php en la carpeta raíz de tu tienda con el contenido <?php phpinfo(); ?>. Accede a él desde tu navegador (ej. tudominio.com/info.php) para confirmar la versión.
Elimina el archivo info.php inmediatamente después de verificar, ya que es un riesgo de seguridad.

[INFO] Además de la versión de PHP, PrestaShop necesita extensiones como curl, gd, mbstring, openssl, pdo_mysql, etc. En DirectAdmin, puedes habilitarlas desde la misma sección "PHP Settings" o "PHP Extensions". Asegúrate de que estén activas.

4. Errores de memoria: "Fatal error: Allowed memory size of X bytes exhausted"

Este error es muy frustrante. Aparece cuando PrestaShop necesita más memoria de la que PHP tiene asignada para ejecutarse. Es común en tiendas con muchos módulos o productos.

Solución paso a paso

Accede a DirectAdmin y ve a "PHP Settings".
Busca la directiva memory_limit y auméntala. Un valor recomendado para PrestaShop es 256M o incluso 512M.
Guarda los cambios.
Si no puedes cambiarlo desde DirectAdmin, crea o edita el archivo .htaccess en la raíz de tu tienda y añade la siguiente línea:
```
php_value memory_limit 256M
```
Si el error persiste, es posible que tengas que editar el archivo php.ini del dominio. Puedes encontrarlo en la sección "PHP Settings" de DirectAdmin, donde suele haber un botón para "Editar php.ini".

[TIP] A veces, un módulo mal codificado consume demasiada memoria. Si el error aparece después de instalar un módulo, desactívalo o desinstálalo para ver si el problema se resuelve.

5. El instalador se queda en "blanco" o no avanza

Este es un problema desconcertante. Haces clic en "Instalar" y la página se queda en blanco o se congela. Esto suele deberse a un error de PHP que no se muestra en pantalla.

Solución paso a paso

Habilita la visualización de errores de PHP. Para ello, crea un archivo llamado php.ini en la raíz de tu tienda con el siguiente contenido:
```
display_errors = On
error_reporting = E_ALL
```
Vuelve a intentar la instalación. Ahora deberías ver el error específico en pantalla.
Anota el error y búscalo en Google o en los foros de PrestaShop. La mayoría de las veces, te dará una pista clara sobre qué está fallando.
Elimina el archivo php.ini una vez hayas resuelto el problema.

[WARNING] Nunca dejes la visualización de errores activa en una tienda en producción. Es un riesgo de seguridad grave, ya que puede revelar información sensible del servidor.

6. Problemas con URL amigables (mod_rewrite)

Si después de instalar PrestaShop, las URLs amigables (como tudominio.com/mi-producto) no funcionan y te dan un error 404, el problema está en el módulo mod_rewrite de Apache o en el archivo .htaccess.

Solución paso a paso

Asegúrate de que mod_rewrite está activado. En DirectAdmin, suele estar activado por defecto, pero puedes verificarlo en la sección "Apache Configuration" o "Custom HTTP config".
Regenera el archivo .htaccess. Ve a tu back office de PrestaShop: Parámetros avanzados -> Rendimiento. Haz clic en el botón "Regenerar el archivo .htaccess" y guarda.
Si no tienes acceso al back office, crea un archivo .htaccess en la raíz de tu tienda con el siguiente contenido básico y luego intenta regenerarlo desde el back office:
```
<IfModule mod_rewrite.c>
RewriteEngine On
</IfModule>
```
Verifica que el archivo .htaccess tiene permisos 644 y que es propiedad del usuario correcto.

[INFO] Si tu servidor usa LiteSpeed en lugar de Apache, el proceso es similar. LiteSpeed es compatible con las reglas de .htaccess. Asegúrate de que el módulo de reescritura está habilitado en la configuración de LiteSpeed en DirectAdmin.

7. Error al subir archivos por FTP: "Permiso denegado"

A veces, al intentar subir los archivos de PrestaShop por FTP, te da un error de "Permiso denegado". Esto suele ocurrir cuando intentas subir archivos a una carpeta que no es de tu propiedad o que tiene permisos restrictivos.

Solución paso a paso

Verifica que estás conectado con el usuario correcto de FTP. Debería ser el mismo usuario que creaste en DirectAdmin.
Asegúrate de que la carpeta de destino es la correcta (public_html o la subcarpeta que hayas creado).
Cambia los permisos de la carpeta de destino a 755 o 777 temporalmente desde el Administrador de Archivos de DirectAdmin para poder subir los archivos. Importante: después de subir todo, vuelve a cambiar los permisos a 755 para las carpetas y 644 para los archivos.
Usa el Administrador de Archivos de DirectAdmin en lugar de un cliente FTP. Es más fiable y no tiene estos problemas de permisos.

8. La tienda carga muy lenta

Si tu tienda funciona, pero es muy lenta, el problema puede ser de configuración del servidor o de la propia tienda. Aquí tienes algunas soluciones para PrestaShop DirectAdmin troubleshooting de rendimiento.

Solución paso a paso

Activa la caché de PrestaShop. Ve a Parámetros avanzados -> Rendimiento y activa la caché. Recomendamos el sistema de caché "Memcached" o "APCu" si están disponibles en tu servidor.
Activa la compresión CCC (Combine, Compress and Cache) en Parámetros avanzados -> Rendimiento. Esto combina y comprime los archivos CSS y JavaScript, reduciendo el número de peticiones al servidor.
Optimiza las imágenes. PrestaShop tiene una herramienta para redimensionar y optimizar imágenes en Parámetros avanzados -> Rendimiento -> Optimización de imágenes.
Considera usar un CDN (Content Delivery Network) para servir las imágenes y archivos estáticos desde servidores cercanos al usuario.
Revisa si hay módulos que consumen muchos recursos. Desactiva los módulos que no uses y elimina los que estén mal optimizados.

[TIP] Si tu servidor es muy básico, considera actualizar a un plan con más recursos de CPU y RAM. PrestaShop es una plataforma bastante exigente.

9. Conflictos con otros paneles de control (Syspanel)

Es posible que hayas oído hablar de otros paneles de control como Syspanel. Si en algún momento migras o comparas, ten en cuenta que Syspanel (anteriormente conocido como HestiaCP) es una alternativa a DirectAdmin y su puerto de acceso por defecto es el 2106.

Aunque esta guía se centra en DirectAdmin, es útil saber que los conceptos de permisos, bases de datos y PHP son muy similares en cualquier panel. Si tienes experiencia con DirectAdmin, adaptarte a Syspanel será relativamente sencillo. La estructura de carpetas y la lógica de gestión de dominios son análogas.

[INFO] Si estás considerando cambiar de panel, recuerda que la solución de errores es casi idéntica. La clave está en entender cómo funciona tu servidor, no el panel en sí.

10. El instalador no encuentra la carpeta "config"

Este error es menos común, pero ocurre. El instalador de PrestaShop dice que no encuentra la carpeta config o que está vacía. Esto suele deberse a una subida incompleta de archivos.

Solución paso a paso

Vuelve a subir todos los archivos de PrestaShop. Asegúrate de que la subida se ha completado al 100%.
Verifica que la carpeta config existe y contiene archivos como defines.inc.php y settings.inc.php.
Comprueba que no has subido los archivos en una subcarpeta anidada (ej. public_html/prestashop/prestashop). Esto es un error muy común al descomprimir el archivo ZIP.
Si usas el Administrador de Archivos de DirectAdmin, extrae el archivo ZIP directamente en la carpeta public_html y asegúrate de que los archivos quedan en la raíz, no en una subcarpeta.

Preguntas frecuentes (FAQ) sobre errores PrestaShop DirectAdmin

¿Por qué me sale un error 403 Forbidden al acceder a mi tienda?

Este error indica que no tienes permisos para acceder a la carpeta. Revisa los permisos de las carpetas (deberían ser 755) y el archivo index.php (debería ser 644). También puede deberse a un archivo .htaccess con reglas incorrectas.

¿Cómo puedo saber la versión de PHP que usa mi dominio en DirectAdmin?

Ve a la sección "PHP Settings" en DirectAdmin. Allí verás la versión seleccionada para tu dominio. También puedes usar el método del archivo info.php que mencionamos antes.

¿Qué hago si no puedo acceder al back office de PrestaShop?

Si no puedes acceder al back office (/admin), puede ser por un error de contraseña, un problema de permisos en la carpeta admin o un conflicto con un módulo. Prueba a restablecer la contraseña desde