Conectar PrestaShop a MySQL | Configurar Parámetros

¿Por qué PrestaShop necesita una base de datos MySQL?

Cuando instalas PrestaShop, no solo estás colocando archivos en tu servidor. La tienda online necesita un lugar donde guardar cada producto, cada pedido, cada cliente y cada configuración. Ese lugar es la base de datos MySQL. Sin ella, tu tienda sería como un escaparate vacío: se vería la fachada, pero no habría nada dentro.

Piensa en la base de datos como el cerebro de tu PrestaShop. Los archivos del programa (PHP, plantillas, imágenes) son el cuerpo, pero la información de tu negocio vive en las tablas MySQL. Por eso, cuando migras tu tienda o cambias de hosting, uno de los pasos más críticos es asegurarte de que PrestaShop sepa exactamente dónde y cómo conectarse a esa base de datos.

En este artículo te voy a explicar, paso a paso y sin tecnicismos innecesarios, cómo conectar PrestaShop a una base de datos MySQL tanto si usas Plesk como cPanel. También veremos el archivo clave que hace posible esta conexión: el famoso settings.inc.php.

Antes de empezar: ¿Qué necesitas tener a mano?

Para conectar PrestaShop a MySQL, necesitas cuatro datos básicos. Son como las coordenadas GPS de tu base de datos:

Nombre de la base de datos (ejemplo: tienda_prestashop)
Usuario de la base de datos (ejemplo: admin_tienda)
Contraseña del usuario (la que definiste al crear el usuario)
Host o servidor de la base de datos (normalmente localhost, pero a veces es algo como mysql.tudominio.com)

Estos datos los puedes obtener desde el panel de control de tu hosting. En Plesk o cPanel, el proceso es bastante visual y no necesitas tocar código hasta el final.

[INFO] Si vas a conectar una PrestaShop recién instalada, el propio instalador te pedirá estos datos. Pero si ya tienes la tienda creada y necesitas cambiar la conexión (por ejemplo, tras una migración), tendrás que editar el archivo settings.inc.php.

Método 1: Conectar PrestaShop a MySQL con Plesk

Plesk es un panel de control muy popular en servidores dedicados y VPS. Su interfaz es limpia y organiza las bases de datos de forma clara. Vamos a ello.

Paso 1: Crear la base de datos en Plesk

Inicia sesión en Plesk con tu usuario administrador.
En el menú lateral, busca la sección Bases de datos (puede estar dentro de "Sitios web y dominios").
Haz clic en Agregar base de datos.
Rellena el nombre de la base de datos (por ejemplo, prestashop_db).
Elige el tipo de base de datos: selecciona MySQL (o MySQL/MariaDB, según la versión).
En el campo de usuario, puedes crear uno nuevo o usar uno existente. Te recomiendo crear uno específico para PrestaShop, así no mezclas permisos con otras aplicaciones.
Define una contraseña segura y guárdala en un lugar seguro (la necesitarás más adelante).
Haz clic en Aceptar o Crear.

Plesk te mostrará un resumen con el nombre de la base de datos, el usuario y el host. Anota estos datos.

[TIP] En Plesk, el host de la base de datos suele ser localhost. Pero si tu servidor usa conexiones remotas, puede aparecer como localhost:3306 o una IP específica. No te preocupes, el propio panel te lo indica.

Paso 2: Localizar y editar `settings.inc.php` en Plesk

El archivo settings.inc.php es el corazón de la conexión. Se encuentra en la carpeta config de tu instalación de PrestaShop. La ruta típica es:

/public_html/config/settings.inc.php

Ve a Sitios web y dominios en Plesk.
Localiza tu dominio y haz clic en Administrador de archivos (o "File Manager").
Navega hasta la carpeta config dentro de tu directorio raíz (normalmente httpdocs o public_html).
Busca el archivo settings.inc.php. Haz clic derecho sobre él y selecciona Editar (o "Edit in Text Editor").
Verás un bloque de código PHP con definiciones constantes. Busca estas líneas:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_base_datos');
define('_DB_USER_', 'usuario_base_datos');
define('_DB_PASSWD_', 'contraseña_base_datos');

Sustituye los valores entre comillas por los datos de tu base de datos de Plesk.
Guarda los cambios y cierra el editor.

[WARNING] Antes de editar settings.inc.php, haz una copia de seguridad del archivo original. Si algo falla, puedes restaurarlo rápidamente.

Paso 3: Probar la conexión

Después de guardar, intenta acceder a tu tienda en el navegador. Si la conexión es correcta, verás tu PrestaShop funcionando. Si aparece un error de conexión a la base de datos, revisa que no haya espacios extra en los valores, que la contraseña sea exacta y que el host sea el correcto.

Método 2: Conectar PrestaShop a MySQL con cPanel

cPanel es el panel más común en hosting compartido. Su flujo de trabajo es similar, pero con algunos matices. Vamos a por ello.

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

Entra en cPanel con tus credenciales.
Busca la sección Bases de datos y haz clic en Asistente para bases de datos MySQL (o "MySQL Database Wizard").
En el primer paso, escribe el nombre de la base de datos. cPanel suele añadir un prefijo con tu usuario (ejemplo: usuario_prestashop). Anota el nombre completo.
Haz clic en Crear base de datos.
En el siguiente paso, crea un usuario para esa base de datos. Introduce un nombre de usuario y una contraseña segura.
Haz clic en Crear usuario.
Ahora te pedirá asignar privilegios al usuario. Marca la opción TODOS LOS PRIVILEGIOS y haz clic en Realizar cambios.

[INFO] En cPanel, el host de la base de datos casi siempre es localhost. Pero en algunos planes de hosting, puede ser algo como mysql.tudominio.com. Puedes verlo en la sección "Bases de datos MySQL" de cPanel.

Paso 2: Editar `settings.inc.php` desde el administrador de archivos de cPanel

En cPanel, ve al Administrador de archivos (File Manager).
Navega hasta public_html (o la carpeta donde esté instalada tu PrestaShop).
Entra en la carpeta config.
Busca settings.inc.php. Haz clic derecho y elige Editar (o "Edit").
Localiza las líneas de configuración:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_base_de_datos');
define('_DB_USER_', 'tu_usuario');
define('_DB_PASSWD_', 'tu_contraseña');

Rellena con los datos que creaste en el paso 1. Recuerda que el nombre de la base de datos y el usuario incluyen el prefijo de cPanel (por ejemplo, usuario_prestashop).
Guarda los cambios.

Paso 3: Verificar que todo funciona

Abre tu tienda en el navegador. Si ves la página principal, ¡enhorabuena! La conexión está activa. Si aparece un error tipo "Error de conexión con la base de datos", revisa los valores. Un error común es olvidar el prefijo del usuario o la base de datos en cPanel.

El archivo `settings.inc.php`: Tu mejor amigo y tu peor pesadilla

Este archivo es tan importante que merece un apartado propio. En PrestaShop 1.6 y versiones anteriores, settings.inc.php es el encargado de definir todas las constantes de conexión. En PrestaShop 1.7 y superiores, la configuración se movió a un archivo llamado parameters.php dentro de la carpeta app/config, pero la lógica es la misma.

Si tu PrestaShop es moderna (1.7+), no busques settings.inc.php porque no existe. Busca parameters.php. El contenido es similar:

'database_host' => 'localhost',
'database_name' => 'prestashop_db',
'database_user' => 'usuario_db',
'database_password' => 'contraseña_db',

[TIP] Si no sabes qué versión de PrestaShop tienes, mira la carpeta raíz. Si ves la carpeta app, es 1.7 o superior. Si solo ves config y tools, es 1.6 o anterior.

Errores comunes y cómo solucionarlos

Conectar PrestaShop a MySQL no siempre es un camino de rosas. Aquí tienes los problemas más frecuentes y su solución:

Error: "Link to database cannot be established"

Este es el error más típico. Significa que PrestaShop no encuentra o no puede autenticarse en la base de datos. Revisa:

Que el nombre de la base de datos sea exacto (incluyendo prefijos).
Que el usuario y la contraseña sean correctos.
Que el host sea localhost salvo que tu hosting indique lo contrario.

Error: "Access denied for user"

El usuario no tiene permisos suficientes. Ve a tu panel (Plesk o cPanel) y asegúrate de que el usuario tiene todos los privilegios sobre la base de datos. A veces hay que asignarlos manualmente.

Error: "Unknown database"

El nombre de la base de datos está mal escrito o no existe. Comprueba en tu panel que la base de datos se creó correctamente.

Error: "Cannot connect to MySQL server"

El servidor MySQL no está disponible o el host es incorrecto. Si tu hosting usa un host remoto, asegúrate de que el puerto (normalmente 3306) está abierto.

Buenas prácticas para tu conexión PrestaShop MySQL

Para terminar, te dejo algunos consejos que te ahorrarán dolores de cabeza:

Usa contraseñas fuertes para el usuario de la base de datos. No uses "admin123" ni cosas obvias.
No compartas el usuario de la base de datos con otras aplicaciones. Crea uno específico para PrestaShop.
Haz copias de seguridad periódicas de tu base de datos. Puedes hacerlo desde Plesk o cPanel con un clic.
Si migras tu tienda, exporta la base de datos antigua e impórtala en la nueva antes de cambiar la configuración.
Mantén actualizado tu PrestaShop. Las versiones antiguas tienen vulnerabilidades que pueden comprometer tu base de datos.

[WARNING] Nunca edites settings.inc.php o parameters.php mientras tu tienda está en producción sin antes hacer una copia de seguridad. Un error de tipeo puede dejar tu tienda caída.

Preguntas frecuentes (FAQ)

¿Puedo conectar PrestaShop a una base de datos MySQL que no esté en el mismo servidor?

Sí, pero debes asegurarte de que el host remoto permita conexiones externas. En la mayoría de los hosting compartidos, esto no está permitido por seguridad. En servidores VPS dedicados, puedes configurarlo.

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

Tienes que actualizar el archivo de configuración (settings.inc.php o parameters.php) con la nueva contraseña. Si no lo haces, PrestaShop no podrá conectarse.

¿Puedo usar MariaDB en lugar de MySQL?

Sí, PrestaShop es compatible con MariaDB sin problemas. De hecho, muchos hosting usan MariaDB como motor por defecto. El proceso de conexión es idéntico.

¿Necesito conocimientos avanzados para hacer esto?

No. Con los pasos que te he dado, cualquier persona puede conectar PrestaShop a MySQL en Plesk o cPanel. Solo necesitas paciencia y seguir las instrucciones al pie de la letra.

¿Por qué mi PrestaShop no se conecta después de editar el archivo?

Revisa que no hayas dejado espacios en blanco alrededor de los valores, que las comillas estén bien cerradas y que el archivo no tenga errores de sintaxis. Un simple espacio extra puede romper la conexión.

Resumen final

Conectar PrestaShop a una base de datos MySQL es un proceso sencillo si sabes dónde mirar. Tanto en Plesk como en cPanel, la clave está en crear correctamente la base de datos y el usuario, y luego trasladar esos datos al archivo de configuración de tu tienda. Ya sea settings.inc.php para versiones antiguas o parameters.php para las modernas, la lógica es siempre la misma: indicarle a PrestaShop dónde vive su información.

Recuerda: la base de datos es el alma de tu tienda. Cuídala, haz copias de seguridad y no compartas credenciales. Con estos pasos, tendrás tu PrestaShop conectado y funcionando en menos de lo que tardas en tomarte un café.

Si has seguido todos los pasos y sigues teniendo problemas, no dudes en contactar con tu proveedor de hosting. Ellos conocen su infraestructura y pueden ayudarte a resolver cualquier incidencia con la conexión MySQL.