Configurar base de datos en PrestaShop: Guía de conexión

Conectar tu base de datos a PrestaShop es uno de los pasos más importantes durante la instalación o migración de tu tienda online. Sin una conexión correcta, tu tienda no podrá funcionar, ya que es allí donde se almacenan todos los datos: productos, pedidos, clientes, configuraciones, etc.

En esta guía completa, te explicaremos paso a paso cómo realizar esta conexión, ya sea durante una instalación nueva o cuando necesitas modificar los datos de acceso a tu base de datos existente. No te preocupes si no eres un experto técnico, lo haremos de forma muy visual y sencilla.

¿Qué necesitas saber antes de empezar?

Antes de meternos en materia, es fundamental que tengas claros algunos conceptos básicos. La base de datos de PrestaShop es gestionada por un sistema llamado MySQL (o MariaDB, que es una versión mejorada). Para conectar tu tienda con esta base de datos, necesitarás cuatro datos clave:

Nombre de la base de datos: El nombre que le asignaste a tu base de datos en tu servidor.
Usuario de la base de datos: El nombre del usuario que tiene permisos para acceder a esa base.
Contraseña del usuario: La contraseña asociada a ese usuario.
Servidor de la base de datos: Normalmente es localhost, pero en algunos servidores puede ser una dirección IP o un nombre como mysql.tudominio.com.

[INFO] Si contrataste un hosting compartido, estos datos suelen estar disponibles en el panel de control de tu hosting (cPanel, Syspanel, Plesk, etc.). Si usas un VPS o servidor dedicado, los creaste tú mismo o tu proveedor te los proporcionó.

Conectar base de datos a PrestaShop durante la instalación

La forma más común de realizar esta conexión es durante el proceso de instalación de PrestaShop. Aquí te explicamos cómo hacerlo paso a paso.

Paso 1: Accede al instalador de PrestaShop

Una vez que hayas subido los archivos de PrestaShop a tu servidor web (generalmente en la carpeta public_html o www), abre tu navegador y escribe la URL de tu dominio. El instalador de PrestaShop se iniciará automáticamente.

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

El asistente te guiará por varias pantallas (selección de idioma, licencia, etc.). Cuando llegues a la sección "Configuración de la base de datos", verás un formulario como este:

Servidor de la base de datos: Aquí coloca localhost a menos que tu proveedor te haya dado otra dirección.
Nombre de la base de datos: Escribe el nombre exacto que creaste (por ejemplo, prestashop_db).
Usuario de la base de datos: El nombre del usuario (por ejemplo, admin_presta).
Contraseña: La contraseña correspondiente.
Prefijo de las tablas: Puedes dejarlo como ps_ o cambiarlo por seguridad (recomendado).

Paso 3: Verifica la conexión

Haz clic en el botón "¡Probar ahora!" o "Comprobar conexión". Si todo está correcto, verás un mensaje verde indicando que la conexión fue exitosa. Si no, revisa los datos ingresados (especialmente el servidor y la contraseña).

[TIP] Si usas un hosting con Syspanel, recuerda que el puerto de acceso al panel es el 2106. No confundas esto con el puerto de la base de datos, que suele ser el 3306 por defecto.

Paso 4: Completa la instalación

Una vez verificada la conexión, continúa con el resto de la instalación (configuración de la tienda, cuenta de administrador, etc.). PrestaShop creará automáticamente todas las tablas necesarias en tu base de datos.

Conectar base de datos a PrestaShop editando el archivo settings.inc.php

A veces, necesitas cambiar la conexión a la base de datos después de la instalación. Por ejemplo, si migraste tu tienda a un nuevo servidor, cambiaste la contraseña de MySQL o necesitas conectar a una base de datos diferente. En estos casos, debes editar el archivo settings.inc.php.

Este archivo es el corazón de la configuración de PrestaShop. Contiene todos los parámetros de conexión a la base de datos y otras configuraciones críticas.

Ubicación del archivo settings.inc.php

El archivo se encuentra en la siguiente ruta dentro de tu instalación de PrestaShop:

/app/config/settings.inc.php

Dependiendo de la versión de PrestaShop, la ruta puede variar ligeramente (por ejemplo, en versiones antiguas estaba en /config/settings.inc.php). En versiones modernas (1.7 y 8.x), la ubicación es la mencionada.

Paso a paso para modificar la conexión

Accede a tu servidor: Puedes hacerlo mediante FTP (con un cliente como FileZilla) o a través del administrador de archivos de tu panel de hosting (cPanel, Syspanel, etc.).
Localiza el archivo: Navega hasta la carpeta app/config y busca el archivo settings.inc.php.
Descarga y haz una copia de seguridad: Antes de editarlo, descarga una copia a tu computadora. Esto es crucial por si algo sale mal.
Edita el archivo: Ábrelo con un editor de texto plano (como Notepad++, Sublime Text o el editor de texto de tu panel). No uses Word o procesadores de texto, ya que pueden agregar caracteres extraños.
Busca las líneas de configuración de la base de datos: Dentro del archivo encontrarás líneas como estas:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_de_tu_base');
define('_DB_USER_', 'usuario_de_tu_base');
define('_DB_PASSWD_', 'contraseña_de_tu_base');
define('_DB_PREFIX_', 'ps_');

Modifica los valores: Cambia cada línea según los nuevos datos de tu base de datos. Por ejemplo:

define('_DB_SERVER_', 'mysql.tudominio.com');
define('_DB_NAME_', 'nueva_base');
define('_DB_USER_', 'nuevo_usuario');
define('_DB_PASSWD_', 'nueva_contraseña');
define('_DB_PREFIX_', 'ps_');

Guarda el archivo: Una vez modificado, guarda los cambios y súbelo al servidor (si lo editaste localmente).
Verifica la conexión: Accede a tu tienda. Si todo está correcto, cargará sin problemas. Si ves un error de conexión a la base de datos, revisa los datos ingresados.

[WARNING] Al editar este archivo, ten cuidado de no borrar o modificar otras líneas. Solo cambia las que empiezan con _DB_. Un error aquí puede dejar tu tienda inaccesible.

Solución de problemas comunes al conectar la base de datos

A veces, incluso siguiendo todos los pasos, pueden surgir problemas. Aquí te explicamos los más comunes y cómo resolverlos.

Error "No se puede conectar a la base de datos"

Este es el error más frecuente. Las causas pueden ser varias:

Datos incorrectos: Revisa el nombre de la base, el usuario y la contraseña. Asegúrate de que no tengan espacios adicionales.
El servidor de la base de datos no es localhost: Algunos proveedores usan direcciones como mysql.tudominio.com o localhost:3306. Consulta con tu hosting.
El usuario no tiene permisos: En MySQL, el usuario debe tener todos los privilegios sobre la base de datos. Puedes verificarlo desde phpMyAdmin o la línea de comandos.

[INFO] Si usas Syspanel, puedes crear y gestionar bases de datos desde el panel. Accede a través del puerto 2106 y busca la sección "Bases de datos". Allí podrás crear usuarios y asignarles permisos.

Error "Tabla no encontrada" o "Prefijo incorrecto"

Si al migrar tu tienda ves errores de tablas faltantes, es posible que el prefijo de las tablas no coincida con el definido en settings.inc.php. Por ejemplo, si tus tablas se llaman prestashop_product pero el archivo dice ps_, PrestaShop buscará ps_product y fallará.

Solución: Cambia el prefijo en settings.inc.php para que coincida con el de tus tablas, o renombra las tablas en la base de datos para que usen el prefijo correcto.

Error "Host 'xxx.xxx.xxx.xxx' no tiene permiso para conectarse"

Este error ocurre cuando el servidor web (donde está instalado PrestaShop) no está autorizado para conectarse al servidor de la base de datos. Es común en configuraciones donde la base de datos está en un servidor diferente.

Solución: Desde phpMyAdmin o la línea de comandos, otorga permisos al usuario para conectarse desde la IP del servidor web. Por ejemplo:

GRANT ALL PRIVILEGES ON nombre_base.* TO 'usuario'@'IP_del_servidor' IDENTIFIED BY 'contraseña';
FLUSH PRIVILEGES;

Preguntas frecuentes (FAQ) sobre conectar base de datos a PrestaShop

Aquí respondemos las dudas más comunes que nos llegan al soporte técnico.

¿Puedo usar una base de datos ya existente para mi nueva instalación de PrestaShop?

Sí, pero ten cuidado. Si la base de datos ya tiene tablas de otra instalación de PrestaShop, podrían generarse conflictos. Lo recomendable es usar una base de datos vacía o, si vas a migrar, sobrescribir las tablas existentes.

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

Puedes restablecerla desde el panel de control de tu hosting. En cPanel, ve a "Bases de datos MySQL" y cambia la contraseña del usuario. En Syspanel, accede por el puerto 2106 y busca la opción "Cambiar contraseña" en la sección de bases de datos.

¿Es seguro modificar el archivo settings.inc.php?

Sí, siempre y cuando tomes precauciones. Haz siempre una copia de seguridad antes de editarlo y asegúrate de que el archivo tenga permisos 644 (lectura para todos, escritura solo para el propietario). Si lo editas desde el panel de archivos, no hay problema.

¿Puedo conectar PrestaShop a una base de datos remota?

Sí, es posible. Solo necesitas que el servidor de la base de datos permita conexiones remotas. En el archivo settings.inc.php, cambia _DB_SERVER_ por la IP o dominio del servidor remoto. Ten en cuenta que esto puede ralentizar la tienda si la latencia es alta.

¿Qué pasa si cambio el nombre de la base de datos después de la instalación?

Si cambias el nombre, debes actualizar el valor de _DB_NAME_ en settings.inc.php. Además, asegúrate de que el usuario tenga permisos sobre la nueva base. Si no lo haces, tu tienda dejará de funcionar.

Consejos finales para una conexión exitosa

Usa contraseñas seguras: Evita contraseñas como "123456" o "admin". Una buena práctica es usar una combinación de letras, números y símbolos.
Haz copias de seguridad periódicas: La base de datos es el activo más valioso de tu tienda. Programa backups automáticos desde tu panel de hosting o con módulos de PrestaShop.
Mantén actualizado PrestaShop: Las versiones más recientes suelen incluir mejoras de seguridad y compatibilidad con las últimas versiones de MySQL.
Si tienes dudas, consulta a tu proveedor de hosting: Ellos conocen la configuración de sus servidores y pueden ayudarte con problemas específicos.

[TIP] Si estás migrando tu tienda a un nuevo servidor, te recomendamos hacer una prueba de conexión antes de cambiar los DNS. Así podrás verificar que todo funciona sin afectar a tus clientes.

Esperamos que esta guía te haya sido de gran ayuda. Conectar tu base de datos a PrestaShop es un proceso sencillo si sigues los pasos correctos. Recuerda que ante cualquier problema, nuestro equipo de soporte está aquí para ayudarte. ¡Buena suerte con tu tienda online!