Conectar PrestaShop a MySQL: Configuración de Parámetros de BD

¿Te has encontrado con el temido prestashop error base datos justo después de intentar instalar tu tienda o al migrarla a un nuevo servidor? No te preocupes, es una de las situaciones más comunes al trabajar con esta plataforma. La buena noticia es que la solución, en la gran mayoría de los casos, pasa por entender y configurar correctamente un único archivo y, por supuesto, tener claros los datos de tu servidor MySQL.

Conectar PrestaShop a una base de datos MySQL no es magia negra, pero requiere precisión. Es como darle a tu tienda una dirección exacta donde guardar todos sus productos, pedidos y clientes. Si esa dirección está mal escrita, la tienda no encuentra su "casa" y se bloquea. En esta guía extensa y paso a paso, te voy a explicar exactamente cómo hacerlo, desde cero y sin tecnicismos innecesarios. Vamos a desglosar todo el proceso para que lo hagas tú mismo, con confianza y sin depender de un desarrollador.

Entendiendo la Relación: PrestaShop y MySQL

Antes de ensuciarnos las manos con código y archivos, es fundamental que entiendas qué es cada pieza del puzzle. PrestaShop es un software que gestiona tu tienda, pero no guarda la información "en su cabeza". Toda esa información (catálogo, precios, pedidos, contraseñas de clientes) vive en una base de datos MySQL. Piensa en ello como una gran biblioteca (MySQL) y PrestaShop como el bibliotecario que necesita la llave y el mapa para encontrar los libros.

Cuando hablamos de la prestashop mysql conexion, nos referimos al puente que une a estas dos partes. Este puente se construye con cuatro datos fundamentales:

Dirección del servidor (Host): Normalmente localhost o 127.0.0.1 si tu tienda y tu base de datos están en el mismo servidor. Si es un servidor externo, será una IP o un nombre como db.midominio.com.
Nombre de la base de datos: El nombre único que le pusiste a tu base de datos en tu panel de control (cPanel, Syspanel, etc.).
Usuario de la base de datos: Un usuario con permisos para leer y escribir en esa base de datos.
Contraseña del usuario: La contraseña asociada a ese usuario.

Si falla cualquiera de estos cuatro puntos, la conexión se rompe y verás errores en pantalla. El objetivo de esta guía es que sepas exactamente dónde encontrar esos datos y cómo introducirlos correctamente.

El Archivo Mágico: `parameters.php` de PrestaShop

PrestaShop guarda todos los datos de configuración de la conexión en un archivo específico. Dependiendo de la versión que uses, se llama parameters.php o settings.inc.php (para versiones antiguas como 1.6 o anteriores). Este archivo es el corazón de la configuración técnica de tu tienda.

¿Dónde se encuentra?

La ruta típica es dentro de la carpeta app/config/ de tu instalación de PrestaShop. La estructura completa se vería así:

/public_html/app/config/parameters.php

O si tu tienda está en una subcarpeta:

/public_html/tutienda/app/config/parameters.php

[INFO] Si tu instalación es muy antigua (PrestaShop 1.6 o anterior), el archivo se llamará settings.inc.php y estará en la carpeta config/ en la raíz de tu tienda. Los principios son los mismos, solo cambia el nombre del archivo.

Editando el archivo `parameters.php`

Para conectar PrestaShop a tu base de datos, tienes que abrir este archivo con un editor de texto plano. No uses Word ni programas similares, ya que pueden añadir caracteres extraños. Te recomiendo usar el editor de código de tu panel de control (como el "Administrador de archivos" de cPanel o Syspanel) o un programa como Notepad++ si lo descargas a tu ordenador.

Una vez abierto, verás un array de PHP. No te asustes con el código; solo nos interesan unas líneas específicas que empiezan con 'database_*'. Deberías ver algo similar a esto:

'database_host' => 'localhost',
'database_name' => 'tu_base_de_datos',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña',
'database_port' => '3306',

Aquí es donde se produce el 90% de los errores de prestashop error base datos. Asegúrate de que cada valor esté entre comillas simples y no tenga espacios extra. Vamos a revisarlos uno a uno:

database_host: Es la dirección del servidor MySQL. Lo más común es localhost. Si tu hosting usa un servidor de bases de datos externo, te lo habrán proporcionado. Es crucial que lo escribas exactamente como te lo dieron.
database_name: Este es el nombre exacto de tu base de datos. A menudo, en paneles como cPanel o Syspanel, el nombre lleva un prefijo con el nombre de tu usuario, por ejemplo usuario_prestashop. Debes copiarlo tal cual.
database_user: El nombre de usuario de la base de datos. También puede llevar un prefijo. Es el usuario que tiene permisos sobre la base de datos que indicaste arriba.
database_password: La contraseña de ese usuario. Es sensible a mayúsculas y minúsculas, así que asegúrate de que la teclas correctamente. Si la has olvidado, tendrás que resetearla desde tu panel de control.
database_port: El puerto por defecto de MySQL es el 3306. En la mayoría de los casos no tendrás que tocarlo. Solo cámbialo si tu proveedor de hosting te indica expresamente que uses otro.

[WARNING] Ten muchísimo cuidado al editar este archivo. Un simple error de sintaxis (una coma fuera de lugar, una comilla sin cerrar) puede provocar que tu tienda muestre una página en blanco. Si no estás seguro, haz una copia de seguridad del archivo antes de editarlo.

Guía Paso a Paso: Cómo Conectar PrestaShop a tu Base de Datos

Ahora que ya sabes qué es cada cosa y dónde está el archivo, vamos a ponernos manos a la obra. Te voy a guiar a través del proceso completo, tanto para una instalación nueva como para arreglar una conexión que ha fallado.

Paso 1: Localizar y Preparar los Datos de tu Base de Datos MySQL

Lo primero es tener a mano las credenciales. Si no las tienes, tienes que crearlas o encontrarlas en tu panel de control de hosting.

Accede a tu panel de control: Esto puede ser cPanel, Plesk, Syspanel o el panel que use tu proveedor. Si usas Syspanel, recuerda que el acceso se realiza a través del puerto 2106.
Busca la sección de Bases de Datos: En cPanel suele llamarse "MySQL Databases", en Syspanel "Bases de Datos" o similar.
Verifica o crea la base de datos:
- Si ya tienes una base de datos creada para tu tienda, anota su nombre exacto.
- Si no la tienes, créala. También necesitarás un usuario y asignarle todos los privilegios sobre esa base de datos. Anota el nombre de usuario y la contraseña que elijas.

Paso 2: Editar el Archivo `parameters.php` o `settings.inc.php`

Este paso es igual tanto para una instalación nueva como para arreglar una existente.

Navega hasta la carpeta de tu tienda: Usa el administrador de archivos de tu panel de control o un cliente FTP como FileZilla.
Ve a la ruta correcta: Como mencionamos, busca app/config/parameters.php (o config/settings.inc.php en versiones antiguas).
Descarga y edita el archivo: Descárgalo a tu ordenador y ábrelo con Notepad++ o Sublime Text. También puedes usar el editor de texto integrado en el administrador de archivos de tu hosting.
Sustituye los valores: Cambia los valores de database_host, database_name, database_user y database_password con los datos que has recopilado en el Paso 1.

Paso 3: Subir el Archivo Modificado

Una vez guardados los cambios en tu editor de texto, tienes que subir el archivo de vuelta a su ubicación original, sobrescribiendo el que había.

Sube el archivo: Si lo editaste localmente, súbelo por FTP o a través del administrador de archivos. Asegúrate de que se sube a la misma ruta exacta.
Verifica los permisos: El archivo parameters.php debe tener permisos de lectura para el servidor web. Normalmente, los permisos 644 son los correctos. Si ves un error de permisos, cámbialos desde el administrador de archivos.

Paso 4: Probar la Conexión y Solucionar Problemas Comunes

Ahora viene el momento de la verdad. Intenta acceder a tu tienda (tanto al front-office como al back-office, /admin).

Si la tienda carga correctamente: ¡Enhorabuena! Has conseguido conectar PrestaShop a tu base de datos.
Si sigues viendo el error: No te frustres. Vamos a repasar los puntos más comunes que causan el prestashop error base datos.

Error de "Acceso denegado para el usuario"

Este error suele indicar que el usuario o la contraseña son incorrectos.

Solución: Revisa que no haya espacios en blanco al principio o final de la contraseña y el usuario. Asegúrate de que el usuario tiene todos los privilegios sobre la base de datos correcta. En ocasiones, el usuario es usuario_bd y la base de datos usuario_prestashop, y el usuario solo tiene permisos sobre esa base de datos en concreto.

Error de "Base de datos no encontrada"

Este error significa que el nombre de la base de datos no existe o está mal escrito.

Solución: Vuelve a tu panel de control y verifica el nombre exacto de la base de datos. Es fácil confundirse con los prefijos.

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

Este error es más genérico y puede deberse a varias razones.

Solución: Primero, verifica que el database_host es correcto. Si usas localhost y tu base de datos está en un servidor externo, fallará. Prueba con la IP del servidor de bases de datos. También puede ser que el servidor MySQL esté caído o que el puerto sea diferente. Algunos hosts usan puertos como 3307 o 3308.

[TIP] Si tu proveedor de hosting usa Syspanel, a menudo puedes encontrar los datos de conexión a la base de datos directamente en la sección de "Bases de Datos" de tu panel. Busca un botón que diga "Detalles de conexión" o similar. Esto te ahorrará muchos quebraderos de cabeza.

Configurar PrestaShop MySQL Durante la Instalación

Si estás instalando PrestaShop desde cero, el proceso es mucho más visual y guiado. Te lo resumo para que no te pierdas.

Llega al paso de "Base de datos": Durante el asistente de instalación, después de aceptar la licencia y revisar los requisitos del sistema, llegarás a un paso llamado "Base de datos".
Rellena los campos: Te pedirá exactamente los mismos datos que hemos visto en el archivo parameters.php (host, nombre, usuario, contraseña, puerto). También te pedirá un "Prefijo de tabla". El valor por defecto es ps_ y es recomendable dejarlo así, aunque puedes cambiarlo por seguridad.
Haz clic en "Probar tu conexión": El instalador verificará si los datos son correctos. Si lo son, continuará con la instalación. Si no, te mostrará un mensaje de error indicando qué está fallando.

Preguntas Frecuentes (FAQ) sobre la Conexión a MySQL

Aquí tienes algunas de las dudas más habituales que resuelvo a diario sobre este tema. Seguro que alguna te suena.

¿Qué hago si he olvidado mi contraseña de MySQL?

No puedes recuperarla, pero puedes resetearla. Accede a tu panel de control (cPanel, Syspanel, etc.), ve a la sección de bases de datos MySQL y busca la opción de "Cambiar contraseña" para el usuario que necesites. Una vez cambiada, actualiza el archivo parameters.php con la nueva contraseña.

¿Es lo mismo "localhost" que "127.0.0.1"?

En el 99% de los casos, sí. localhost es un alias de 127.0.0.1. Si uno no te funciona, prueba con el otro. Es una de las soluciones más simples para un prestashop error base datos persistente.

¿Puedo usar la misma base de datos para dos instalaciones de PrestaShop?

Técnicamente sí, pero es una pésima idea. Los prefijos de tabla (ps_, ps2_) pueden evitar conflictos, pero es muy arriesgado. Es mucho más seguro y limpio usar una base de datos separada para cada instalación. Así evitas corromper datos si algo falla.

He cambiado la contraseña de mi base de datos y ahora mi tienda da error. ¿Qué hago?

Es completamente normal. Acabas de "romper" el puente. Solo tienes que editar el archivo parameters.php (o settings.inc.php) y actualizar el campo database_password con la nueva contraseña. Guarda los cambios y listo.

¿Por qué mi tienda da error al conectar solo a veces?

Esto puede deberse a que tu servidor de bases de datos está sobrecargado o alcanzando su límite de conexiones. También puede ser un problema de tu proveedor de hosting. Te recomiendo contactar con su soporte técnico para que revisen el estado del servidor MySQL.

Conclusión: Domina la Configuración de tu Base de Datos

Conectar PrestaShop a una base de datos MySQL es una habilidad fundamental para cualquier propietario de una tienda online. No es necesario ser un experto en programación, solo entender qué datos necesitas y dónde colocarlos. Hemos visto que el archivo parameters.php es el centro de operaciones de esta conexión y que la precisión en los datos es la clave del éxito.

Recuerda siempre estos puntos clave:

Precisión ante todo: Un carácter mal escrito en el nombre de la base de datos o en la contraseña es la causa más común de error.
Los prefijos importan: En muchos paneles de control, el nombre de la base de datos y el usuario llevan un prefijo con tu nombre de usuario. No lo omitas.
localhost no es universal: Si tu base de datos está en otro servidor, tendrás que usar la IP o el nombre del servidor que te proporcione tu hosting.
Haz copias de seguridad: Antes de tocar cualquier archivo de configuración, asegúrate de tener una copia de seguridad. Te salvará de más de un susto.

Espero que esta guía te haya sido de gran ayuda. La próxima vez que veas un mensaje de error relacionado con la base de datos, ya sabrás exactamente dónde mirar y qué hacer. Respira hondo, localiza tu archivo parameters.php y verifica los datos. En la mayoría de los casos, la solución está a un solo paso. ¡Mucha suerte con tu tienda online!