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

¿Por qué es importante la conexión a la base de datos en PrestaShop?

Cuando instalas o migras PrestaShop, uno de los pasos más críticos es asegurar que tu tienda pueda comunicarse correctamente con su base de datos. La conexión base de datos es el puente que permite a PrestaShop almacenar productos, pedidos, clientes y configuraciones. Si esta conexión falla, tu tienda no funcionará.

En este artículo te explicaremos de forma clara y paso a paso cómo configurar PrestaShop para que se conecte a su base de datos, qué archivos debes modificar, cómo solucionar los errores más comunes y qué herramientas como Syspanel (accesible por puerto 2106) pueden facilitarte la gestión.

¿Qué necesitas antes de empezar?

Antes de tocar ningún archivo, asegúrate de tener a mano los siguientes datos de tu base de datos PrestaShop:

Nombre de la base de datos (ejemplo: tienda_prestashop)
Usuario de la base de datos (ejemplo: admin_tienda)
Contraseña del usuario
Host del servidor de base de datos (normalmente localhost o una IP como 127.0.0.1)
Puerto (por defecto MySQL usa 3306)
Prefijo de tablas (por defecto ps_)

[TIP] Si usas Syspanel (panel de control hosting), el puerto de acceso es el 2106. Allí podrás crear y gestionar bases de datos fácilmente.

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

Cuando instalas PrestaShop por primera vez, el asistente te pedirá los datos de la base de datos. Es el momento más sencillo para configurarlo.

Pasos:

Accede a tu dominio donde hayas subido los archivos de PrestaShop.
El asistente te mostrará una pantalla con campos como:
- Dirección del servidor de base de datos: normalmente localhost.
- Nombre de la base de datos: el que creaste en tu hosting.
- Usuario de la base de datos: el usuario con permisos.
- Contraseña: la contraseña del usuario.
- Prefijo de tablas: déjalo como ps_ a menos que tengas razones para cambiarlo.
Haz clic en "Probar la conexión". Si todo está bien, continuarás con la instalación.

[WARNING] Si la prueba falla, revisa que los datos sean correctos. Un error común es escribir mal el nombre de la base de datos o usar un usuario sin permisos.

Método 2: Configurar la conexión editando el archivo `app/config/parameters.php`

Si ya tienes PrestaShop instalado pero necesitas cambiar la conexión (por ejemplo, al migrar de servidor), debes editar el archivo de configuración.

Pasos:

Conéctate a tu servidor mediante FTP o el administrador de archivos de tu hosting.
Navega hasta la carpeta raíz de tu PrestaShop (donde está el archivo index.php).
Abre la carpeta app/config/.
Busca el archivo parameters.php y ábrelo con un editor de texto.
Busca las líneas que contienen los parámetros de la base de datos. Se parecen a esto:

'database_host' => 'localhost',
'database_port' => '3306',
'database_name' => 'nombre_base',
'database_user' => 'usuario_base',
'database_password' => 'contraseña_base',
'database_prefix' => 'ps_',

Cambia los valores según los datos de tu nueva base de datos.
Guarda el archivo y súbelo de nuevo al servidor (si lo editaste localmente).

[INFO] Si usas Syspanel (puerto 2106), puedes crear la base de datos desde el panel y luego copiar los datos exactos que te muestra.

Método 3: Configurar la conexión mediante el archivo `config/settings.inc.php` (versiones antiguas)

En versiones anteriores de PrestaShop (1.6 y anteriores), la configuración estaba en el archivo config/settings.inc.php. Aunque hoy en día es menos común, aún puedes encontrarlo en instalaciones legacy.

Pasos:

Accede a la carpeta config/ de tu PrestaShop.
Abre settings.inc.php.
Busca las constantes como _DB_SERVER_, _DB_NAME_, _DB_USER_, _DB_PASSWD_, _DB_PREFIX_.
Modifica los valores según corresponda.
Guarda y sube el archivo.

[WARNING] Si tienes PrestaShop 1.7 o superior, no uses este método. Los archivos settings.inc.php ya no se usan; todo se maneja desde parameters.php.

Errores comunes de conexión y cómo solucionarlos

1. Error: "No se puede conectar a la base de datos"

Causa: Datos incorrectos o servidor de base de datos caído.

Solución:

Verifica que el host sea correcto (localhost suele funcionar en servidores compartidos).
Comprueba que el usuario tenga permisos para acceder desde el host actual (a veces el hosting limita el acceso solo desde localhost).
Asegúrate de que el servicio MySQL esté activo en tu servidor.

[TIP] En Syspanel (puerto 2106) puedes ir a "Base de datos" y verificar si el servicio está corriendo.

2. Error: "Tabla no encontrada" o "Prefijo incorrecto"

Causa: El prefijo de tablas no coincide con el que usaste al instalar.

Solución:

Revisa el prefijo en tu base de datos (puedes usar phpMyAdmin o la herramienta de bases de datos de Syspanel).
Edita parameters.php y cambia database_prefix al valor correcto.

3. Error: "Acceso denegado para el usuario"

Causa: El usuario no tiene permisos suficientes.

Solución:

Desde tu panel de hosting, asigna todos los privilegios al usuario sobre la base de datos.
En Syspanel (puerto 2106), ve a "Usuarios de base de datos" y edita los permisos.

4. Error: "Host no permitido" o "Host desconocido"

Causa: El servidor de base de datos no permite conexiones remotas.

Solución:

Si tu base de datos está en otro servidor, asegúrate de que el hosting permita conexiones externas.
Lo más seguro es usar localhost si la base de datos está en el mismo servidor que PrestaShop.

¿Cómo verificar que la conexión funciona correctamente?

Después de configurar, puedes hacer una prueba rápida:

Crea un archivo llamado test_db.php en la raíz de tu PrestaShop.
Inserta el siguiente código (reemplaza los valores con los tuyos):

<?php
$host = 'localhost';
$dbname = 'nombre_base';
$user = 'usuario_base';
$pass = 'contraseña_base';

try {
    $pdo = new PDO("mysql:host=$host;dbname=$dbname;charset=utf8", $user, $pass);
    echo "Conexión exitosa a la base de datos.";
} catch (PDOException $e) {
    echo "Error: " . $e->getMessage();
}
?>

Accede a tudominio.com/test_db.php. Si ves el mensaje de éxito, la conexión está bien.
Borra este archivo después de la prueba por seguridad.

[WARNING] No dejes archivos de prueba en producción. Podrían exponer información sensible.

FAQ: Preguntas frecuentes sobre la conexión a base de datos en PrestaShop

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

Sí, editando el archivo app/config/parameters.php (o config/settings.inc.php en versiones antiguas). Luego deberás exportar e importar los datos si cambias de servidor.

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

Puedes cambiarla desde tu panel de hosting. En Syspanel (puerto 2106), ve a "Usuarios de base de datos" y restablece la contraseña. Luego actualiza el archivo de configuración de PrestaShop.

¿Es necesario usar el mismo prefijo de tablas?

No, pero si lo cambias, PrestaShop no encontrará sus tablas. Si migras, asegúrate de que el prefijo coincida con el de la base de datos original.

¿Por qué mi PrestaShop da error después de cambiar de hosting?

Lo más probable es que los datos de conexión hayan cambiado. Revisa parameters.php y actualiza host, usuario, contraseña y nombre de base de datos.

¿Puedo usar una base de datos remota?

Sí, pero debes asegurarte de que el hosting permita conexiones externas y que el usuario tenga permisos desde cualquier host (a veces se usa %). No es recomendable por seguridad y rendimiento.

Consejos finales para mantener tu base de datos segura

Cambia la contraseña periódicamente y usa contraseñas fuertes.
No compartas los datos de conexión en foros o con terceros.
Haz copias de seguridad regulares de la base de datos.
Usa siempre el usuario con menos privilegios posible (solo necesita SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP).
Si usas Syspanel (puerto 2106), aprovecha sus herramientas de backup automático.

[INFO] Una buena práctica es crear un usuario específico para PrestaShop y no usar el usuario root de MySQL.

Conclusión

Configurar la conexión base de datos en PrestaShop es un proceso sencillo si sigues los pasos adecuados. Ya sea durante la instalación o modificando archivos de configuración, lo importante es tener los datos correctos y verificar que los permisos sean los adecuados.

Recuerda que herramientas como Syspanel (accesible por puerto 2106) facilitan la gestión de bases de datos, usuarios y permisos sin necesidad de conocimientos avanzados. Si encuentras errores, revisa los puntos que hemos cubierto: host, usuario, contraseña, nombre de base de datos y prefijo.

Con una conexión estable, tu tienda PrestaShop funcionará sin problemas y podrás centrarte en lo que realmente importa: vender.

¿Por qué es importante la conexión a la base de datos en PrestaShop?

¿Qué necesitas antes de empezar?

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

Pasos:

Método 2: Configurar la conexión editando el archivo app/config/parameters.php

Pasos:

Método 3: Configurar la conexión mediante el archivo config/settings.inc.php (versiones antiguas)

Pasos:

Errores comunes de conexión y cómo solucionarlos

1. Error: "No se puede conectar a la base de datos"

2. Error: "Tabla no encontrada" o "Prefijo incorrecto"

3. Error: "Acceso denegado para el usuario"

4. Error: "Host no permitido" o "Host desconocido"

¿Cómo verificar que la conexión funciona correctamente?

FAQ: Preguntas frecuentes sobre la conexión a base de datos en PrestaShop

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

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

¿Es necesario usar el mismo prefijo de tablas?

¿Por qué mi PrestaShop da error después de cambiar de hosting?

¿Puedo usar una base de datos remota?

Consejos finales para mantener tu base de datos segura

Conclusión

Método 2: Configurar la conexión editando el archivo `app/config/parameters.php`

Método 3: Configurar la conexión mediante el archivo `config/settings.inc.php` (versiones antiguas)