Conectar PrestaShop a MySQL: Tutorial Paso a Paso

Introducción: Por qué es clave conectar PrestaShop a MySQL

PrestaShop es uno de los CMS de comercio electrónico más populares del mundo, y su funcionamiento depende por completo de una base de datos MySQL. Cada producto, pedido, cliente y configuración de tu tienda se guarda en tablas dentro de esa base de datos. Si la conexión falla, tu tienda se cae o muestra errores críticos.

Conectar PrestaShop a MySQL puede parecer intimidante si no tienes experiencia técnica, pero en realidad es un proceso muy estructurado. En este tutorial te guiaré paso a paso, desde la creación de la base de datos hasta la configuración final en el archivo de parámetros. Al final, tendrás tu tienda funcionando sin problemas y entenderás qué hace cada parte del proceso.

Vamos a dividir el tutorial en tres grandes bloques: preparar el entorno, crear la base de datos y, finalmente, conectar PrestaShop a MySQL tanto en instalación nueva como en una tienda existente.

Requisitos previos antes de empezar

Antes de tocar nada, asegúrate de tener lo siguiente:

Acceso a tu panel de control de hosting (cPanel, Plesk, Syspanel, etc.).
Credenciales de acceso a MySQL (usuario y contraseña con privilegios suficientes).
Los archivos de PrestaShop descargados o ya subidos a tu servidor.
Un cliente FTP o el administrador de archivos de tu hosting.
Conocimientos básicos de qué es una base de datos y para qué sirve (si no, no te preocupes, lo explico todo).

[INFO]: Si tu hosting usa Syspanel (antes conocido como HestiaCP), recuerda que el acceso al panel se realiza a través del puerto 2106. Por ejemplo: https://tu-dominio.com:2106.

Paso 1: Crear la base de datos MySQL

El primer paso es tener una base de datos vacía lista para que PrestaShop la use. Esto se hace desde el panel de control de tu hosting.

Opción A: Crear base de datos en cPanel

Entra a cPanel con tus credenciales.
Busca la sección Bases de Datos y haz clic en MySQL® Databases.
En el campo Create New Database, escribe un nombre descriptivo (por ejemplo, tienda_prestashop).
Haz clic en Create Database.
Ahora ve a MySQL® Users y crea un usuario nuevo. Elige un nombre y una contraseña segura.
Vuelve a la sección Add User to Database, selecciona el usuario y la base de datos que acabas de crear, y haz clic en Add.
En la ventana emergente, selecciona ALL PRIVILEGES y confirma.

Opción B: Crear base de datos en Syspanel (HestiaCP)

Accede a Syspanel usando el puerto 2106 (ejemplo: https://tu-dominio.com:2106).
Inicia sesión con tu usuario administrador.
Ve a la pestaña Bases de Datos en el menú superior.
Haz clic en Add Database.
Completa los campos: nombre de la base de datos, usuario y contraseña.
Selecciona el tipo de base de datos MySQL (o MariaDB, que es compatible).
Haz clic en Save.

[TIP]: Anota en un lugar seguro el nombre de la base de datos, el usuario y la contraseña. Los necesitarás en los siguientes pasos y es fácil olvidarlos.

Paso 2: Obtener los datos de conexión a MySQL

Para conectar PrestaShop a MySQL, necesitas cuatro datos básicos:

Nombre del servidor MySQL: normalmente localhost, pero en algunos hostings puede ser una dirección como mysql.tudominio.com.
Nombre de la base de datos: el que acabas de crear.
Usuario de la base de datos: el usuario que creaste.
Contraseña del usuario: la que definiste.

Puedes encontrar el nombre del servidor en la misma sección de bases de datos de tu panel. En cPanel suele aparecer como localhost; en Syspanel también suele ser localhost salvo que uses servidores externos.

[WARNING]: Si tu hosting usa un servidor de bases de datos remoto, el nombre del servidor NO será localhost. Verifica siempre este dato en la documentación de tu proveedor o en el panel de control.

Paso 3: Conectar PrestaShop a MySQL en una instalación nueva

Si estás instalando PrestaShop desde cero, el proceso de conexión es guiado por el asistente de instalación.

Sube los archivos de PrestaShop a tu servidor (por ejemplo, en la carpeta public_html o www).
Abre tu navegador y ve a la URL de tu tienda (ejemplo: https://tudominio.com).
Selecciona el idioma de instalación y haz clic en Next.
Acepta los términos de la licencia y continúa.
Llegarás a la pantalla de Configuración de la base de datos. Aquí es donde ocurre la magia.
Completa los campos:
- Database server address: localhost (o el que te haya dado tu hosting).
- Database name: el nombre de tu base de datos.
- Database login: el usuario de MySQL.
- Database password: la contraseña.
- Database prefix: te recomiendo dejarlo como ps_ por defecto.
Haz clic en Test your database connection. Si todo está bien, verás un mensaje de éxito.
Sigue los pasos restantes (configuración de la tienda, cuenta de administrador, etc.).
Cuando termine, ya tendrás tu PrestaShop conectado a MySQL.

[TIP]: Si el test de conexión falla, revisa que no haya espacios en blanco en las credenciales y que el usuario tenga todos los privilegios sobre la base de datos.

Paso 4: Configurar la conexión en una instalación existente

Si ya tienes PrestaShop instalado y necesitas cambiar la conexión a MySQL (por ejemplo, porque migraste de servidor), tendrás que editar un archivo de configuración.

Localizar el archivo parameters.php

El archivo clave se llama parameters.php y se encuentra en la carpeta app/config/ de tu instalación de PrestaShop.

Accede a tu servidor por FTP o usando el administrador de archivos del hosting.
Navega hasta app/config/.
Descarga el archivo parameters.php a tu ordenador para editarlo con seguridad.

Editar los parámetros de conexión

Abre el archivo con un editor de texto (como Notepad++ o Visual Studio Code). Busca la sección database y verás algo parecido a esto:

'database_host' => 'localhost',
'database_name' => 'nombre_base_datos',
'database_user' => 'usuario_mysql',
'database_password' => 'contraseña',

Modifica los valores con los datos de tu nueva base de datos:

database_host: el servidor MySQL.
database_name: el nombre de la base de datos.
database_user: el usuario de MySQL.
database_password: la contraseña.

Guarda el archivo y súbelo de nuevo a app/config/.

[WARNING]: Antes de modificar el archivo, haz una copia de seguridad del original. Si cometes un error, podrás restaurarlo rápidamente.

Paso 5: Verificar que la conexión funciona correctamente

Después de conectar PrestaShop a MySQL, es importante comprobar que todo funciona bien.

Accede a tu tienda en el navegador. Deberías ver la página principal sin errores.
Entra al panel de administración (/admin o la URL que configuraste). Si puedes iniciar sesión, la conexión es correcta.
Ve a Parámetros avanzados > Información en el menú de administración. Aquí verás el estado de la base de datos y la versión de MySQL.
Realiza una prueba de compra simulada o crea un producto de prueba para asegurarte de que los datos se guardan correctamente.

[INFO]: Si ves un error como "Link to database cannot be established", significa que la conexión falló. Revisa los datos de conexión y los privilegios del usuario.

Solución de problemas comunes al conectar PrestaShop a MySQL

Aunque el proceso es sencillo, a veces surgen problemas. Aquí tienes los más frecuentes y sus soluciones.

Error de acceso denegado

Este error suele indicar que el usuario no tiene permisos suficientes o que la contraseña es incorrecta.

Verifica que el usuario esté asociado a la base de datos.
Confirma que la contraseña no tenga caracteres especiales que puedan interpretarse mal.
Si usas Syspanel, revisa que el usuario tenga privilegios sobre la base de datos específica.

Error de host no encontrado

Si el servidor MySQL no es localhost, asegúrate de que la dirección sea correcta. En algunos hostings, el host puede ser algo como mysql.tudominio.com o una IP.

Tablas con prefijo incorrecto

Si importaste una base de datos de otra instalación, el prefijo de las tablas puede ser diferente. En parameters.php, verifica el valor de database_prefix.

Base de datos corrupta

Si la conexión funciona pero aparecen errores extraños, la base de datos puede estar corrupta. Desde el panel de control (cPanel o Syspanel) puedes reparar las tablas MySQL.

[TIP]: Siempre que hagas cambios en la configuración de la base de datos, borra la carpeta var/cache de PrestaShop para evitar problemas de caché.

Buenas prácticas para mantener tu PrestaShop y MySQL seguros

Una vez que has logrado conectar PrestaShop a MySQL, es fundamental mantener la seguridad.

Cambia las contraseñas periódicamente: tanto la de la base de datos como la del usuario MySQL.
Haz copias de seguridad regulares: programa backups automáticos de la base de datos.
Limita los privilegios del usuario: si el usuario solo necesita leer y escribir, no le des permisos de administrador global.
Usa conexiones seguras: si tu hosting lo permite, activa SSL para las conexiones a MySQL.
Mantén PrestaShop actualizado: las versiones nuevas corrigen vulnerabilidades de seguridad.

Preguntas frecuentes (FAQ) sobre conectar PrestaShop a MySQL

¿Puedo usar MariaDB en lugar de MySQL?

Sí, PrestaShop es compatible con MariaDB, que es una alternativa de código abierto a MySQL. Los pasos son idénticos.

¿Qué hago si olvido la contraseña de MySQL?

Puedes restablecerla desde el panel de control de tu hosting. En cPanel, ve a MySQL® Users y cambia la contraseña. En Syspanel, edita el usuario desde la sección de bases de datos.

¿Puedo cambiar el nombre de la base de datos después de la instalación?

Técnicamente sí, pero no es recomendable. Tendrías que exportar la base de datos, crear una nueva con el nombre deseado, importar los datos y actualizar parameters.php.

¿Por qué aparece el error "Table 'ps_shop' doesn't exist"?

Esto indica que la base de datos está vacía o que el prefijo no coincide. Verifica que las tablas se hayan importado correctamente y que el prefijo en parameters.php sea el correcto.

¿Es necesario tener conocimientos avanzados para conectar PrestaShop a MySQL?

No, con este tutorial y un poco de paciencia, cualquier persona puede hacerlo. Solo necesitas acceso al panel de control y seguir los pasos al pie de la letra.

Conclusión

Conectar PrestaShop a MySQL es un proceso fundamental que, una vez entendido, te dará total control sobre tu tienda online. Hemos visto cómo crear la base de datos, obtener las credenciales, configurar la conexión tanto en instalaciones nuevas como existentes, y resolver los problemas más comunes.

Recuerda que la clave está en tener los datos correctos y en verificar cada paso. Si algo falla, no te desesperes: revisa los datos de conexión, los privilegios del usuario y el archivo parameters.php. Con práctica, podrás hacer este proceso en menos de diez minutos.

[TIP]: Guarda este tutorial en tus favoritos o imprímelo. Te será útil cada vez que necesites migrar tu tienda a un nuevo servidor o solucionar problemas de conexión.

Ahora que ya sabes cómo conectar PrestaShop a MySQL, te invito a explorar otras configuraciones avanzadas, como la optimización de consultas o la gestión de múltiples tiendas desde una sola base de datos. Pero eso ya es otra historia.