Conectar PrestaShop con MySQL | Tutorial fácil

Conectar correctamente tu tienda PrestaShop con su base de datos MySQL es uno de los pasos fundamentales para que todo funcione sin problemas. Si alguna vez has visto el temido error "No se puede conectar a la base de datos" o simplemente quieres saber cómo se realiza esta conexión de forma manual, esta guía es para ti.

Aquí te explicaremos paso a paso, con un lenguaje claro y sencillo, cómo establecer esa conexión, qué datos necesitas y cómo solucionar los problemas más comunes. No necesitas ser un experto en programación; solo seguir las instrucciones al pie de la letra.

¿Qué necesitas para conectar PrestaShop con MySQL?

Antes de empezar, asegúrate de tener a mano la siguiente información. Sin estos datos, la conexión será imposible:

Nombre de la base de datos: El nombre que le diste a tu base de datos MySQL (ejemplo: tienda_prestashop).
Usuario de la base de datos: El usuario que tiene permisos para acceder a esa base de datos (ejemplo: admin_tienda).
Contraseña del usuario: La contraseña asociada a ese usuario.
Servidor de la base de datos: Normalmente es localhost, pero si tu base de datos está en un servidor externo, será una dirección IP o un nombre de dominio (ejemplo: mysql.mihosting.com).
Puerto de conexión: Por defecto, MySQL usa el puerto 3306. En algunos casos, puede ser diferente.

[INFO] Si estás usando un panel de control como Syspanel, puedes encontrar estos datos en la sección de "Bases de Datos". Recuerda que el acceso a Syspanel se realiza a través del puerto 2106 (ejemplo: tudominio.com:2106).

Método 1: Conexión durante la instalación de PrestaShop

La forma más común de conectar PrestaShop con MySQL es durante el proceso de instalación. Aquí te mostramos cómo hacerlo.

Paso 1: Inicia la instalación de PrestaShop

Una vez que hayas subido los archivos de PrestaShop a tu servidor, accede a tu dominio desde un navegador. Verás la pantalla de bienvenida del instalador. Selecciona tu idioma y haz clic en "Siguiente".

Paso 2: Llega a la pantalla de configuración de la base de datos

Después de aceptar los términos de licencia y verificar que tu servidor cumple con los requisitos, llegarás a la sección "Configuración de la base de datos". Aquí es donde ocurre la magia.

Paso 3: Introduce los datos de conexión

En esta pantalla, verás varios campos. Rellénalos con la información que reuniste antes:

Dirección del servidor de la base de datos: Escribe localhost o la dirección que te haya proporcionado tu hosting.
Nombre de la base de datos: El nombre exacto de tu base de datos.
Usuario de la base de datos: El nombre de usuario.
Contraseña de la base de datos: La contraseña correspondiente.
Prefijo de las tablas: Puedes dejarlo como ps_ o cambiarlo por seguridad (por ejemplo, shop_).

[TIP] Si no estás seguro de algún dato, contacta con tu proveedor de hosting. En Syspanel, puedes crear una base de datos y un usuario desde "Bases de Datos" > "Añadir Base de Datos".

Paso 4: Prueba la conexión

Antes de continuar, haz clic en el botón "¡Prueba tu conexión ahora!". PrestaShop intentará conectar con MySQL y te mostrará un mensaje de éxito o un error.

Si la conexión es exitosa: Verás un mensaje verde. Puedes continuar con la instalación.
Si la conexión falla: Revisa los datos introducidos. Los errores más comunes son:
- Nombre de base de datos incorrecto.
- Usuario o contraseña equivocados.
- El usuario no tiene permisos sobre la base de datos.
- El servidor de base de datos no es accesible (si no es localhost).

Paso 5: Finaliza la instalación

Una vez que la prueba sea exitosa, haz clic en "Siguiente". PrestaShop creará todas las tablas necesarias en tu base de datos y te guiará para configurar tu tienda (nombre, email, país, etc.). ¡Enhorabuena, tu tienda ya está conectada!

Método 2: Conexión manual editando el archivo `settings.inc.php`

Si ya tienes PrestaShop instalado pero necesitas cambiar la conexión a la base de datos (por ejemplo, porque cambiaste de hosting o de servidor MySQL), puedes hacerlo manualmente editando un archivo de configuración.

Este método es más técnico, pero te damos una guía paso a paso para que no te pierdas.

Paso 1: Localiza el archivo `settings.inc.php`

Este archivo se encuentra en la carpeta config de tu instalación de PrestaShop. La ruta completa suele ser:

/tu_dominio/config/settings.inc.php

Puedes acceder a él mediante FTP (FileZilla, Cyberduck) o desde el administrador de archivos de tu panel de control (como Syspanel, accediendo por el puerto 2106).

Paso 2: Descarga una copia de seguridad (¡IMPORTANTE!)

Antes de modificar cualquier archivo, siempre haz una copia de seguridad. Descarga el archivo settings.inc.php a tu ordenador. Si algo sale mal, podrás restaurarlo.

Paso 3: Edita el archivo

Abre el archivo con un editor de texto plano (como Notepad++, Sublime Text o incluso el Bloc de notas). Verás un contenido similar a este:

<?php
define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_base_datos');
define('_DB_USER_', 'usuario_base_datos');
define('_DB_PASSWD_', 'contraseña_base_datos');
define('_DB_PREFIX_', 'ps_');
define('_MYSQL_PORT_', '3306');
?>

Paso 4: Modifica las líneas necesarias

Cambia los valores de las siguientes constantes según tu nueva configuración:

_DB_SERVER_: Cambia 'localhost' por la nueva dirección del servidor MySQL.
_DB_NAME_: Cambia 'nombre_base_datos' por el nombre de tu nueva base de datos.
_DB_USER_: Cambia 'usuario_base_datos' por el nuevo usuario.
_DB_PASSWD_: Cambia 'contraseña_base_datos' por la nueva contraseña.
_MYSQL_PORT_: Si el puerto no es el 3306, cámbialo (por ejemplo, '3307').

[WARNING] Ten mucho cuidado con las comillas y los puntos y coma. Un error tipográfico puede romper la conexión. Por ejemplo, define('_DB_NAME_', 'mi_tienda'); es correcto, pero define('_DB_NAME_', 'mi_tienda'); (sin la tilde en la palabra "define") no lo es.

Paso 5: Guarda y sube el archivo

Guarda los cambios en el archivo y súbelo de nuevo a la misma ubicación en tu servidor (sobrescribiendo el original).

Paso 6: Verifica la conexión

Accede a tu tienda PrestaShop. Si todo está correcto, la tienda cargará con normalidad. Si ves un error de conexión a la base de datos, revisa los datos que introdujiste y asegúrate de que el usuario tenga permisos sobre la base de datos.

Solución de problemas comunes (FAQ)

Aquí respondemos a las dudas más frecuentes de los usuarios al conectar PrestaShop con MySQL.

¿Por qué me sale "No se puede conectar a la base de datos"?

Este es el error más común. Las causas principales son:

Datos incorrectos: Revisa el nombre de la base de datos, usuario y contraseña. Un simple error tipográfico puede causarlo.
Permisos insuficientes: El usuario de la base de datos no tiene permisos para acceder a ella. Desde Syspanel, puedes asignar permisos en "Bases de Datos" > "Gestionar permisos".
Servidor incorrecto: Si tu base de datos no está en localhost, asegúrate de que la dirección sea correcta y que tu servidor web pueda alcanzarla.
Puerto incorrecto: Si tu MySQL usa un puerto diferente al 3306, debes especificarlo en el archivo settings.inc.php o durante la instalación.

¿Puedo usar un servidor MySQL externo (no localhost)?

Sí, es posible. Solo necesitas la dirección IP o el nombre de dominio del servidor MySQL. Eso sí, asegúrate de que tu servidor web tenga permiso para conectarse a ese servidor externo (a veces hay que añadir la IP del servidor web en una lista blanca de MySQL).

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

Si tienes acceso a Syspanel (puerto 2106), puedes cambiar la contraseña desde "Bases de Datos" > "Editar usuario". Si no, contacta con tu proveedor de hosting.

¿El prefijo de las tablas (`ps_`) es obligatorio?

No, puedes cambiarlo por cualquier otro (por ejemplo, shop_ o mistienda_). Es recomendable cambiarlo por seguridad, así si alguien intenta un ataque SQL, no conocerá el nombre de tus tablas.

¿Puedo tener varias tiendas PrestaShop en la misma base de datos?

Técnicamente sí, pero no es recomendable. Cada tienda debe tener su propia base de datos para evitar conflictos y facilitar la gestión. Si usas el mismo servidor MySQL, crea bases de datos separadas (ejemplo: tienda1, tienda2).

Consejos finales para una conexión segura y estable

Usa contraseñas seguras: No uses contraseñas como "123456" o "admin". Combina letras, números y símbolos.
Haz copias de seguridad periódicas: Tanto de los archivos de PrestaShop como de la base de datos. Desde Syspanel puedes programar backups automáticos.
Mantén PrestaShop y MySQL actualizados: Las versiones antiguas pueden tener vulnerabilidades de seguridad.
No compartas tus datos de conexión: Mantén el usuario y la contraseña de la base de datos en secreto.

Con esta guía, conectar PrestaShop con MySQL debería ser pan comido. Recuerda que la paciencia es clave: si algo falla, revisa los datos paso a paso. Y si te atascas, no dudes en contactar con el soporte de tu hosting.

¡Ahora ya puedes poner en marcha tu tienda online con total confianza!