Conectar Base de Datos MySQL a PrestaShop | Guía Completa

Conectar tu tienda PrestaShop a su base de datos MySQL es uno de los pasos más críticos durante la instalación o migración de tu negocio online. Sin una conexión correcta, tu catálogo de productos, clientes y pedidos simplemente no existirán en la web. Si estás usando un panel de control como cPanel, Plesk o DirectAdmin, este proceso puede parecer técnico, pero te aseguro que es más sencillo de lo que crees.

En esta guía extensa y práctica, vamos a desglosar cómo conectar MySQL a PrestaShop, paso a paso, para cada uno de los paneles más populares. También resolveremos los errores de conexión PrestaShop más comunes y te daré trucos para que la configuración de PrestaShop MySQL sea un éxito a la primera. Vamos a ello.

Antes de empezar: ¿Qué necesitas para la conexión?

Antes de abrir tu navegador y lanzarte a la instalación, necesitas tener a mano tres datos clave. Son como las llaves de tu casa digital:

Nombre de la base de datos: El identificador único de tu almacén de datos.
Usuario de la base de datos: La persona (o script) que tiene permiso para entrar.
Contraseña del usuario: La clave secreta para autenticarse.

Además, necesitarás el host de la base de datos. En el 99% de los casos, este es localhost, pero en servidores más avanzados (o si usas una base de datos externa) puede ser una IP como 127.0.0.1 o un nombre de dominio como db.midominio.com.

[TIP]: Si tienes contratado un hosting compartido, el host casi siempre es localhost. Si usas servidores VPS o dedicados, puede variar. Guárdate estos datos en un bloc de notas antes de continuar.

Paso 1: Crear la Base de Datos y el Usuario en cPanel

cPanel es el panel más extendido del mundo. Si tu hosting usa este panel, sigue estos pasos para preparar el terreno.

Accediendo al asistente de bases de datos MySQL

Primero, inicia sesión en tu cPanel (normalmente en tudominio.com/cpanel). Busca la sección "Bases de Datos" y haz clic en "Asistente para bases de datos MySQL". Este asistente te guiará en tres pasos mágicos.

Crear la base de datos

En el primer paso, escribe un nombre para tu base de datos. cPanel añadirá automáticamente un prefijo con tu nombre de usuario (ej. usuario_prestashop_db).
Haz clic en "Crear base de datos".
Anota el nombre completo, incluyendo el prefijo. Lo necesitarás más tarde.

Crear el usuario de la base de datos

Ahora, en el segundo paso, crea un nombre de usuario (ej. usuario_presta) y una contraseña segura.
Usa el generador de contraseñas de cPanel para asegurarte de que sea robusta.
Haz clic en "Crear usuario".

Asignar privilegios al usuario

En el tercer paso, verás un menú desplegable para elegir el usuario y otro para la base de datos. Selecciona los que acabas de crear.
Marca la casilla "TODOS LOS PRIVILEGIOS" (o "ALL PRIVILEGES"). PrestaShop necesita control total sobre su base de datos para funcionar (crear tablas, insertar datos, etc.).
Haz clic en "Realizar cambios".

[INFO]: También puedes hacer esto manualmente desde "Bases de datos MySQL" en cPanel, pero el asistente es más rápido y evita errores.

Paso 2: Crear la Base de Datos en Plesk

Plesk es otro panel muy popular, especialmente en servidores VPS y dedicados con interfaz moderna. El proceso es ligeramente diferente pero igual de intuitivo.

Localizando el gestor de bases de datos

Inicia sesión en Plesk. En el panel izquierdo, busca la sección "Bases de datos" dentro de tu dominio o en el menú principal de "Sitios web y dominios".

Añadir una nueva base de datos

Haz clic en "Agregar base de datos" (o "Add Database").
En el campo "Nombre de la base de datos", escribe un nombre descriptivo (ej. prestashop_db).
En el campo "Tipo de base de datos", asegúrate de que esté seleccionado MySQL.
Deja la opción de servidor por defecto.

Configurando el usuario y la contraseña

Justo debajo del nombre, Plesk te ofrece la opción de crear un usuario para esa base de datos:

Marca la casilla "Crear un usuario de base de datos".
Introduce el nombre de usuario (ej. presta_user).
Introduce y confirma una contraseña segura.
Haz clic en "Aceptar" o "OK".

[TIP]: Plesk te permite copiar la contraseña generada automáticamente. Úsala y guárdala en tu gestor de contraseñas.

Paso 3: Crear la Base de Datos en DirectAdmin

DirectAdmin es conocido por su velocidad y ligereza. Si tu proveedor usa este panel, aquí tienes los pasos.

Entrando al menú de MySQL

Inicia sesión en DirectAdmin. Busca el icono o enlace llamado "MySQL Management" (Gestión de MySQL) en la sección de "Administración de Cuentas".

Crear la base de datos

En el campo "Database Name" (Nombre de la base de datos), escribe el nombre deseado (ej. tienda_presta).
DirectAdmin te mostrará el nombre completo con tu usuario como prefijo (ej. usuario_tienda_presta).
Haz clic en "Create Database" (Crear base de datos).

Crear el usuario y vincularlo

DirectAdmin es un poco más manual en este aspecto:

En la misma página, busca la sección "Add New User" (Agregar nuevo usuario).
Crea un nombre de usuario y una contraseña.
Haz clic en "Create User".
Ahora, en la sección "Add User to Database" (Agregar usuario a la base de datos), selecciona el usuario y la base de datos que acabas de crear en los menús desplegables.
Marca la casilla "ALL PRIVILEGES".
Haz clic en "Add".

[WARNING]: En DirectAdmin, es fácil olvidar el paso de vincular el usuario a la base de datos. Si no lo haces, PrestaShop no podrá conectarse. Asegúrate de completar ambos pasos.

Paso 4: Configurar PrestaShop para usar la Base de Datos

Ahora que tienes la base de datos y el usuario creados, es hora de decirle a PrestaShop dónde y cómo conectarse. Esto ocurre durante el proceso de instalación.

Ejecutando el instalador de PrestaShop

Sube los archivos de PrestaShop a tu servidor (normalmente en public_html o httpdocs) y abre tu dominio en el navegador. Te llevará automáticamente al asistente de instalación.

La pantalla de configuración de la base de datos

Llegarás a un paso llamado "Configuración de la base de datos". Aquí es donde usamos los datos que creamos antes.

Los campos son los siguientes:

Dirección del servidor de base de datos: Escribe localhost (o la IP que te haya dado tu proveedor).
Nombre de la base de datos: Escribe el nombre completo que anotaste (ej. usuario_prestashop_db).
Usuario de la base de datos: Escribe el nombre de usuario completo (ej. usuario_presta).
Contraseña de la base de datos: Escribe la contraseña que asignaste.
Prefijo de las tablas: Déjalo como ps_ por defecto. No lo cambies a menos que sepas lo que haces.

Haz clic en "Comprobar ahora" o "Siguiente". El instalador intentará conectarse. Si todo está correcto, pasará al siguiente paso.

Errores de conexión PrestaShop más comunes y cómo solucionarlos

Aquí es donde la gente suele sudar. No te preocupes, casi todos los errores de conexión PrestaShop tienen una solución sencilla.

Error: "No se puede conectar a la base de datos" o "Error de conexión a la base de datos"

Este es el error genérico. Significa que uno de los datos es incorrecto o que el servidor no está accesible.

Soluciones:

Verifica el host: Prueba a cambiar localhost por 127.0.0.1. A veces el servidor DNS local no resuelve bien.
Revisa el nombre completo: En cPanel y DirectAdmin, el nombre de usuario se antepone al nombre de la base de datos. mi_base no es lo mismo que usuario_mi_base. Verifica que estás usando el nombre completo que ves en el panel.
Contraseña con caracteres especiales: Si tu contraseña tiene caracteres como $, %, # o &, el instalador de PrestaShop a veces tiene problemas. Intenta cambiarla a una contraseña alfanumérica simple (en el panel de control) y vuelve a intentarlo.

[TIP]: Si estás migrando una tienda, asegúrate de que el archivo parameters.php (en la carpeta app/config/) tenga los datos correctos. Si los datos son antiguos, dará error.

Error: "El usuario no tiene acceso a la base de datos"

Este error indica que el usuario existe pero no tiene permisos sobre la base de datos específica.

Soluciones:

Vuelve a tu panel de control (cPanel, Plesk o DirectAdmin).
Busca la opción de "Administrar privilegios de usuario" o "Editar base de datos".
Asegúrate de que el usuario esté agregado a la base de datos correcta y que tenga TODOS los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.).

Error: "El servidor MySQL no está disponible"

Esto suele ser un problema del servidor, no tuyo.

Soluciones:

Espera unos minutos e inténtalo de nuevo.
Contacta con tu proveedor de hosting para verificar que el servicio MySQL está activo.
Si usas un hosting muy restrictivo, puede que el puerto 3306 (el de MySQL) esté bloqueado para conexiones externas. Asegúrate de que solo usas localhost.

Configurar PrestaShop MySQL para una migración (parámetros avanzados)

Si ya tienes una tienda y estás migrando de servidor, no ejecutas el instalador. En su lugar, editas un archivo de configuración.

Editando el archivo parameters.php

Este archivo se encuentra en config/ dentro de la raíz de tu PrestaShop (en versiones modernas).

Usa un editor de texto plano (como Notepad++ o Sublime Text) para abrirlo.
Busca la sección 'database_host', 'database_name', 'database_user' y 'database_password'.
Cambia los valores por los nuevos de tu servidor de destino.
Guarda el archivo y súbelo de nuevo al servidor.

[WARNING]: Haz siempre una copia de seguridad del archivo original antes de editarlo. Un error de sintaxis (una coma mal puesta) puede tumbar toda la tienda.

Preguntas Frecuentes (FAQ) sobre la conexión MySQL

¿Qué es el puerto de MySQL?
El puerto por defecto es el 3306. En la mayoría de los casos, no necesitas especificarlo porque PrestaShop lo usa automáticamente. Solo lo necesitarás si tu servidor usa un puerto personalizado.

¿Puedo usar la misma base de datos para dos tiendas PrestaShop?
No es recomendable. Cada tienda necesita sus propias tablas. Si usas la misma base, los datos se mezclarán y causarás errores graves. Usa siempre una base de datos exclusiva por tienda.

¿Qué hago si olvidé la contraseña de la base de datos?
No la puedes recuperar, pero sí restablecer. Ve a tu panel de control (cPanel, Plesk o DirectAdmin), busca la opción de "Cambiar contraseña" del usuario de la base de datos, y luego actualiza el archivo parameters.php o el instalador con la nueva contraseña.

¿Por qué me sale "Fallo al conectar con la base de datos" al instalar?
Revisa los 4 puntos clave: el host, el nombre de la base de datos, el usuario y la contraseña. El error más común es escribir mal el nombre completo, que incluye el prefijo del usuario del hosting.

¿Es lo mismo conectar MySQL en cPanel que en Plesk?
El proceso de creación es diferente, pero el resultado es el mismo: obtienes un nombre, un usuario y una contraseña. La forma de introducirlos en PrestaShop es idéntica. Solo cambia la interfaz del panel.

[INFO]: Para Syspanel (anteriormente conocido como HestiaCP), el proceso es similar a los demás. Debes crear la base de datos y el usuario desde el panel, y luego usar esos datos en PrestaShop. Recuerda que el acceso a Syspanel se realiza a través del puerto 2106 (ej. tudominio.com:2106), y la gestión de bases de datos se encuentra en la sección "Bases de datos".

Consejos finales para una conexión exitosa

Paciencia: No te saltes pasos. Verifica cada dato dos veces.
Seguridad: Usa contraseñas largas y únicas. Una base de datos comprometida significa una tienda comprometida.
Backups: Antes de tocar cualquier cosa relacionada con la base de datos (especialmente en migraciones), haz una copia de seguridad completa.
Registros: Si tienes acceso al panel de control del servidor, revisa los logs de errores de MySQL. Te darán pistas exactas sobre qué falla.

Conectar MySQL a PrestaShop no tiene que ser una pesadilla. Siguiendo esta guía para cPanel, Plesk y DirectAdmin, tendrás tu tienda online funcionando en cuestión de minutos. Si te encuentras con un error, vuelve a esta guía, respira hondo y repasa los pasos de solución de problemas. ¡Tu tienda online te lo agradecerá!