PrestaShop y MySQL: Configurar Conexión a Base de Datos

¿Te has encontrado con el error clásico de "Error de conexión a la base de datos" al instalar o mover tu tienda PrestaShop? No te preocupes, es uno de los sustos más comunes en el mundo del ecommerce, pero tiene una solución clara y paso a paso.

En esta guía extensa y pensada para principiantes, vamos a desgranar todo lo que necesitas saber sobre la conexión de prestashop base de datos. Aprenderás a configurar manualmente el archivo parameters.php prestashop, a entender qué datos necesitas de tu servidor MySQL y a resolver los errores más frecuentes que aparecen en el camino.

Vamos a ello, sin tecnicismos innecesarios y con un lenguaje claro.

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

Antes de ensuciarnos las manos con archivos y configuraciones, es vital entender qué estamos haciendo. PrestaShop no guarda tus productos, clientes o pedidos en archivos de texto. Usa un sistema de gestión de bases de datos relacional, casi siempre MySQL o MariaDB.

Piensa en MySQL como un enorme almacén con estanterías perfectamente organizadas. Cuando configuras tu tienda, le das a PrestaShop la "llave" de ese almacén. Esa llave es la configuración que incluye el servidor, el nombre de la base de datos, el usuario y la contraseña.

Si esa llave no es correcta, o el almacén no existe, la tienda no puede arrancar. Por eso, conectar prestashop mysql es el paso más crítico en la instalación o migración de tu tienda.

Los 4 datos imprescindibles para la conexión

Para configurar la conexión, necesitas tener a mano estos cuatro datos, que normalmente te proporciona tu empresa de hosting:

Servidor de base de datos: Normalmente es localhost si la tienda y la base de datos están en el mismo servidor. Si usas un hosting externo o una base de datos separada, será una URL como sql.tudominio.com o una IP.
Nombre de la base de datos: El nombre exacto que le diste al crear la BD en tu panel de control (ej. tienda_prestashop).
Usuario de la base de datos: El usuario con permisos para acceder a esa BD (ej. admin_tienda).
Contraseña: La clave secreta asociada a ese usuario.

Sin estos datos, es imposible avanzar. Si no los tienes, contacta con tu proveedor de hosting. Si usas un panel como Syspanel, recuerda que el acceso se realiza por el puerto 2106.

Método 1: Configurar la conexión durante la instalación

La forma más sencilla de prestashop configurar db es hacerlo durante el asistente de instalación. Es un proceso guiado, pero debes prestar atención en el paso llamado "Configuración de la base de datos".

Paso a paso en el instalador

Ve a la URL de tu tienda donde hayas subido los archivos de PrestaShop.
Completa los primeros pasos (idioma, aceptación de licencia, compatibilidad).
Llega al apartado de "Información de la base de datos".
Rellena los campos con los 4 datos que mencionamos antes.
En el campo "Prefijo de tabla", puedes dejarlo como ps_ por defecto. No lo cambies a menos que sepas lo que haces, ya que puede romper futuras actualizaciones.
Haz clic en "Probar la conexión". Si todo es correcto, verás un mensaje de éxito. Si no, revisa los datos.

¿Qué hago si me da error en la instalación?

El error más típico es "No se puede conectar a la base de datos". Las causas suelen ser:

Credenciales incorrectas: Revisa mayúsculas, minúsculas y símbolos.
El usuario no tiene permisos: Asegúrate de que el usuario tiene todos los privilegios sobre la base de datos específica.
El servidor no es localhost: A veces, el hosting usa un puerto diferente (ej. 3307) o un servidor distinto. Debes usar el que te indique tu proveedor.

Método 2: Configurar la conexión manualmente con parameters.php

Esta es la vía que usarás si estás migrando tu tienda a un nuevo servidor o si el instalador te da errores extraños. PrestaShop guarda toda la configuración de conexión en un archivo llamado parameters.php.

¿Dónde está el archivo parameters.php?

La ruta habitual es:

[raíz_de_tu_tienda]/app/config/parameters.php

La "raíz de tu tienda" es la carpeta donde están los archivos de PrestaShop (la que contiene admin, app, bin, etc.).

Editando el archivo de forma segura

Este archivo es un script PHP que devuelve un array con los valores. Debes editarlo con un editor de texto plano, como el Bloc de notas o, mejor aún, un editor de código como Visual Studio Code o Notepad++.

Busca estas líneas:

'database_host' => 'localhost',
'database_port' => '',
'database_name' => 'nombre_de_tu_bd',
'database_user' => 'usuario_de_tu_bd',
'database_password' => 'tu_contraseña',
'database_prefix' => 'ps_',

La guía paso a paso para editarlo

Descarga el archivo: Accede a tu hosting por FTP o al administrador de archivos del panel.
Haz una copia de seguridad: Antes de tocar nada, descarga una copia en tu ordenador. Esto es vital por si algo sale mal.
Abre el archivo: Ábrelo con tu editor de texto.
Reemplaza los valores: Sustituye los valores de ejemplo por los tuyos reales.
- database_host: Pon localhost o el servidor que te haya dado tu hosting.
- database_name: El nombre exacto de tu base de datos.
- database_user: El usuario de la BD.
- database_password: La contraseña de ese usuario.
- database_prefix: Déjalo como ps_ salvo que sepas que usas otro.
Guarda el archivo: Guarda los cambios y súbelo de vuelta a la misma ruta, sobrescribiendo el original.
Borra la caché: PrestaShop guarda una copia de esta configuración en la carpeta var/cache. Para forzar que lea el nuevo archivo, borra el contenido de las carpetas var/cache/dev y var/cache/prod. No borres las carpetas en sí, solo su contenido.

[!TIP]
Si no ves la carpeta var o app, activa la opción "Mostrar archivos ocultos" en tu cliente FTP o en el administrador de archivos. Algunos archivos empiezan con un punto (.) y están ocultos por defecto.

Errores comunes al conectar PrestaShop a MySQL

Aunque sigas los pasos al pie de la letra, pueden surgir problemas. Aquí tienes los más habituales y cómo solucionarlos.

Error: "El servidor de la base de datos no está disponible"

Esto suele significar que el servidor MySQL no está corriendo o que el host es incorrecto.

Solución: Verifica que el servicio MySQL está activo en tu servidor. Si usas un hosting compartido, contacta al soporte. Si usas un VPS, tal vez tengas que iniciarlo con systemctl start mysql.

Error: "Acceso denegado para el usuario"

Este es el error de permisos o contraseña incorrecta.

Solución: Revisa que el usuario y la contraseña son exactamente los que creaste. Asegúrate de que el usuario tiene permisos para conectarse desde el host que estás usando (a veces, el usuario solo puede conectarse desde localhost).

Error: "Base de datos no encontrada"

El nombre de la base de datos no existe en el servidor.

Solución: Revisa que el nombre es correcto. En algunos paneles como cPanel, el nombre de la BD viene prefijado por el nombre de usuario (ej. user_prestashop). Copia y pega el nombre directamente desde tu panel de control para evitar errores.

[!WARNING]
Nunca edites el parameters.php mientras la tienda está en modo de mantenimiento activo si no sabes lo que haces. Un error de sintaxis (una coma mal puesta) puede provocar un error 500 en toda la web. Si ocurre, sube la copia de seguridad que hiciste.

Cómo configurar la conexión si usas Syspanel (antes HestiaCP)

Si tu hosting utiliza el panel Syspanel, el proceso de creación de la base de datos es bastante visual, pero el acceso al panel tiene una particularidad.

El puerto de acceso es el 2106. Es decir, no accedes a tu-dominio.com/admin, sino a tu-dominio.com:2106.

Creando la base de datos en Syspanel paso a paso

Accede a https://tu-dominio.com:2106 con tus credenciales de administrador.
Busca la sección "Base de datos" o "Bases de datos MySQL" en el menú lateral.
Haz clic en "Añadir base de datos".
Rellena el nombre de la base de datos, el usuario y la contraseña. El panel te dará un nombre de usuario y BD prefijados (ej. admin_mitienda). Anota estos datos exactamente como aparecen, incluyendo el prefijo.
Haz clic en "Guardar" o "Añadir".

Una vez creada, usa esos datos en tu instalador de PrestaShop o en el archivo parameters.php. La mayoría de las veces, el database_host será localhost.

Preguntas frecuentes (FAQ) sobre la conexión a BD

¿Qué pasa si cambio la contraseña de MySQL después de instalar PrestaShop?

Tu tienda dejará de funcionar al instante. Deberás editar el archivo parameters.php y actualizar el campo database_password con la nueva contraseña. No olvides borrar la caché después.

¿Puedo usar el mismo usuario de MySQL para dos bases de datos distintas?

Sí, es posible, pero no recomendable por seguridad. Si un usuario tiene permisos sobre dos BD, un error en un script podría afectar a ambas. Es mejor crear un usuario específico por tienda.

¿Qué es el prefijo de tabla y por qué es importante?

El prefijo (ej. ps_) se añade antes del nombre de cada tabla en la base de datos. Permite tener varias instalaciones de PrestaShop en la misma base de datos sin que se pisen los datos. Si no sabes qué es, déjalo como ps_.

¿Cómo sé si mi hosting usa MariaDB o MySQL?

Es indiferente para PrestaShop, ya que MariaDB es un reemplazo directo de MySQL. La configuración es exactamente la misma. No te preocupes por esto.

Mi tienda va lenta, ¿es culpa de la base de datos?

Puede ser un factor. Si tienes muchos productos y la base de datos no está optimizada, la tienda irá lenta. Pero eso es un tema de rendimiento, no de conexión. La conexión en sí, si funciona, no debería ralentizar la web.

Consejos finales para una conexión exitosa

Configurar la conexión de prestashop base de datos no es difícil, pero requiere precisión. Aquí tienes un resumen de los mejores consejos:

Siempre haz una copia de seguridad del parameters.php antes de editarlo.
Usa un editor de texto plano y no un procesador de textos como Word.
No uses comillas simples o dobles dentro de los valores si no es necesario. El archivo ya las tiene.
Comprueba los permisos de la carpeta app/config. Debe tener permisos de lectura para el servidor web (normalmente 644).
Si te pierdes, contacta con tu hosting. Ellos pueden verificar si los datos de conexión son correctos desde su lado.

Configurar conectar prestashop mysql es un paso que harás una vez y olvidarás. Pero cuando surge un problema, saber dónde mirar te ahorrará horas de frustración. Con esta guía, ya tienes el mapa para resolverlo.

[!INFO]
Recuerda que el archivo parameters.php prestashop es el corazón de la configuración. Si alguna vez ves un error de conexión, lo primero que debes hacer es verificar este archivo y los permisos de la base de datos. No modifiques otros archivos de configuración sin antes revisar este.

Esperamos que esta guía te haya sido de gran ayuda. Si has llegado hasta aquí, ya eres capaz de enfrentarte a la configuración de tu tienda con confianza. ¡Manos a la obra!