Solucionar conexión PrestaShop a base de datos en DirectAdmin

¡Hola! Soy tu técnico de soporte amigable. Si estás leyendo esto es porque estás intentando conectar tu tienda PrestaShop a una base de datos en DirectAdmin y te has topado con un error. No te preocupes, es una situación más común de lo que parece y, con los pasos adecuados, podrás resolverlo en pocos minutos.

Vamos a desglosar las causas más frecuentes y, paso a paso, te guiaré para que tu conexión base de datos funcione a la perfección. Al final, tendrás un checklist para futuras instalaciones.

¿Por qué ocurre el error de conexión a la base de datos en PrestaShop?

Cuando ves el mensaje de error al instalar PrestaShop, generalmente es porque el sistema no puede comunicarse con el servidor de bases de datos MySQL o MariaDB que tienes en tu panel DirectAdmin. Las causas suelen ser muy concretas y, en la mayoría de los casos, se solucionan revisando cuatro puntos clave:

Credenciales incorrectas (usuario, contraseña o nombre de base de datos).
Privilegios de usuario no asignados a la base de datos.
Nombre del servidor de base de datos erróneo (a veces se usa "localhost" cuando debería ser otro).
Firewall o configuración de red que bloquea la conexión.

Vamos a ver cada uno con detalle, con instrucciones muy visuales para que no te pierdas.

Solución paso a paso: Cómo arreglar la conexión en DirectAdmin

1. Verifica las credenciales de la base de datos

Este es el error más común. En DirectAdmin, los nombres de usuario y bases de datos suelen tener un prefijo (tu nombre de usuario de hosting). Por ejemplo, si tu usuario es miusuario, la base de datos podría llamarse miusuario_mibd y el usuario miusuario_miuser.

Pasos para revisar en DirectAdmin:

Inicia sesión en tu panel DirectAdmin.
Busca la sección "Administración de MySQL" o "MySQL Management".
Verás una lista de tus bases de datos. Anota exactamente el nombre de la base de datos que vas a usar.
Haz clic en el icono de "Administrar" (normalmente un lápiz o engranaje) al lado de esa base de datos.
Allí verás los usuarios asociados. Si no hay ninguno, tendrás que crearlo (lo veremos en el paso 2).
Asegúrate de recordar la contraseña de ese usuario. Si no la recuerdas, puedes crear una nueva.

[TIP]
En DirectAdmin, los nombres de usuario y base de datos siempre llevan el prefijo de tu cuenta. Por ejemplo, si tu usuario de hosting es juanperez, la base de datos será juanperez_tienda y el usuario juanperez_admin. No olvides incluir ese prefijo cuando los escribas en PrestaShop.

2. Asigna los privilegios correctos al usuario de la base de datos

A veces el usuario existe, pero no tiene permisos para acceder a la base de datos. Esto es como tener la llave de una casa, pero no la puerta.

Cómo hacerlo en DirectAdmin:

Dentro de la sección "Administración de MySQL", haz clic en el nombre de la base de datos que quieres usar.
Busca la opción "Agregar usuario a la base de datos" o "Add User to Database".
Selecciona el usuario que quieres asignar (o crea uno nuevo si es necesario).
Marca todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.). Para una instalación limpia de PrestaShop, es mejor dar todos los permisos.
Haz clic en "Guardar" o "Submit".

[WARNING]
No asignes privilegios a un usuario que no sea de tu confianza. Dar permisos completos a un usuario externo podría comprometer la seguridad de tu tienda.

3. Configura el nombre del servidor de base de datos correctamente

Este es un punto que suele confundir. En la mayoría de los entornos de hosting compartido, el servidor de base de datos es "localhost". Sin embargo, en algunos casos (especialmente si tu hosting usa servidores separados o contenedores), puede ser una dirección IP o un nombre como mysql.tudominio.com.

¿Cómo saber cuál usar en DirectAdmin?

En tu panel DirectAdmin, busca la sección "Información del servidor" o "Server Info".
Busca la línea que dice "MySQL Host" o "Database Server". Normalmente será localhost.
Si tienes dudas, contacta a tu proveedor de hosting. Ellos te dirán el valor exacto.

Durante la instalación de PrestaShop:

En el paso de configuración de la base de datos, verás un campo llamado "Servidor de base de datos" o "Database server". Escribe ahí el valor que obtuviste (normalmente localhost).

[INFO]
Si tu hosting usa Syspanel (antes conocido como HestiaCP), el acceso a la base de datos se hace por el puerto 2106 y el servidor suele ser localhost. En DirectAdmin, el puerto por defecto es el 3306, pero rara vez necesitas cambiarlo.

4. Comprueba el firewall y la conectividad de red

A veces el problema no está en las credenciales, sino en que el servidor donde está tu base de datos no permite conexiones desde el servidor donde se ejecuta PrestaShop.

¿Cómo verificarlo?

Si tu PrestaShop está en un servidor diferente al de la base de datos (por ejemplo, en un VPS separado), asegúrate de que el firewall del servidor de base de datos permita conexiones desde la IP del servidor web.
En DirectAdmin, puedes revisar el firewall desde la sección "Firewall" o "ConfigServer Security & Firewall" si está instalado.
Si todo está en el mismo servidor (lo más común en hosting compartido), este paso no suele ser necesario.

[TIP]
Si estás usando un VPS y tienes acceso root, puedes probar la conexión desde la terminal con el comando: mysql -u tu_usuario -p -h localhost. Si funciona, el problema está en PrestaShop, no en la base de datos.

Errores comunes y sus soluciones rápidas

A veces el mensaje de error no es muy descriptivo. Aquí tienes una lista de los más frecuentes y cómo solucionarlos:

Error: "No se puede conectar al servidor de base de datos"

Causa probable: El nombre del servidor es incorrecto o el servicio MySQL no está corriendo.
Solución: Verifica que MySQL esté activo en DirectAdmin (en la sección "Servicios del sistema"). Si no lo está, inícialo. Además, asegúrate de usar localhost o la IP correcta.

Error: "Acceso denegado para el usuario"

Causa probable: Usuario o contraseña incorrectos, o el usuario no tiene permisos.
Solución: Revisa las credenciales en DirectAdmin y asegúrate de que el usuario esté asignado a la base de datos con todos los privilegios (paso 2).

Error: "Base de datos no encontrada"

Causa probable: El nombre de la base de datos está mal escrito o no existe.
Solución: Ve a DirectAdmin, confirma el nombre exacto de la base de datos (con el prefijo) y escríbelo igual en PrestaShop.

Error: "Host '...' no está permitido conectarse a este servidor MySQL"

Causa probable: El usuario de MySQL solo permite conexiones desde localhost y estás intentando conectarte desde otra IP.
Solución: En DirectAdmin, al crear o editar un usuario de base de datos, busca la opción "Host" y cámbiala a % (cualquier host) o especifica la IP del servidor web. Esto es menos común en hosting compartido, pero puede pasar en VPS.

Preguntas frecuentes (FAQ) sobre conexión PrestaShop y DirectAdmin

¿Puedo usar la misma base de datos para varias tiendas PrestaShop?

No es recomendable. Cada instalación de PrestaShop debe tener su propia base de datos para evitar conflictos de tablas. Si necesitas varias tiendas, crea bases de datos separadas en DirectAdmin.

¿Qué hago si olvidé la contraseña de la base de datos?

En DirectAdmin, puedes cambiar la contraseña de un usuario de base de datos desde la sección "Administración de MySQL". Simplemente edita el usuario y escribe una nueva contraseña. Luego, actualiza el archivo app/config/parameters.php de PrestaShop con la nueva contraseña.

¿Por qué PrestaShop me pide el puerto de la base de datos?

En instalaciones estándar, el puerto por defecto de MySQL es el 3306. Si tu hosting usa un puerto diferente (por ejemplo, si usas Syspanel, el puerto es el 2106), deberás indicarlo en el campo correspondiente durante la instalación. En DirectAdmin, rara vez necesitas cambiarlo.

¿Puedo instalar PrestaShop sin tener una base de datos creada primero?

No. PrestaShop necesita una base de datos vacía (o con tablas que se crearán durante la instalación). Debes crearla primero en DirectAdmin y luego usar esos datos en el instalador.

¿Qué hago si después de seguir todos los pasos sigo teniendo el error?

Revisa el archivo de logs de error de PHP o de MySQL. En DirectAdmin, puedes acceder a los logs desde la sección "Estadísticas" o "Logs". Busca mensajes como Access denied o Connection refused. Si no encuentras la solución, contacta al soporte de tu hosting con el mensaje de error exacto.

Conclusión: Checklist final para una conexión exitosa

Antes de volver a intentar la instalación, repasa esta lista:

La base de datos existe en DirectAdmin y tiene el nombre correcto (con prefijo).
El usuario de la base de datos existe y está asignado a esa base de datos.
El usuario tiene todos los privilegios marcados.
La contraseña del usuario es la que estás escribiendo en PrestaShop.
El servidor de base de datos es localhost (a menos que tu hosting indique lo contrario).
El servicio MySQL está activo en DirectAdmin.
Si usas un VPS, el firewall permite la conexión.

Con estos pasos, deberías poder completar la instalación de PrestaShop sin problemas. Recuerda que soy tu técnico de soporte amigable y siempre estoy aquí para ayudarte. ¡Buena suerte con tu tienda online!