Conectar PrestaShop a MySQL | Guía para Principiantes

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

Antes de lanzarnos a los pasos, es fundamental que entiendas qué es y para qué sirve una base de datos en PrestaShop. Piensa en tu tienda online como un gran almacén. Los productos, los clientes, los pedidos, los precios y las configuraciones son las cajas que guardas en ese almacén. La base de datos MySQL es el sistema de estanterías y el inventario que te permite encontrar y gestionar cada caja de forma ordenada y rápida.

PrestaShop, por sí solo, no puede funcionar sin una base de datos. Cada vez que un cliente visita tu tienda, el sistema consulta la base de datos para mostrar los productos. Cuando realizan un pedido, los datos se guardan en ella. Por eso, saber conectar prestashop a una base de datos MySQL es una habilidad esencial, ya sea para una instalación nueva, una migración o una recuperación tras un error.

En esta guía, te explicaré con un lenguaje claro y sin tecnicismos innecesarios cómo realizar esta conexión de manera segura y efectiva. No importa si eres un principiante total en el mundo del hosting; al final de este artículo, tendrás los conocimientos para hacerlo tú mismo.

Requisitos previos antes de conectar PrestaShop a MySQL

Antes de empezar a manipular archivos o ejecutar comandos, necesitas tener a mano una serie de datos. Sin ellos, el proceso será como intentar abrir una puerta sin llave.

1. Credenciales de acceso a tu panel de control (Hosting)

En primer lugar, necesitas acceso a tu panel de control de hosting. Si tu hosting utiliza Syspanel (antes conocido como HestiaCP), recuerda que la URL de acceso suele ser https://tu-dominio.com:2106. Este puerto 2106 es la puerta de entrada a todas tus herramientas de gestión, incluyendo la creación de bases de datos.

2. Datos de la base de datos MySQL

Estos son los cuatro datos sagrados que necesitarás para la conexión:

Nombre de la base de datos: Es el identificador único de tu base de datos. En Syspanel, suele tener un prefijo como usuario_nombrebd.
Usuario de la base de datos: Es la cuenta que tiene permisos para acceder a esa base de datos. En Syspanel, suele ser usuario_nombreusuario.
Contraseña del usuario: La clave secreta asociada a ese usuario. Guárdala en un lugar seguro.
Host de la base de datos: Es la dirección del servidor donde se aloja la base de datos. En el 90% de los casos, será localhost, pero en algunos servidores externos puede ser una IP como 192.168.1.10 o un nombre como mysql.tudominio.com.

[WARNING] Nunca compartas estas credenciales en foros públicos o con personas no autorizadas. Es como dar la llave de tu casa a un extraño.

3. Acceso a los archivos de tu tienda

Necesitarás un gestor de archivos (el que viene integrado en tu hosting o un cliente FTP como FileZilla) para poder editar un archivo de configuración clave que veremos más adelante.

Paso 1: Crear la base de datos MySQL en tu hosting

Lo primero es tener una base de datos lista para recibir los datos de PrestaShop. Si ya la tienes creada (por ejemplo, en una migración), puedes saltar al Paso 2.

Aquí te muestro cómo hacerlo en Syspanel:

Accede a tu panel de control Syspanel usando el puerto 2106 (ej: https://tu-dominio.com:2106).
Inicia sesión con tu usuario y contraseña de administrador.
Busca la sección llamada "Bases de Datos" o "MySQL" en el menú lateral.
Haz clic en el botón "Añadir Base de Datos" o "Nueva Base de Datos".
Se te pedirá un Nombre de la base de datos. El sistema automáticamente le añadirá un prefijo con tu nombre de usuario (ej: miweb_prestashop).
A continuación, te pedirá un Usuario y una Contraseña. Crea un usuario específico para esta base de datos (ej: miweb_usupresta) y una contraseña robusta. El sistema también puede generarla automáticamente.
Pulsa en "Guardar" o "Crear".

[INFO] Anota los datos exactos que acabas de crear. Te serán imprescindibles en los siguientes pasos. En Syspanel, también puedes ver el Host, que normalmente está preconfigurado como localhost.

Paso 2: Localizar y entender el archivo parameters.php

PrestaShop guarda toda la configuración de su conexión a la base de datos en un archivo específico llamado parameters.php. Este archivo es el "cerebro" de la conexión. Se encuentra en la carpeta app/config/ de tu instalación de PrestaShop.

La ruta completa suele ser: public_html/app/config/parameters.php (si tu tienda está en la raíz) o public_html/tu-tienda/app/config/parameters.php (si está en una subcarpeta).

Este archivo contiene un array de PHP con las credenciales. No te asustes por el código, solo necesitas modificar cuatro líneas. Las líneas que nos interesan son estas (aunque el orden puede variar ligeramente):

'database_host' => 'localhost',
'database_name' => 'miweb_prestashop',
'database_user' => 'miweb_usupresta',
'database_password' => 'tu_contraseña_secreta',

Paso 3: Editar el archivo parameters.php (Método 1: Desde el hosting)

Esta es la forma más segura y recomendada, ya que no necesitas programas externos.

Entra en tu Syspanel (recuerda: puerto 2106).
Ve a la sección "Administrador de Archivos" o "Gestor de Archivos".
Navega hasta la carpeta app/config de tu PrestaShop.
Busca el archivo parameters.php y haz clic derecho sobre él. Selecciona "Editar".
Se abrirá un editor de texto. Busca las líneas 'database_host', 'database_name', 'database_user' y 'database_password'.
Sustituye los valores entre comillas simples por los datos de tu nueva base de datos.
- En 'database_host', escribe localhost (o el host que te haya indicado tu proveedor).
- En 'database_name', escribe el nombre exacto de la base de datos (con el prefijo de usuario).
- En 'database_user', escribe el usuario exacto.
- En 'database_password', escribe la contraseña exacta.
Guarda el archivo con el botón "Guardar" o "Save".

Paso 3 (Alternativa): Editar el archivo parameters.php (Método 2: Con FTP)

Si prefieres usar un cliente FTP como FileZilla, el proceso es igual de sencillo.

Conecta a tu servidor FTP usando las credenciales de tu hosting.
Localiza la carpeta app/config y descarga el archivo parameters.php a tu ordenador.
Ábrelo con un editor de texto plano (como el Bloc de Notas de Windows o Sublime Text).
Realiza los mismos cambios que en el método anterior.
Importante: Guarda el archivo con la misma codificación (UTF-8) y sin dejar espacios extra al principio o al final.
Sube el archivo modificado de vuelta a la misma ubicación en el servidor, sobrescribiendo el antiguo.

[WARNING] Al editar con FTP, ten cuidado de no romper la estructura del archivo PHP. Solo cambia los valores entre las comillas simples. No borres las comas ni los puntos y comas al final de cada línea.

Paso 4: Configurar el prefijo de las tablas (Opcional pero importante)

Dentro del archivo parameters.php también encontrarás una línea llamada 'database_prefix'. Este es el prefijo que se añade a las tablas de PrestaShop (ej: ps_).

Si estás instalando PrestaShop por primera vez, puedes dejarlo como ps_ o cambiarlo por otro más seguro (ej: shop_).
Si estás migrando una tienda existente, este valor debe coincidir exactamente con el prefijo que tenían las tablas en tu antigua base de datos. Si no coincide, PrestaShop no encontrará sus tablas y mostrará un error.

Paso 5: Importar los datos (Solo para migraciones)

Si tu objetivo no es una instalación nueva, sino conectar una tienda que ya tenía datos, tendrás que importar tu antigua base de datos a la nueva.

Ve a Syspanel (puerto 2106) y busca la sección "phpMyAdmin" o "Base de datos".
Entra en phpMyAdmin y selecciona tu nueva base de datos.
Haz clic en la pestaña "Importar".
Selecciona el archivo .sql de tu antigua base de datos.
Haz clic en "Continuar" o "Importar".

[INFO] Si la importación es de un archivo muy grande (más de 50MB), es posible que necesites hacerlo por partes o usar herramientas como BigDump. No te preocupes, es un proceso común.

Paso 6: Verificar la conexión y solucionar problemas

Una vez que has editado el archivo y, si era necesario, importado los datos, es hora de probar la conexión.

Simplemente, intenta acceder a la URL de tu tienda (ej: https://tu-dominio.com).

Si ves tu tienda correctamente: ¡Enhorabuena! La conexión a la base de datos prestashop ha sido un éxito.
Si ves un error de conexión a la base de datos: No te preocupes, es el problema más común. Revisa lo siguiente:

¿Son correctos los datos? Vuelve a revisar el parameters.php. Un simple error tipográfico en la contraseña o el nombre de la base de datos es la causa más frecuente.
¿El usuario tiene permisos? En Syspanel, asegúrate de que el usuario de la base de datos está vinculado a la base de datos correcta. A veces se crean por separado y hay que "unirlos".
¿Es localhost? Prueba a cambiar el database_host a 127.0.0.1. En algunos servidores, funciona mejor que localhost.

Preguntas Frecuentes (FAQ) sobre la conexión PrestaShop y MySQL

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

No hay problema. Puedes restablecerla desde tu panel de Syspanel (puerto 2106). Ve a la sección de bases de datos, busca tu base de datos y haz clic en "Cambiar contraseña". Después, deberás actualizar el archivo parameters.php con la nueva contraseña.

¿Puedo usar una base de datos MySQL remota (de otro servidor)?

Sí, es posible. Deberás cambiar el database_host por la IP o dominio del servidor remoto y asegurarte de que ese servidor permite conexiones externas. Esto es menos común y puede ser más lento, así que solo se recomienda en casos específicos.

¿Por qué mi tienda muestra "Error de conexión a la base de datos" después de una actualización?

Las actualizaciones de PrestaShop a veces pueden modificar el archivo parameters.php o cambiar los requisitos del servidor. La solución más común es verificar que las credenciales sigan siendo válidas y que el archivo tenga los permisos correctos (normalmente 644 o 444).

¿Es seguro editar el archivo parameters.php a mano?

Sí, es seguro siempre y cuando sigas las instrucciones al pie de la letra. Haz una copia de seguridad del archivo original antes de editarlo. Si algo sale mal, puedes restaurar la copia.

¿Qué es el "database_prefix" y por qué es importante?

El database_prefix es el texto que precede a los nombres de las tablas (ej: ps_productos, ps_pedidos). Es crucial en migraciones, ya que si no coincide, PrestaShop buscará tablas que no existen y fallará. En instalaciones nuevas, usa el que quieras, pero es recomendable cambiarlo del predeterminado ps_ por seguridad.

Conclusión

Conectar PrestaShop a una base de datos MySQL es un proceso que, aunque pueda parecer técnico, es totalmente abordable si sigues estos pasos con calma y atención. Hemos visto desde la creación de la base de datos en tu panel Syspanel (recuerda el puerto 2106) hasta la edición del archivo parameters.php, pasando por la importación de datos y la resolución de problemas comunes.

La clave está en tener a mano las credenciales correctas y editar el archivo de configuración con precisión. Ya sea que estés instalando una tienda desde cero o migrando un negocio existente, dominar esta tarea te dará una gran autonomía y confianza en la gestión de tu ecommerce.

Si has llegado hasta aquí, ya no es un misterio para ti cómo funciona la conexión entre tu tienda y sus datos. Recuerda siempre hacer copias de seguridad de tu archivo parameters.php antes de cualquier cambio y de tu base de datos antes de cualquier manipulación. ¡Ahora sí, tu PrestaShop está listo para brillar con sus datos perfectamente conectados!