Conectar PrestaShop a MySQL | Guía Paso a Paso y Solución de Errores

Conectar PrestaShop a una base de datos MySQL es uno de los pasos más críticos durante la instalación o migración de tu tienda online. Si este proceso falla, verás el temido error de conexión a la base de datos y tu tienda no funcionará. No te preocupes, porque en esta guía te voy a explicar, paso a paso y sin tecnicismos, cómo realizar esta conexión en los tres paneles de control más comunes: Plesk, cPanel y DirectAdmin.

Vamos a desglosar todo el proceso, desde qué es un parámetro de conexión hasta cómo solucionar los errores más frecuentes. Al final, tendrás tu prestashop mysql conexión funcionando a la perfección.

¿Qué necesitas para conectar PrestaShop a MySQL?

Antes de lanzarnos a los paneles, es fundamental que entiendas los cuatro datos que PrestaShop te pedirá siempre. Son como las llaves de tu casa (la base de datos). Sin ellas, no hay entrada.

Estos datos son:

Dirección del servidor MySQL (Host): Normalmente es localhost o 127.0.0.1, pero a veces puede ser una URL externa como mysql.midominio.com.
Usuario de la base de datos: Un nombre de usuario con permisos para acceder a la base de datos.
Contraseña: La contraseña de ese usuario.
Nombre de la base de datos: El nombre exacto de la base de datos que has creado.

[WARNING] No confundas el usuario de tu panel de control (Plesk, cPanel, etc.) con el usuario de la base de datos. Son cosas totalmente distintas. El usuario de la base de datos se crea específicamente dentro del panel para gestionar una o varias bases de datos.

Crear y configurar la base de datos en cPanel

cPanel es el panel más popular en el mundo del hosting compartido. Su interfaz es bastante intuitiva, pero vamos a ir paso a paso para que no te pierdas.

Paso 1: Crear la base de datos y el usuario

Primero, entra en tu cPanel y busca la sección Bases de Datos. Dentro, encontrarás el icono "Base de Datos MySQL".

En el campo "Crear nueva base de datos", escribe un nombre (normalmente se añadirá un prefijo con tu usuario, por ejemplo, tuusuario_mitienda). Haz clic en "Crear base de datos".
Ahora, baja hasta la sección "Crear usuario de MySQL". Elige un nombre de usuario y una contraseña segura (puedes usar el generador de contraseñas del propio cPanel). Haz clic en "Crear usuario".
Por último, en la sección "Añadir usuario a la base de datos", selecciona el usuario y la base de datos que acabas de crear y haz clic en "Añadir".
Se abrirá una ventana para elegir los privilegios. Para PrestaShop, te recomiendo marcar "TODOS LOS PRIVILEGIOS" (o "ALL PRIVILEGES") y hacer clic en "Hacer cambios".

[INFO] Los privilegios son los permisos que el usuario tiene sobre la base de datos. PrestaShop necesita crear tablas, leer datos, insertar productos, etc. Por eso, lo más sencillo y seguro es darle todos los privilegios al usuario de esa base de datos.

Paso 2: Obtener los datos para la instalación

Ahora que ya tienes la base de datos creada, ya puedes usar estos datos en el instalador de PrestaShop:

Nombre de la base de datos: El que pusiste en el paso 1 (ej. tuusuario_mitienda).
Usuario: El que creaste en el paso 2 (ej. tuusuario_miusuario).
Contraseña: La que pusiste en el paso 2.
Dirección del servidor: localhost.

Con estos datos, podrás completar el asistente de instalación de PrestaShop sin problemas.

Crear y configurar la base de datos en Plesk

Plesk es otro panel muy común, especialmente en servidores VPS y dedicados. Su interfaz es más moderna, pero el proceso es igual de sencillo.

Paso 1: Crear la base de datos y el usuario

Accede a tu Plesk y busca la sección "Bases de datos" en el menú lateral. Si no la ves, puede estar dentro de "Sitios web y dominios".

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.
Verás una sección para "Crear un usuario de base de datos". Marca la casilla y escribe un nombre de usuario y una contraseña.
Haz clic en "Aceptar" o "OK".

[INFO] Plesk te permite crear el usuario y la base de datos en el mismo paso, lo cual es muy cómodo. Asegúrate de guardar bien el nombre de usuario y la contraseña, ya que solo se muestran una vez.

Paso 2: Datos para la instalación

En Plesk, la dirección del servidor MySQL suele ser localhost, pero a veces puede ser un nombre como localhost o la IP del servidor. Lo más común es que sea localhost.

Nombre de la base de datos: prestashop_db (el que pusiste).
Usuario: El que creaste en el paso anterior.
Contraseña: La contraseña que elegiste.
Dirección del servidor: localhost.

Crear y configurar la base de datos en DirectAdmin

DirectAdmin es un panel más ligero, muy popular en servidores de gama media. El proceso es muy similar a los anteriores.

Paso 1: Crear la base de datos y el usuario

Accede a tu DirectAdmin y busca la sección "MySQL Management" o "Base de datos MySQL".

Haz clic en "Crear nueva base de datos" (o "Create new database").
Introduce el "Nombre de la base de datos". DirectAdmin suele añadir un prefijo con tu usuario, así que no te sorprendas si el nombre final tiene un formato como usuario_prestashop.
En el campo "Usuario de la base de datos", escribe un nombre.
Introduce una contraseña segura.
Haz clic en "Crear" (o "Create").

[WARNING] A diferencia de cPanel, en DirectAdmin a veces no te pregunta por los privilegios. El usuario que creas suele recibir todos los privilegios automáticamente. Si no es así, busca la opción de "Editar privilegios" y marca todos.

Paso 2: Datos para la instalación

Al igual que en los otros paneles, los datos que usarás serán:

Nombre de la base de datos: El nombre que te muestra DirectAdmin (ej. usuario_prestashop).
Usuario: El que creaste.
Contraseña: La que pusiste.
Dirección del servidor: localhost.

¿Qué es parameters.php y por qué es tan importante?

Cuando PrestaShop se conecta a la base de datos, guarda esa configuración en un archivo llamado parameters.php. Este archivo se encuentra en la carpeta app/config/ de tu instalación de PrestaShop.

Localizando y editando parameters.php

Este archivo es el corazón de la conexión. Si tienes que mover tu tienda de servidor o cambiar la contraseña de la base de datos, tendrás que editarlo.

Conéctate a tu hosting por FTP o a través del administrador de archivos de tu panel.
Navega hasta la carpeta /app/config/.
Busca el archivo parameters.php.

El contenido de este archivo se ve así (simplificado):

<?php
return [
    'parameters' => [
        'database_host' => 'localhost',
        'database_port' => '',
        'database_name' => 'tu_base_de_datos',
        'database_user' => 'tu_usuario',
        'database_password' => 'tu_contraseña',
        'database_prefix' => 'ps_',
        // ... otros parámetros
    ],
];

Editando los valores de conexión

Para modificar la conexión, solo tienes que cambiar los valores de database_host, database_name, database_user y database_password. Guarda el archivo y la conexión se actualizará.

[TIP] Siempre haz una copia de seguridad de este archivo antes de editarlo. Si cometes un error, podrás restaurarlo fácilmente.

Errores comunes de conexión y cómo solucionarlos

Aunque sigas todos los pasos, a veces pueden aparecer errores. Aquí te dejo los más comunes y sus soluciones.

Error: "Link to database cannot be established"

Este es el error más genérico y frustrante. Significa que PrestaShop no puede conectarse al servidor MySQL. Las causas suelen ser:

Datos incorrectos: Revisa que has escrito correctamente el nombre de la base de datos, el usuario y la contraseña. Un simple error tipográfico puede causar este problema.
Host incorrecto: Asegúrate de que el host es localhost. Si tu hosting usa un host remoto, verifícalo en el panel de control.
El usuario no tiene privilegios: Vuelve a tu panel y asegúrate de que el usuario tiene todos los privilegios sobre la base de datos.

Error: "Access denied for user"

Este error es más específico y suele indicar que el usuario no tiene permisos o que la contraseña es incorrecta.

Contraseña incorrecta: Verifica que la contraseña es exactamente la que pusiste al crear el usuario.
Usuario no vinculado a la base de datos: En cPanel, por ejemplo, debes asegurarte de haber hecho clic en "Añadir usuario a la base de datos". En Plesk, el usuario se crea junto con la base de datos, pero en otros paneles puede ser un paso separado.

Error: "Unknown database"

Este error significa que PrestaShop no encuentra la base de datos que le has indicado.

Nombre incorrecto: Revisa el nombre exacto de la base de datos. En cPanel y DirectAdmin, suele tener un prefijo con el nombre de tu usuario.
Base de datos no creada: Asegúrate de haber creado la base de datos en tu panel antes de intentar la conexión.

Instalación de PrestaShop: Paso a paso con MySQL

Ahora que ya sabes cómo crear la base de datos y el usuario, vamos a ver cómo se integra esto en el asistente de instalación de PrestaShop.

Descarga PrestaShop: Descarga el paquete de instalación desde la web oficial y súbelo a tu servidor.
Ejecuta el instalador: Abre tu navegador y ve a la URL donde has subido los archivos (ej. tudominio.com). Se lanzará el asistente.
Sigue los pasos: Acepta los términos, selecciona tu idioma, etc.
Configura la tienda: En la sección de "Información de la tienda", elige el nombre, la actividad, etc.
Configura la base de datos: Aquí es donde usarás los datos que has creado. Introduce:
- Dirección del servidor: localhost.
- Nombre de la base de datos: El que has creado.
- Usuario: El usuario que has creado.
- Contraseña: La contraseña del usuario.
- Prefijo de tablas: Puedes dejarlo como ps_ por defecto.
Instalar: Haz clic en "Probar la conexión" para verificar los datos. Si todo es correcto, procede con la instalación.

[INFO] Si estás usando un servidor como Syspanel (antes conocido como HestiaCP), el proceso es muy similar. Accede a tu panel a través del puerto 2106 (por ejemplo, https://tu-servidor:2106), busca la sección de bases de datos y sigue los mismos pasos que en los otros paneles. La creación de la base de datos y el usuario es análoga.

Consejos finales para una conexión exitosa

Para terminar, aquí tienes algunos consejos extra que te ahorrarán muchos quebraderos de cabeza.

Usa contraseñas seguras

Parece obvio, pero es la causa de muchos problemas de seguridad. Usa una contraseña larga y compleja para tu usuario de base de datos. No uses la misma contraseña que la de tu panel de control.

Verifica los permisos del usuario

Si tienes problemas, revisa siempre los privilegios del usuario. En cPanel, es fácil olvidar el paso de "Añadir usuario a la base de datos" y darle privilegios. En DirectAdmin, a veces hay que editarlos manualmente.

Realiza copias de seguridad

Antes de tocar cualquier cosa, especialmente el archivo parameters.php, haz una copia de seguridad. Si algo sale mal, podrás restaurar todo sin perder tiempo.

[WARNING] Si tu conexión sigue fallando después de revisar todo, prueba a cambiar el database_host de localhost a 127.0.0.1. A veces, el servidor interpreta estas direcciones de forma diferente y una de ellas puede funcionar.

Con esta guía completa, conectar tu prestashop base de datos a MySQL en cualquier panel de control será pan comido. Recuerda que la clave está en tener los datos correctos y en que el usuario tenga los permisos adecuados. ¡Buena suerte con tu tienda online!