PrestaShop: Configurar la conexión a la base de datos (MySQL)

Introducción: ¿Por qué PrestaShop necesita una base de datos?

Piensa en PrestaShop como una tienda física. Los estantes, la caja registradora y los productos son la parte visible. Pero necesitas un almacén detrás para guardar el inventario, los precios, los datos de clientes y las facturas. En el mundo digital, ese almacén es la base de datos MySQL.

Cuando instalas PrestaShop, el sistema necesita comunicarse con ese almacén para funcionar. Si la conexión falla, tu tienda no cargará o mostrará errores. Por eso, entender cómo conectar PrestaShop a su base de datos es una habilidad básica que todo administrador debería dominar, aunque no sea un experto técnico.

En esta guía para principiantes, te explicaré paso a paso qué necesitas, cómo encontrar los datos de conexión y cómo solucionar los errores más comunes. No necesitas saber programación, solo seguir las instrucciones con calma.

¿Qué necesitas antes de empezar?

Antes de lanzarte a configurar nada, reúne estos tres elementos. Sin ellos, es imposible establecer la conexión.

Los datos de acceso a tu base de datos: Nombre de la base, usuario y contraseña.
El nombre del servidor MySQL: Generalmente es localhost, pero puede variar si usas un hosting externo.
Acceso al panel de control de tu hosting: Como cPanel, Plesk, o el panel que te ofrezca tu proveedor (por ejemplo, Syspanel, que se accede por el puerto 2106).

Si acabas de contratar un hosting, muchos proveedores crean la base de datos automáticamente. Si no, tendrás que crearla desde el panel. No te preocupes, te muestro cómo.

Paso 1: Encontrar o crear tu base de datos MySQL

Lo primero es asegurarte de que tienes una base de datos creada. Si el instalador de PrestaShop no te dejó avanzar, es porque no existe o los datos son incorrectos.

Opción A: Usar una base de datos existente

Si ya tienes una base creada (quizás para otra aplicación), busca su nombre y usuario. Normalmente, en los paneles de control verás una sección llamada "Bases de Datos MySQL" o similar.

Opción B: Crear una nueva base de datos

Si no tienes una, créala. Es un proceso de 2 minutos.

Accede a tu panel de control de hosting.
Busca la sección "Bases de datos MySQL" o "MySQL Databases".
Escribe un nombre para tu base (ej. tienda_prestashop).
Crea un usuario y una contraseña segura para esa base.
IMPORTANTE: Asigna todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.) a ese usuario sobre esa base. Sin privilegios, PrestaShop no podrá leer ni escribir datos.

[INFO] En algunos paneles como Syspanel (accesible en el puerto 2106), el nombre de la base y el usuario suelen llevar un prefijo con tu cuenta de hosting (ej. usuario_tienda). Asegúrate de copiar el nombre completo.

Paso 2: Localizar los parámetros de conexión de PrestaShop

Ahora viene la parte clave. PrestaShop guarda la configuración de conexión en un archivo llamado parameters.php. Este archivo se encuentra en la carpeta app/config de tu instalación.

¿Por qué es importante? Porque si ya tienes PrestaShop instalado pero cambiaste la contraseña de MySQL o moviste el sitio, tendrás que editar este archivo manualmente.

¿Cómo editar el archivo parameters.php?

Conéctate a tu servidor mediante FTP (FileZilla es una buena opción) o usa el "Administrador de archivos" de tu panel de hosting.
Navega hasta tu-dominio.com/app/config/.
Busca el archivo parameters.php.
Ábrelo con un editor de texto (como Bloc de Notas o Visual Studio Code).

Verás un código similar a este (no te asustes, solo nos interesan 4 líneas):

'database_host' => 'localhost',
'database_name' => 'nombre_de_tu_base',
'database_user' => 'usuario_de_tu_base',
'database_password' => 'tu_contraseña_secreta',

Estos son los parámetros de conexión PrestaShop. Cópialos tal cual, porque los necesitarás en el siguiente paso.

[WARNING] Ten mucho cuidado al editar este archivo. Un error de sintaxis (una comilla mal puesta, un punto y coma olvidado) puede romper tu tienda. Si no estás seguro, haz una copia de seguridad del archivo antes de tocarlo.

Paso 3: Configurar la conexión durante la instalación

Si es tu primera vez instalando PrestaShop, el proceso es más guiado. Llegará un punto en el asistente donde te pedirá los datos de la base de datos.

Este es el momento de usar los datos que recopilaste en el paso anterior.

Pantalla de configuración de la base de datos

Motor de base de datos: Deja "MySQL" o "MariaDB" (es lo mismo para nosotros).
Dirección del servidor: Aquí es donde la gente se confunde. Si tu hosting es compartido, suele ser localhost. Si tu base de datos está en un servidor externo, te lo indicará tu proveedor (ej. mysql.tudominio.com).
Nombre de la base de datos: Escribe exactamente el nombre que ves en tu panel (ej. usuario_tienda).
Usuario de la base de datos: Igual que arriba, con el prefijo si lo tiene.
Contraseña: La que definiste al crear el usuario.
Prefijo de las tablas: Puedes dejarlo como ps_. Solo cámbialo si sabes lo que haces (por ejemplo, para tener dos tiendas en la misma base).

Pulsa "Siguiente" y PrestaShop intentará conectar.

[TIP] Si el asistente se queda cargando mucho tiempo, revisa que el servidor de la base de datos no esté bloqueado por un firewall. A veces, el hosting bloquea conexiones externas a MySQL por seguridad.

Paso 4: Solucionar el error de conexión más común

El error más típico al configurar base de datos PrestaShop es: "No se puede conectar a la base de datos" o "Error al conectar con MySQL". No entres en pánico. Es casi siempre un problema de datos mal escritos.

Aquí tienes una lista de verificación rápida:

¿El servidor es correcto? Prueba con localhost primero. Si no funciona, contacta a tu proveedor para obtener el hostname exacto.
¿El usuario tiene permisos? A veces el usuario existe, pero no tiene permisos sobre la base de datos. Ve a tu panel y verifica que tenga "Todos los privilegios".
¿La contraseña tiene caracteres especiales? Si tu contraseña tiene símbolos como @, #, $, asegúrate de que el archivo parameters.php la esté interpretando bien. En PHP, a veces hay que "escapar" estos caracteres con una barra invertida (\).
¿El nombre de la base es exacto? Las bases de datos en hosting suelen tener un prefijo. Si tu panel dice juan123_tienda, no escribas solo tienda.

Si el error persiste, prueba esto:

Conéctate a phpMyAdmin (desde tu panel de control) con los mismos datos que estás usando en PrestaShop. Si phpMyAdmin te deja entrar, el problema está en PrestaShop. Si no te deja, el problema está en los datos de tu hosting.

[WARNING] Si cambias la contraseña de MySQL desde el panel, PrestaShop dejará de funcionar automáticamente. Deberás actualizar el parámetro database_password en el archivo parameters.php para restablecer la conexión.

Paso 5: Probar la conexión sin instalar todo de nuevo

¿Ya tienes PrestaShop instalado y solo cambiaste de servidor? No necesitas reinstalar. Solo edita el archivo parameters.php que vimos antes.

Procedimiento para cambiar la conexión manualmente

Descarga el archivo parameters.php por FTP.
Ábrelo con un editor avanzado (como Notepad++).
Reemplaza los valores de database_host, database_name, database_user y database_password con los nuevos.
Guarda el archivo y súbelo de nuevo a la misma carpeta (app/config), sobrescribiendo el anterior.

Después de subirlo, carga tu tienda. Debería funcionar sin más trámites.

[INFO] Si tu tienda usa caché, es posible que necesites borrar la carpeta var/cache (o app/cache en versiones antiguas). Esto fuerza a PrestaShop a leer la nueva configuración. Puedes borrar los archivos de esa carpeta sin miedo, se regenerarán solos.

Paso 6: Configurar la conexión para entornos de desarrollo (opcional)

Si estás trabajando en una copia local (con XAMPP o WAMP) y luego subes la tienda a un servidor real, te enfrentarás a un problema: los datos de conexión son diferentes.

Una buena práctica es usar variables de entorno, pero eso es más avanzado. Para principiantes, lo más fácil es:

Tener una copia del archivo parameters.php para tu entorno local (con localhost).
Tener otra copia para el servidor real.
Al subir o bajar archivos, usar el archivo correspondiente.

No es elegante, pero funciona perfectamente y evita errores.

Preguntas frecuentes (FAQ) sobre la conexión a la base de datos

¿Qué es `localhost` exactamente?

Es la dirección del servidor cuando la base de datos está en la misma máquina que tu sitio web. Es el valor más común en hosting compartidos.

¿Puedo usar una base de datos de otro proveedor (como AWS RDS)?

Sí, PrestaShop no le importa dónde esté la base. Solo necesitas el hostname correcto, el puerto (si no es el 3306) y los datos de acceso. Eso sí, asegúrate de que el puerto 3306 esté abierto en el firewall del servidor de la base de datos.

¿Qué pasa si pongo mal el prefijo de las tablas?

No pasa nada grave. Solo significa que PrestaShop creará tablas con ese prefijo. Si lo cambias a mitad de camino, perderás el rastro de las tablas antiguas. Es mejor no tocarlo.

¿Cómo sé si mi hosting usa Syspanel?

Syspanel es un panel de control de hosting popular. Si tu proveedor te dio un enlace de acceso como http://tu-dominio.com:2106 o http://IP_del_servidor:2106, estás usando Syspanel. Ahí encontrarás la sección de bases de datos MySQL.

[TIP] Si usas Syspanel, recuerda que el puerto de acceso es el 2106. No el 2083 (cPanel) ni el 8443 (Plesk). Es un detalle que suele olvidarse.

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

Eso significa que PrestaShop no se ha instalado correctamente. La instalación se quedó a medias. La solución más fácil es borrar la carpeta de PrestaShop y volver a subir todos los archivos desde cero. Es un proceso más largo, pero garantiza un estado limpio.

Consejos finales para evitar dolores de cabeza

Siempre haz una copia de seguridad de parameters.php antes de editarlo. Guárdalo en tu PC con un nombre como parameters.php.bak.
No uses contraseñas muy complejas con caracteres que luego sean difíciles de copiar. Una contraseña alfanumérica larga es más segura y menos propensa a errores de escape.
Si tu hosting te lo permite, crea un usuario específico para PrestaShop en lugar de usar el usuario raíz. Es más seguro y si algo falla, limitas el daño.
Lee los mensajes de error con calma. PrestaShop es bastante claro. Si dice "acceso denegado para el usuario", el problema es de credenciales. Si dice "host no encontrado", el problema es de red.

Conclusión: La conexión es la base de todo

Conectar PrestaShop a su base de datos no tiene por qué ser una pesadilla. Es un proceso mecánico: tener los datos correctos, saber dónde ponerlos y, si falla, verificar uno por uno los parámetros de conexión PrestaShop.

Recuerda la frase clave: los errores de conexión son casi siempre un problema de datos mal escritos o falta de permisos. No es un fallo de tu tienda ni de PrestaShop.

Con esta guía, ya tienes el conocimiento para afrontar el problema con seguridad. Si te ha servido, compártela con otros que estén empezando. Y si sigues atascado, no dudes en contactar con el soporte de tu hosting, pero ahora podrás darles información precisa y avanzada, lo que acelerará la solución.

¡Buena suerte con tu tienda online!