Configurar conexión a base de datos PrestaShop con DirectAdmin

Configurar la conexión a la base de datos en PrestaShop es uno de los pasos más críticos al instalar o migrar tu tienda online. Si este archivo no está bien configurado, tu tienda simplemente no cargará. Pero no te preocupes, en esta guía te explicaré paso a paso cómo hacerlo desde el panel de control DirectAdmin, de forma clara y sin tecnicismos innecesarios.

Vamos a cubrir desde cómo encontrar los datos de tu base de datos en DirectAdmin hasta cómo modificar el archivo de configuración de PrestaShop (el famoso app/config/parameters.php). También incluiremos una sección de preguntas frecuentes para resolver las dudas más comunes.

¿Qué necesitas saber antes de empezar?

Para que PrestaShop funcione correctamente, necesita comunicarse con una base de datos MySQL (o MariaDB). En DirectAdmin, tú mismo puedes crear y gestionar bases de datos de forma muy sencilla.

Los datos que necesitarás son:

Nombre de la base de datos (ejemplo: tudominio_bdtienda)
Usuario de la base de datos (ejemplo: tudominio_usuario)
Contraseña del usuario
Servidor de base de datos (normalmente localhost o una IP como 127.0.0.1)

[INFO] En la mayoría de los planes de hosting compartido con DirectAdmin, el servidor de base de datos es localhost. Si tu hosting usa un servidor remoto, el proveedor te dará la dirección exacta.

Paso 1: Crear la base de datos y el usuario en DirectAdmin

Si aún no tienes una base de datos creada, este es el primer paso. Sigue estos pasos:

Accede a DirectAdmin con tu usuario y contraseña (normalmente los mismos que usas para tu hosting).
Busca la sección “Administrador de MySQL” o “MySQL Management”. En algunas versiones de DirectAdmin, puede estar dentro de “Cuentas de usuario” o directamente en el menú principal.
Haz clic en “Crear nueva base de datos”.
Introduce un nombre para tu base de datos (por ejemplo, prestashop_tienda). DirectAdmin suele añadir automáticamente un prefijo con tu nombre de usuario, así que quedará algo como tudominio_prestashop_tienda.
Crea un usuario para esa base de datos. Pon un nombre (ejemplo: usuariopresta) y una contraseña segura. Anótala, la necesitarás después.
Asigna todos los privilegios al usuario sobre la base de datos (suele venir marcado por defecto).
Haz clic en “Crear”.

Ya tienes tu base de datos lista. Ahora, apunta estos tres datos: nombre de la base, usuario y contraseña.

[TIP] Anota estos datos en un bloc de notas. Los usarás varias veces durante la configuración.

Paso 2: Localizar el archivo de configuración de PrestaShop

PrestaShop guarda todos los datos de conexión a la base de datos en un archivo llamado parameters.php, que se encuentra dentro de la carpeta app/config/ de tu instalación.

Si acabas de instalar PrestaShop por primera vez, este archivo se genera automáticamente durante el asistente de instalación. Si estás migrando o restaurando una tienda, deberás editarlo manualmente.

Para acceder a él desde DirectAdmin:

En el panel de DirectAdmin, ve a “Administrador de archivos” (File Manager).
Navega hasta la carpeta donde instalaste PrestaShop (normalmente public_html o una subcarpeta como tienda).
Abre la carpeta app, luego config.
Busca el archivo parameters.php y haz clic derecho para “Editar” (o selecciona la opción de edición de texto).

[WARNING] No modifiques ningún otro archivo de esta carpeta si no sabes lo que haces. Un cambio incorrecto puede romper tu tienda.

Paso 3: Editar el archivo parameters.php

Al abrir parameters.php, verás un código PHP con muchas líneas. No te asustes, solo nos interesa la sección de database_*. Busca algo similar a esto:

'database_host' => 'localhost',
'database_port' => '',
'database_name' => 'nombre_de_tu_base',
'database_user' => 'usuario_de_tu_base',
'database_password' => 'contraseña_de_tu_base',
'database_prefix' => 'ps_',

Ahora, reemplaza los valores con los que creaste en DirectAdmin:

database_host: generalmente localhost. Si tu hosting usa otro servidor, pon la IP o nombre del servidor.
database_port: déjalo vacío o pon 3306 (puerto por defecto de MySQL).
database_name: el nombre exacto que creaste (ejemplo: tudominio_prestashop_tienda).
database_user: el usuario que creaste (ejemplo: tudominio_usuariopresta).
database_password: la contraseña que elegiste.
database_prefix: déjalo como ps_ a menos que hayas usado otro prefijo durante la instalación.

Guarda los cambios y cierra el archivo.

[INFO] Si el archivo no existe (por ejemplo, si es una instalación nueva), puedes crearlo manualmente copiando el contenido de parameters.php.dist (si existe) y luego editándolo. En versiones recientes de PrestaShop, el asistente de instalación lo genera automáticamente.

Paso 4: Verificar la conexión

Una vez guardados los cambios, es hora de comprobar que todo funciona.

Abre tu navegador y visita la URL de tu tienda (por ejemplo, https://tudominio.com).
Si todo está bien, verás la página principal de PrestaShop (o el panel de administración si accedes a /admin).
Si ves un mensaje de error como “Error de conexión a la base de datos” o “Cannot connect to database”, revisa los pasos anteriores.

Posibles problemas y soluciones rápidas:

Nombre de base de datos incorrecto: vuelve a DirectAdmin y verifica el nombre exacto.
Usuario o contraseña mal escritos: asegúrate de no tener espacios adicionales.
Servidor de base de datos incorrecto: si no es localhost, consulta con tu proveedor de hosting.
Permisos insuficientes: en DirectAdmin, asegúrate de que el usuario tenga todos los privilegios sobre la base de datos.

[WARNING] Si después de varios intentos sigue sin funcionar, contacta a tu proveedor de hosting. Puede que tengan restricciones de seguridad o que el servidor de MySQL esté caído.

Paso 5: Configurar la conexión en una migración o copia de seguridad

Si estás migrando tu tienda desde otro servidor o desde un entorno local, además de editar parameters.php, debes asegurarte de que la base de datos esté correctamente importada.

Exporta la base de datos antigua desde tu panel anterior (por ejemplo, desde phpMyAdmin).
Importa ese archivo SQL en DirectAdmin usando phpMyAdmin (lo encuentras en el menú de DirectAdmin como “phpMyAdmin” o “MySQL Databases”).

Ajusta las URLs en la base de datos si cambiaste de dominio. Puedes hacerlo con una consulta SQL como:

UPDATE ps_configuration SET value = 'https://nuevodominio.com' WHERE name = 'PS_SHOP_DOMAIN';
UPDATE ps_configuration SET value = 'https://nuevodominio.com' WHERE name = 'PS_SHOP_DOMAIN_SSL';

(Ajusta el prefijo ps_ si usaste otro).

Después de importar, edita parameters.php con los nuevos datos de conexión de DirectAdmin (usuario, contraseña, nombre de base, etc.).

[TIP] Si migras desde un servidor local (como XAMPP), recuerda que el database_host suele ser localhost también, pero la contraseña puede ser diferente.

Preguntas frecuentes (FAQ)

¿Qué hago si no encuentro el archivo parameters.php?

Si acabas de instalar PrestaShop, el archivo se crea durante el proceso de instalación. Si no aparece, revisa que hayas completado la instalación correctamente. En algunos casos, puede estar en app/config/parameters.php.dist. Si es así, renómbralo a parameters.php y luego edítalo.

¿Puedo usar un usuario de base de datos que ya existe?

Sí, siempre que ese usuario tenga permisos sobre la base de datos que vas a usar. En DirectAdmin, puedes asignar usuarios existentes a nuevas bases de datos desde el “Administrador de MySQL”.

¿Qué pasa si cambio la contraseña de la base de datos?

Deberás actualizarla también en el archivo parameters.php. Si no lo haces, PrestaShop perderá la conexión y tu tienda dejará de funcionar.

Mi hosting usa Syspanel (HestiaCP), ¿cómo accedo?

Si tu proveedor utiliza Syspanel (HestiaCP), el acceso suele ser a través del puerto 2106 (por ejemplo, https://tudominio.com:2106). Una vez dentro, busca la sección de bases de datos MySQL. El proceso de creación de base de datos y usuario es muy similar al de DirectAdmin.

¿Por qué me sale “Access denied for user”?

Esto significa que el usuario o la contraseña son incorrectos, o que el usuario no tiene permisos sobre la base de datos. Revisa los datos en DirectAdmin y asegúrate de que el usuario esté asignado a la base de datos correcta.

¿Necesito configurar algo más en DirectAdmin para que funcione?

No, con solo tener la base de datos creada y el usuario con permisos es suficiente. DirectAdmin se encarga del resto. Eso sí, asegúrate de que tu plan de hosting soporte PrestaShop (suele requerir PHP 7.4 o superior y MySQL 5.6+).

Resumen final

Configurar la conexión a la base de datos en PrestaShop desde DirectAdmin es un proceso sencillo si sigues estos pasos:

Crea la base de datos y el usuario desde el Administrador de MySQL de DirectAdmin.
Localiza y edita el archivo app/config/parameters.php con los datos correctos.
Verifica la conexión visitando tu tienda.
Si migras, importa la base de datos antigua y ajusta las URLs.

Recuerda que la paciencia es clave. Si algo falla, revisa los datos una y otra vez. Y si te quedas atascado, no dudes en contactar al soporte de tu hosting.

[INFO] Este artículo se enfoca en DirectAdmin, pero el proceso es muy similar en otros paneles como cPanel, Plesk o Syspanel (HestiaCP). Solo cambia la interfaz, pero la lógica es la misma.

Espero que esta guía te haya sido de gran ayuda. ¡Ahora ya puedes poner en marcha tu tienda PrestaShop con total confianza!