Configurar conexión a base de datos en PrestaShop con cPanel

¿Por Qué es Importante la Conexión a Base de Datos en PrestaShop?

PrestaShop es una plataforma de comercio electrónico potente y flexible, pero para funcionar necesita un lugar donde almacenar toda la información de tu tienda: productos, clientes, pedidos, configuraciones, etc. Ese lugar es la base de datos, generalmente MySQL. Sin una conexión correcta a la base de datos, tu tienda simplemente no cargará o mostrará errores. Este artículo te guiará paso a paso para configurar esa conexión usando cPanel, la herramienta de gestión de hosting más común.

[INFO] La base de datos es el "cerebro" de tu PrestaShop. Una mala configuración puede provocar desde lentitud hasta la caída total de la tienda.

Requisitos Previos Antes de Empezar

Antes de lanzarte a configurar, asegúrate de tener lo siguiente a mano:

Acceso a cPanel: Necesitas las credenciales de tu cuenta de hosting (usuario y contraseña). Normalmente accedes a través de tudominio.com/cpanel o tudominio.com:2083.
Archivos de PrestaShop: Debes tener los archivos de PrestaShop subidos a tu servidor, ya sea mediante FTP o el gestor de archivos de cPanel. Normalmente van en la carpeta public_html.
Datos de la base de datos: Aunque los crearemos ahora, necesitarás saber el nombre de la base de datos, el usuario y la contraseña que vas a usar.
Paciencia y atención a los detalles: Un simple error tipográfico puede romper la conexión.

Paso 1: Crear la Base de Datos y el Usuario MySQL en cPanel

El primer paso es crear el "almacén" (la base de datos) y la "llave" (el usuario) que PrestaShop usará para acceder.

1.1. Accede al Asistente de Bases de Datos MySQL

Inicia sesión en tu cPanel.
Busca la sección Bases de Datos.
Haz clic en el icono Asistente de Bases de Datos MySQL (o MySQL Database Wizard). Esta herramienta te guiará paso a paso.

1.2. Crea la Base de Datos

En el primer paso, verás un campo para Nombre de la Base de Datos.
Escribe un nombre descriptivo, por ejemplo: tienda_prestashop o mishop_db. cPanel normalmente añade un prefijo con tu nombre de usuario (ej: usuario_tienda_prestashop).
Haz clic en Siguiente Paso.

1.3. Crea un Usuario para la Base de Datos

Ahora verás dos campos: Nombre de Usuario y Contraseña.
Elige un nombre de usuario, por ejemplo: presta_user o admin_db.
Genera una contraseña segura. Puedes usar el generador de contraseñas de cPanel (es muy recomendable). Asegúrate de copiar la contraseña en un lugar seguro (un bloc de notas, por ejemplo), la necesitarás más adelante.
Haz clic en Crear Usuario.

1.4. Asigna Privilegios al Usuario

Este es un paso crítico. Verás una lista de privilegios (permisos) que puedes dar al usuario.
Marca la casilla "TODOS LOS PRIVILEGIOS" para asegurarte de que PrestaShop pueda hacer todo lo necesario (crear tablas, insertar datos, modificar, etc.).
Haz clic en Siguiente Paso.
¡Listo! La base de datos y el usuario han sido creados y vinculados. cPanel te mostrará un resumen con los datos.

[TIP] Anota los siguientes datos en un bloc de notas, los necesitarás en el Paso 2:

Nombre de la Base de Datos: (ej: usuario_tienda_prestashop)

Nombre de Usuario: (ej: usuario_presta_user)

Contraseña: (la que generaste)

Paso 2: Configurar el Archivo `app/config/parameters.php`

PrestaShop guarda los datos de conexión a la base de datos en un archivo de configuración. Este archivo se genera durante la instalación, pero si ya tienes una tienda y necesitas cambiarlo, o si estás migrando, deberás editarlo manualmente.

2.1. Localiza el Archivo

Accede a los archivos de tu tienda. Puedes usar el Gestor de Archivos de cPanel (dentro de la sección "Archivos") o un cliente FTP (como FileZilla).
Navega hasta la carpeta raíz de tu PrestaShop (normalmente public_html).
Dentro, busca la carpeta app, luego config y finalmente el archivo parameters.php.

2.2. Edita el Archivo con los Datos Correctos

Haz clic derecho sobre parameters.php y selecciona Editar (o Code Editor en el Gestor de Archivos de cPanel). Si usas FTP, descárgalo, edítalo con un editor de texto (como Notepad++) y súbelo de nuevo.
Busca las líneas que contienen la configuración de la base de datos. Se parecerán a esto:

<?php
return array(
    'parameters' => array(
        'database_host' => 'localhost',
        'database_port' => '',
        'database_name' => 'TU_NOMBRE_BD',
        'database_user' => 'TU_USUARIO_BD',
        'database_password' => 'TU_CONTRASEÑA_BD',
        'database_prefix' => 'ps_',
        // ... otras configuraciones
    ),
);

Modifica las siguientes líneas con los datos que anotaste en el Paso 1:
- 'database_name': Pega el Nombre de la Base de Datos completo (ej: usuario_tienda_prestashop).
- 'database_user': Pega el Nombre de Usuario completo (ej: usuario_presta_user).
- 'database_password': Pega la Contraseña que generaste.
Deja 'database_host' como 'localhost' a menos que tu hosting te indique lo contrario (es muy raro que cambie).
Deja 'database_port' vacío o como '' a menos que uses un puerto MySQL no estándar (tu hosting te informaría).
'database_prefix': Por defecto es ps_. Si estás migrando desde otra instalación, asegúrate de que coincida con el prefijo de las tablas de tu base de datos anterior.

2.3. Guarda los Cambios

Una vez que hayas reemplazado todos los datos, guarda el archivo (Ctrl+S o Cmd+S).
Si estás usando el editor de cPanel, el archivo se guardará automáticamente en el servidor. Si usaste FTP, sube el archivo modificado a la misma ubicación, sobrescribiendo el original.

[WARNING] ¡Cuidado con los caracteres especiales! Si tu contraseña contiene caracteres como $, \ o ', podrían romper el código PHP. Si es posible, genera una contraseña sin estos caracteres. Si ya la tienes, asegúrate de que esté escapada correctamente (con \ antes del carácter). Si no estás seguro, es mejor generar una nueva contraseña en cPanel.

Paso 3: Verificar la Conexión

Una vez que has configurado todo, es hora de probar que funciona.

3.1. Accede a tu Tienda

Abre tu navegador web e intenta acceder a la URL de tu tienda PrestaShop (ej: tudominio.com).
Si la configuración es correcta, la tienda debería cargar sin problemas.
Si ves un mensaje de error como "Error de conexión a la base de datos" o "No se puede conectar al servidor de base de datos", algo ha salido mal.

3.2. Solución de Problemas Comunes

Si la tienda no carga, repasa estos puntos:

¿Los datos son correctos? Revisa el archivo parameters.php letra por letra. Un error tipográfico en el nombre de la base de datos o la contraseña es la causa más común.
¿El usuario tiene todos los privilegios? Vuelve a cPanel, entra en "Bases de Datos MySQL", busca tu base de datos y usuario, y asegúrate de que tenga marcados "TODOS LOS PRIVILEGIOS".
¿El servidor MySQL está funcionando? A veces el hosting tiene problemas. Contacta con tu proveedor de hosting para verificarlo.
¿El archivo parameters.php tiene los permisos correctos? Debe tener permisos 644 o 640. En cPanel, puedes cambiar los permisos haciendo clic derecho sobre el archivo y seleccionando "Cambiar permisos".
¿Estás usando el prefijo de tabla correcto? Si es una instalación nueva, ps_ está bien. Si migraste, debe coincidir con el de tu base de datos anterior.

Paso 4: Configuración Avanzada (Opcional)

Si tu tienda tiene mucho tráfico, puedes optimizar la conexión a la base de datos.

4.1. Usar un Host de Base de Datos Diferente

En entornos de alto rendimiento, a veces la base de datos está en un servidor separado. En ese caso, el 'database_host' no sería 'localhost', sino una dirección IP o un nombre de dominio (ej: db.tudominio.com). Tu proveedor de hosting te dará esta información.

4.2. Configurar un Puerto Personalizado

Si tu base de datos MySQL usa un puerto no estándar (el estándar es el 3306), deberás especificarlo en 'database_port' (ej: '3307').

Preguntas Frecuentes (FAQ)

1. ¿Qué hago si pierdo la contraseña de la base de datos?

Puedes cambiarla desde cPanel. Ve a "Bases de Datos MySQL", busca tu usuario y haz clic en "Cambiar contraseña". Luego, actualiza el archivo parameters.php con la nueva contraseña.

2. ¿Puedo usar la misma base de datos para dos tiendas PrestaShop diferentes?

No es recomendable. Cada tienda PrestaShop debe tener su propia base de datos para evitar conflictos y mezcla de datos. Si usas la misma, los datos se sobrescribirán y causarán errores graves.

3. Mi hosting usa Syspanel (HestiaCP) en lugar de cPanel. ¿Cómo configuro la base de datos?

Si tu hosting usa Syspanel (el panel de control que antes se llamaba HestiaCP), el proceso es similar pero la interfaz es diferente. Accede a tu Syspanel a través del puerto 2106 (ej: tudominio.com:2106). Busca la sección "Base de Datos" y crea una nueva. Los pasos son análogos: crear base de datos, crear usuario y asignar privilegios. Luego, edita el archivo parameters.php con los mismos datos.

[INFO] El puerto de acceso a Syspanel es el 2106. No lo olvides.

4. ¿Es seguro editar el archivo parameters.php?

Sí, siempre y cuando tengas cuidado. No borres ninguna otra línea del archivo y asegúrate de que la sintaxis PHP siga siendo correcta (cada línea termina en , y el array está bien cerrado). Siempre es buena idea hacer una copia de seguridad del archivo original antes de editarlo.

5. ¿Qué significa el error "Tabla 'xxxx' no existe"?

Esto suele ocurrir si el prefijo de la base de datos ('database_prefix') en parameters.php no coincide con el prefijo real de las tablas en tu base de datos. Revisa ambas cosas y ajústalas para que coincidan.

6. Después de cambiar la configuración, la tienda sigue mostrando un error. ¿Qué hago?

Prueba a borrar la carpeta var/cache/ de tu instalación de PrestaShop. Esto obliga a PrestaShop a regenerar los archivos de caché y puede solucionar errores persistentes. Puedes hacerlo desde el Gestor de Archivos de cPanel.

Conclusión

Configurar la conexión a la base de datos en PrestaShop con cPanel es un proceso sencillo si sigues los pasos correctos. Lo más importante es tener a mano los datos correctos y prestar atención a los detalles al editarlos. Con esta guía, podrás solucionar la mayoría de los problemas de conexión y mantener tu tienda funcionando sin contratiempos. Recuerda que si tienes dudas, tu proveedor de hosting siempre puede ayudarte.