Conectar PrestaShop a Base de Datos: Tutorial Paso a Paso

¿Qué necesitas saber antes de conectar PrestaShop a una base de datos?

Conectar tu prestashop base de datos es uno de los pasos más importantes durante la instalación o migración de tu tienda online. Si alguna vez has visto la temida pantalla de "Error de conexión a la base de datos", sabes lo frustrante que puede ser. Pero no te preocupes: en esta guía te explicaremos todo el proceso paso a paso, desde los conceptos básicos hasta la resolución de los errores más comunes.

Antes de empezar, es fundamental que entiendas qué es una base de datos y por qué PrestaShop la necesita. Piensa en ella como el almacén central donde se guardan todos los productos, pedidos, clientes, configuraciones y contraseñas de tu tienda. Sin una conexión correcta, tu tienda simplemente no puede funcionar.

Requisitos previos para la conexión

Para conectar prestashop mysql correctamente, necesitarás tener a mano los siguientes 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 hayas definido al crear el usuario)
Servidor de la base de datos (normalmente localhost o 127.0.0.1, aunque en algunos hosting puede ser un servidor remoto como mysql.tudominio.com)
Puerto (por defecto suele ser el 3306, pero algunos proveedores usan puertos personalizados)

También necesitarás acceso al panel de control de tu hosting, ya sea cPanel, Plesk, Syspanel o cualquier otro administrador de archivos.

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

Este es el primer paso y el más importante. Sin una base de datos creada previamente, no podrás completar la instalación.

Si usas cPanel

Entra en tu cPanel y busca la sección "Bases de Datos MySQL".
Haz clic en "Crear nueva base de datos" y escribe un nombre descriptivo (por ejemplo, prestashop_db).
Anota el nombre completo que te aparezca (suele tener un prefijo con tu usuario, como usuario_prestashop_db).
Ve a la sección "Usuarios MySQL" y crea un nuevo usuario con una contraseña segura.
Ahora, en "Añadir usuario a la base de datos", selecciona tu base de datos y tu usuario, y otórgale todos los privilegios.
Guarda los cambios.

Si usas Syspanel (antes HestiaCP)

Si tu hosting utiliza Syspanel, el proceso es igual de sencillo. Recuerda que el acceso a este panel se realiza a través del puerto 2106 (por ejemplo, https://tudominio.com:2106). Dentro de Syspanel:

Ve a la sección "Bases de datos" en el menú lateral.
Haz clic en "Agregar base de datos".
Introduce el nombre de la base de datos, el usuario y la contraseña.
Syspanel creará automáticamente el usuario con los privilegios necesarios.

[TIP] Elige siempre contraseñas robustas que combinen letras mayúsculas, minúsculas, números y símbolos. Una contraseña débil es la puerta de entrada para los atacantes.

Paso 2: Localizar el archivo de configuración de PrestaShop

Cuando hablamos de prestashop db config, nos referimos al archivo parameters.php que se encuentra en la carpeta app/config/ de tu instalación de PrestaShop. Este archivo contiene todos los parámetros de conexión a la base de datos.

Si estás haciendo una instalación limpia, el asistente de instalación te pedirá estos datos. Pero si ya tienes una tienda funcionando y necesitas cambiar la conexión (por ejemplo, tras migrar de servidor), tendrás que editar este archivo manualmente.

Cómo acceder al archivo parameters.php

Conéctate a tu servidor mediante FTP (FileZilla o similar) o desde el administrador de archivos de tu hosting.
Navega hasta la carpeta raíz de tu tienda (donde están las carpetas admin, app, bin, cache, etc.).
Entra en app/config/ y busca el archivo parameters.php.
Ábrelo con un editor de texto plano (no uses Word ni editores enriquecidos).

El archivo tendrá una estructura similar a esta:

return array(
    'parameters' => array(
        'database_host' => 'localhost',
        'database_port' => '',
        'database_name' => 'nombre_base_datos',
        'database_user' => 'usuario_db',
        'database_password' => 'tu_contraseña',
        'database_prefix' => 'ps_',
    ),
);

Paso 3: Configurar los datos de conexión

Ahora viene la parte clave: instalar prestashop mysql o actualizar los datos existentes. Dependiendo de tu situación, sigue estos pasos:

Si estás instalando PrestaShop desde cero

Ejecuta el instalador de PrestaShop en tu navegador (normalmente accediendo a tudominio.com/install).
Sigue los pasos hasta llegar a la pantalla "Configuración de la base de datos".
Introduce los datos que anotaste en el paso 1:
- Servidor de la base de datos: localhost
- Nombre de la base de datos: el que creaste
- Usuario: el que creaste
- Contraseña: la que asignaste
- Puerto: déjalo vacío si es 3306
Haz clic en "Probar conexión". Si todo es correcto, verás un mensaje verde de éxito.

Si ya tienes una tienda y necesitas cambiar la conexión

Abre el archivo parameters.php con tu editor.
Modifica los campos database_host, database_name, database_user y database_password con los nuevos datos.
Guarda el archivo con permisos de escritura (normalmente 644 o 664).
Verifica que el campo database_prefix coincida con el prefijo de tus tablas (normalmente ps_).

[WARNING] Antes de tocar el archivo parameters.php, siempre haz una copia de seguridad. Un error al editar este archivo puede dejar tu tienda completamente inaccesible.

Paso 4: Verificar la conexión y solucionar errores comunes

Una vez configurados los datos, es momento de comprobar que todo funciona. Si PrestaShop no puede conectar, verás uno de estos mensajes:

Error 1: "No se puede conectar a la base de datos"

Este es uno de los errores base datos prestashop más frecuentes. Las causas suelen ser:

Datos incorrectos: revisa que el usuario, contraseña y nombre de la base de datos sean exactamente los que creaste.
Servidor equivocado: si tu hosting usa un servidor remoto, verifica que el host sea el correcto (no siempre es localhost).
Puerto incorrecto: algunos proveedores usan puertos alternativos al 3306. Consulta con tu hosting.

Error 2: "Usuario no encontrado"

Este error indica que el usuario de la base de datos no existe o no tiene permisos sobre la base de datos. Solución:

Verifica que hayas añadido el usuario a la base de datos con todos los privilegios.
Si usas cPanel, revisa que el nombre completo del usuario incluya el prefijo del hosting.

Error 3: "Acceso denegado para el usuario"

Este error suele aparecer cuando la contraseña es incorrecta o el usuario no tiene permisos desde la IP desde la que intenta conectar. Asegúrate de:

Haber escrito la contraseña correctamente (cuidado con mayúsculas y caracteres especiales).
Haber permitido conexiones desde localhost o desde cualquier host (%) en los privilegios del usuario.

[INFO] Si cambiaste los datos de conexión y PrestaShop sigue mostrando errores, puede que exista una caché. Borra la carpeta var/cache/ de tu instalación para forzar que PrestaShop recargue la configuración.

Paso 5: Importar una base de datos existente (migración)

Si estás migrando tu tienda a un nuevo servidor, no solo necesitas conectar PrestaShop a la nueva base de datos, sino que también debes importar los datos antiguos.

Exportar la base de datos original

Accede a phpMyAdmin desde tu hosting antiguo.
Selecciona tu base de datos de PrestaShop.
Ve a la pestaña "Exportar" y elige el método rápido.
Descarga el archivo .sql resultante.

Importar en la nueva base de datos

Accede a phpMyAdmin de tu nuevo hosting.
Selecciona la base de datos vacía que creaste en el paso 1.
Ve a la pestaña "Importar".
Selecciona el archivo .sql descargado y haz clic en "Continuar".

Después de importar, asegúrate de que el archivo parameters.php apunte a esta nueva base de datos.

[WARNING] Al migrar, también debes actualizar la URL de tu tienda en la tabla ps_configuration de la base de datos. Busca los campos PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL y cámbialos por tu nuevo dominio.

Preguntas frecuentes sobre conexión a base de datos en PrestaShop

¿Qué hago si no recuerdo la contraseña de mi base de datos?

Si estás en cPanel, puedes cambiar la contraseña desde la sección "Usuarios MySQL". En Syspanel, ve a la sección de bases de datos y edita el usuario. Después de cambiarla, actualiza también el archivo parameters.php.

¿Puedo usar una base de datos remota?

Sí, PrestaShop permite conectarse a bases de datos remotas. Solo necesitas el host correcto (por ejemplo, mysql.tudominio.com) y que el servidor permita conexiones externas. Ten en cuenta que esto puede aumentar la latencia y ralentizar tu tienda.

¿Por qué PrestaShop muestra "Tabla no encontrada"?

Este error suele indicar que el prefijo de las tablas en parameters.php no coincide con el que se usó al crear las tablas. Si tu base de datos usa tablas con prefijo ps_, asegúrate de que el archivo de configuración tenga 'database_prefix' => 'ps_'.

¿Cómo sé si mi base de datos está funcionando correctamente?

Puedes acceder a phpMyAdmin desde tu panel de hosting y verificar que las tablas existan y tengan registros. Si la tienda carga sin errores y puedes ver productos, la conexión es correcta.

¿Qué hago si mi hosting usa un puerto diferente?

Algunos proveedores de hosting gestionado usan puertos como el 3307 o el 3308. Si tu proveedor te indica un puerto específico, añádelo en el campo database_port del archivo parameters.php. En el instalador, también hay un campo para el puerto.

Consejos finales para mantener tu base de datos segura

Una vez que hayas logrado conectar prestashop mysql, es crucial mantener la seguridad de tu base de datos:

Cambia las contraseñas periódicamente y usa contraseñas únicas para cada servicio.
Limita los privilegios del usuario de la base de datos: no es necesario que tenga permisos de administrador global.
Haz copias de seguridad automáticas de tu base de datos con regularidad. Puedes configurarlas desde tu hosting o usar módulos de PrestaShop.
Mantén PrestaShop actualizado para evitar vulnerabilidades conocidas.

Si sigues todos estos pasos, no tendrás problemas para conectar tu tienda a la base de datos. Recuerda que la paciencia es clave: verifica cada dato dos veces y, si algo falla, consulta los registros de error de tu hosting para obtener más información.

[TIP] Si después de todo sigues teniendo problemas, prueba a desactivar temporalmente el firewall o el módulo de seguridad de tu hosting. A veces bloquean las conexiones a MySQL sin que te des cuenta.

Con esto, ya tienes todo lo necesario para que tu PrestaShop y su base de datos trabajen en perfecta armonía. ¡Tu tienda online está lista para despegar!