Conectar PrestaShop a MySQL: Configurar Parámetros de Conexión

¿Qué necesitas para conectar PrestaShop a MySQL?

Antes de empezar, vamos a poner las cartas sobre la mesa. Para que PrestaShop funcione correctamente, necesitas tres cosas básicas: el archivo de instalación de PrestaShop (que ya tendrás descargado), un servidor web con PHP (como Apache o Nginx) y, por supuesto, una base de datos MySQL vacía y creada. Esta base de datos será el "almacén" donde se guardarán todos los productos, pedidos, clientes y configuraciones de tu tienda.

Si estás usando un panel de control como cPanel, Plesk o Syspanel (recuerda que Syspanel se accede por el puerto 2106), normalmente ya tienes la opción de crear bases de datos MySQL desde el propio panel. Pero si eres más de línea de comandos, también puedes hacerlo con un simple comando SQL. No te preocupes, te lo explico paso a paso.

En este artículo vamos a centrarnos en cómo conectar PrestaShop a MySQL, es decir, en los parámetros de conexión que debes configurar durante la instalación. Pero también te daré trucos para verificar que todo funciona y para solucionar los errores más comunes. Vamos a ello.

Parámetros de conexión de PrestaShop: ¿Qué significan?

Durante el proceso de instalación de PrestaShop, llegará un momento en que te pedirá los datos de acceso a tu base de datos. Es aquí donde mucha gente se bloquea. Pero tranquilo, son solo cuatro campos, y te explico cada uno.

1. Dirección del servidor de base de datos

Este campo suele llamarse "Database server address" o "Dirección del servidor de base de datos". Aquí debes poner la IP o el nombre del host donde está alojada tu base de datos MySQL.

En la mayoría de los casos, si tu base de datos está en el mismo servidor que tu web, este valor será localhost. Pero si la base de datos está en un servidor separado (por ejemplo, un hosting cloud o un servidor dedicado), aquí tendrás que poner la IP pública o el nombre de dominio del servidor de base de datos.

[TIP] Si usas un hosting compartido, casi siempre será localhost. Si no estás seguro, mira la documentación de tu proveedor de hosting o el panel de control. En Syspanel, por ejemplo, puedes ver esta información en la sección de bases de datos.

2. Nombre de la base de datos

Este es el nombre que le pusiste a tu base de datos MySQL cuando la creaste. Es importante que sea exacto, con mayúsculas y minúsculas correctas. En muchos paneles de control, el nombre de la base de datos incluye un prefijo con tu usuario de hosting (por ejemplo, usuario123_prestashop).

Asegúrate de copiar el nombre completo, tal como aparece en tu panel. Un error típico es poner solo el nombre "prestashop" cuando en realidad es "tuusuario_prestashop". Esto provocará un error de conexión.

3. Usuario de la base de datos

Este es el usuario que tiene permisos para acceder a la base de datos. En muchos casos, es el mismo que el nombre de la base de datos (por ejemplo, usuario123_prestashop), pero puede ser diferente. En tu panel de control, al crear la base de datos, se te pedirá que crees un usuario y le asignes una contraseña.

[WARNING] Asegúrate de que este usuario tenga todos los privilegios sobre la base de datos (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.). Si solo tiene permisos de lectura, la instalación fallará y no podrás crear las tablas de PrestaShop. Si usas Syspanel, puedes asignar los privilegios fácilmente desde el gestor de bases de datos.

4. Contraseña de la base de datos

La contraseña asociada al usuario de la base de datos. Ten cuidado con los caracteres especiales. Si tu contraseña contiene símbolos como @, #, $, etc., asegúrate de que no haya problemas de escape de caracteres. En algunos casos, si tu contraseña tiene caracteres raros y falla la conexión, prueba a cambiarla por una más simple (solo letras y números) y vuelve a intentarlo.

Cómo conectar PrestaShop a MySQL paso a paso

Ahora que ya sabes qué significa cada campo, vamos a ver el proceso completo. Te lo explico tanto para la instalación desde cero como para modificar la configuración si ya tienes PrestaShop instalado.

Instalación desde cero

Sube los archivos de PrestaShop a tu servidor. Puedes hacerlo mediante FTP o desde el administrador de archivos de tu panel de control. Descomprime el ZIP en la carpeta donde quieras instalar la tienda (por ejemplo, public_html o public_html/tienda).
Abre tu navegador y escribe la URL de tu tienda (por ejemplo, https://tudominio.com/tienda). Se iniciará el asistente de instalación de PrestaShop.
Acepta los términos y condiciones y sigue los pasos hasta llegar a la pantalla de "Configuración de la base de datos". Aquí es donde entra todo lo que hemos hablado antes.
Rellena los campos con los datos de tu base de datos MySQL. Recuerda: servidor (normalmente localhost), nombre de la base de datos, usuario y contraseña.
En el campo "Prefijo de tablas", déjalo como ps_ por defecto. No lo cambies a menos que sepas lo que haces. Esto es útil si quieres tener varias tiendas en la misma base de datos, pero para empezar, déjalo así.
Haz clic en "Comprobar base de datos" o "Siguiente". PrestaShop intentará conectarse y, si todo está correcto, te mostrará un mensaje de éxito. Si hay algún error, te lo indicará y podrás corregirlo.
Continúa con el resto de la instalación (configuración de la tienda, cuenta de administrador, etc.) hasta que termine.

[INFO] Si durante la instalación te aparece un error del tipo "Cannot connect to the database" o "Error de conexión a la base de datos", revisa los cuatro parámetros que hemos visto. Es el fallo más común y casi siempre es por un nombre de base de datos o usuario incorrecto.

Si PrestaShop ya está instalado y quieres cambiar la conexión

Puede que necesites cambiar la base de datos porque te has mudado de hosting o porque quieres apuntar a un servidor MySQL distinto. Para ello, tienes que editar el archivo app/config/parameters.php de tu instalación de PrestaShop.

Dentro de este archivo encontrarás una estructura similar a esta:

return [
    'parameters' => [
        'database_host' => 'localhost',
        'database_name' => 'tu_base_de_datos',
        'database_user' => 'tu_usuario',
        'database_password' => 'tu_contraseña',
        'database_prefix' => 'ps_',
        // ... otros parámetros
    ],
];

Simplemente cambia los valores por los nuevos. Guarda el archivo y sube los cambios al servidor. No necesitas tocar nada más. Asegúrate de que el usuario y la contraseña sean correctos y que la base de datos exista.

[WARNING] Antes de editar este archivo, haz una copia de seguridad. Si cometes un error, tu tienda podría dejar de funcionar. Y si vas a cambiar de servidor, asegúrate de que la base de datos se haya importado correctamente en el nuevo destino.

Verificar la conexión PrestaShop-MySQL

Una vez instalado, es buena idea verificar que la conexión funciona correctamente. Puedes hacerlo de varias maneras.

Desde el panel de administración

Entra en tu panel de administración de PrestaShop (normalmente en /admin o /backoffice). Ve a "Parámetros avanzados" y luego a "Información". Aquí verás un resumen de tu instalación, incluyendo la versión de MySQL que estás usando y la base de datos conectada.

Si ves que la información aparece correctamente, tu conexión está funcionando.

Desde phpMyAdmin o el gestor de bases de datos

Accede a tu gestor de bases de datos (como phpMyAdmin) y comprueba que las tablas de PrestaShop se han creado correctamente. Deberías ver una lista de tablas con el prefijo ps_ (o el que hayas elegido). Si ves las tablas, la conexión se ha establecido correctamente.

Consultando la base de datos directamente

Si eres más técnico, puedes ejecutar una consulta simple para verificar que todo está en orden. Por ejemplo, desde la línea de comandos de MySQL:

SELECT * FROM ps_employee;

Si la consulta devuelve resultados (por ejemplo, el usuario administrador que creaste), la conexión funciona.

Errores comunes al conectar PrestaShop a MySQL

Aunque hayas seguido todos los pasos, a veces las cosas fallan. Aquí tienes los errores más habituales y cómo solucionarlos.

Error: "Access denied for user 'usuario'@'localhost'"

Este error significa que el usuario no tiene permisos para acceder a la base de datos. Comprueba que:

El nombre de usuario es correcto.
La contraseña es correcta.
El usuario tiene permisos sobre la base de datos concreta (no solo sobre una parte).

[TIP] En Syspanel, ve a la sección de bases de datos, selecciona tu base de datos y asegúrate de que el usuario esté vinculado con todos los privilegios.

Error: "Unknown database 'nombre_base'"

La base de datos no existe o el nombre está mal escrito. Verifica que has creado la base de datos y que el nombre coincide exactamente con el que has puesto en la instalación.

Error: "Connection refused" o "Can't connect to MySQL server"

Este error indica que el servidor MySQL no está accesible. Puede ser porque:

El servidor de base de datos está caído.
Estás usando una IP o puerto incorrectos.
El servidor MySQL no acepta conexiones externas (si la base de datos está en otro servidor).

Si estás en un hosting compartido, lo más normal es que el servidor sea localhost. Si has puesto una IP externa, prueba a cambiarla por localhost y vuelve a intentarlo.

Error: "The database server is not available"

Este mensaje genérico puede aparecer por varias razones. Revisa los logs de error de MySQL y de PHP para obtener más información. Si no sabes cómo ver los logs, contacta con tu proveedor de hosting.

Consejos para optimizar la conexión a MySQL

Una vez que ya sabes cómo conectar PrestaShop a MySQL, es buen momento para hablar de buenas prácticas. Aquí van algunos consejos para que tu tienda vaya rápida y estable.

Usa un servidor de bases de datos separado si tu tienda tiene mucho tráfico. Esto reduce la carga del servidor web y mejora el rendimiento.
Configura el prefijo de tablas con un valor único si vas a tener varias instalaciones de PrestaShop en la misma base de datos. Por ejemplo, ps_matienda_ en lugar de ps_.
Realiza copias de seguridad periódicas de tu base de datos. Puedes hacerlo desde phpMyAdmin o programar un script con cron.
Mantén MySQL actualizado a una versión estable y compatible con PrestaShop. Generalmente, PrestaShop funciona bien con MySQL 5.6 o superior.
Usa un usuario de base de datos dedicado para PrestaShop, en lugar de usar el usuario root. Esto es más seguro y evita problemas de permisos.
Si usas Syspanel, recuerda que puedes configurar la conexión a MySQL desde el panel de administración, pero también puedes hacerlo editando directamente el archivo parameters.php. Ambas opciones son válidas.

Preguntas frecuentes sobre la conexión PrestaShop-MySQL

¿Puedo usar SQLite en lugar de MySQL?

No. PrestaShop está diseñado para funcionar exclusivamente con bases de datos MySQL o MariaDB. No soporta SQLite.

¿Qué versión de MySQL necesito?

PrestaShop 8 y versiones anteriores son compatibles con MySQL 5.6 o superior. También funciona con MariaDB 10.0 o superior. Si usas una versión muy antigua, es posible que tengas problemas.

¿Puedo cambiar la base de datos después de instalar PrestaShop?

Sí, puedes cambiar la base de datos editando el archivo app/config/parameters.php. Eso sí, asegúrate de que la nueva base de datos tenga todas las tablas necesarias (puedes importar una copia de la antigua).

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

Puedes restablecerla desde el panel de control de tu hosting (cPanel, Plesk, Syspanel, etc.). En Syspanel, ve a la sección de bases de datos, selecciona tu base de datos y cambia la contraseña del usuario.

¿Puedo tener dos tiendas PrestaShop con la misma base de datos?

Sí, pero necesitas usar prefijos de tabla diferentes para cada instalación. Por ejemplo, ps_tienda1_ y ps_tienda2_. Si usan el mismo prefijo, se sobrescribirán las tablas y romperás ambas tiendas.

¿Cómo sé si mi conexión a MySQL es segura?

Asegúrate de que la conexión entre PrestaShop y MySQL se realiza a través de una red segura. Si ambos están en el mismo servidor, no hay problema. Si están en servidores diferentes, utiliza una conexión SSL si es posible y restringe el acceso por IP.

Resumen final

Conectar PrestaShop a una base de datos MySQL es un proceso sencillo si entiendes los parámetros de conexión. Recuerda que los cuatro campos clave son: servidor, nombre de la base de datos, usuario y contraseña. La mayoría de los errores se deben a un nombre mal escrito o a permisos insuficientes.

Si estás usando Syspanel, recuerda que el puerto de acceso al panel es el 2106, y que puedes gestionar tus bases de datos desde ahí de forma cómoda y visual.

Espero que este artículo te haya sido de ayuda. Si te ha quedado alguna duda, revisa la sección de preguntas frecuentes o deja un comentario. ¡Buena suerte con tu tienda online!