Conectar PrestaShop a MySQL en cPanel: Configuración

¿Tienes una tienda online con PrestaShop y necesitas conectarla a una base de datos MySQL que ya existe en tu cPanel? Es una operación muy habitual, sobre todo cuando migras una web, restauras una copia de seguridad o cambias de servidor. No te preocupes, porque no necesitas ser un experto en programación para hacerlo. Solo tienes que seguir una serie de pasos lógicos y tener a mano algunos datos importantes.

En esta guía completa y detallada, te explicaré de forma sencilla y paso a paso cómo vincular tu instalación de PrestaShop con una base de datos MySQL alojada en cPanel. Veremos tanto la configuración manual (editando archivos) como la automática (durante el instalador), y resolveremos los problemas más comunes que te puedes encontrar en el camino.

Preparativos iniciales: lo que necesitas antes de empezar

Antes de lanzarnos a configurar nada, es fundamental que tengas claros los datos de acceso a tu base de datos. Si no los tienes a mano, la conexión será imposible. Reúne los siguientes datos:

Nombre de la base de datos: En cPanel, el nombre suele tener un prefijo con tu nombre de usuario, por ejemplo usuariox_bd_tienda.
Nombre de usuario de la base de datos: Similar al anterior, por ejemplo usuariox_admin_tienda.
Contraseña del usuario: La contraseña que asignaste a ese usuario específico de la base de datos (no la de tu cPanel).
Host 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. Este dato es crítico.

[WARNING] No confundas el usuario de la base de datos con el usuario de tu cuenta de cPanel. Aunque el prefijo sea el mismo, son cosas diferentes. La contraseña que necesitas es la del usuario de MySQL, no la de acceso a tu panel de control.

Conectar PrestaShop a MySQL: El método del instalador (si es una instalación nueva)

Si estás instalando PrestaShop desde cero y ya has creado la base de datos en cPanel (vamos a ver cómo hacerlo en un momento), el proceso es muy guiado. El instalador de PrestaShop te preguntará por los datos de la base de datos en uno de sus pasos.

Paso 1: Crear la base de datos y el usuario en cPanel

Si todavía no has creado la base de datos, este es el primer paso. Entra en tu cPanel y busca la sección "Bases de datos MySQL".

En el campo "Crear nueva base de datos", escribe el nombre que quieras (ej. prestashop). El sistema añadirá automáticamente el prefijo de tu usuario. Haz clic en "Crear base de datos".
Baja un poco hasta la sección "Crear usuario de MySQL". Inventa un nombre de usuario (ej. admin_tienda) y una contraseña segura (usa el generador que te ofrece cPanel). Haz clic en "Crear usuario".
Ahora, en la sección "Añadir usuario a la base de datos", selecciona el usuario y la base de datos que acabas de crear y haz clic en "Añadir".
Te aparecerá una ventana emergente para asignar privilegios. Marca la casilla "TODOS LOS PRIVILEGIOS" (o "ALL PRIVILEGES") y haz clic en "Hacer cambios".

[INFO] Es crucial que el usuario tenga "TODOS LOS PRIVILEGIOS" sobre la base de datos para que PrestaShop pueda crear tablas, leer datos, insertar productos, etc. Si solo le das algunos privilegios, la instalación fallará o la tienda no funcionará correctamente.

Paso 2: Ejecutar el instalador de PrestaShop

Ahora, sube los archivos de PrestaShop a tu servidor (por ejemplo, a la carpeta public_html si quieres que tu tienda esté en la raíz de tu dominio) y accede a tu dominio a través del navegador (ej. www.tudominio.com).

El instalador te guiará en varios pasos (idioma, validación de permisos, etc.). Llegará un momento en el que te pedirá los datos de la base de datos. Ahí es donde debes introducir los datos que anotaste antes:

Nombre del servidor de base de datos: Poner localhost (o el host que te haya indicado tu proveedor).
Nombre de la base de datos: El nombre completo que aparece en cPanel (con el prefijo).
Usuario de la base de datos: El nombre completo del usuario (con el prefijo).
Contraseña de la base de datos: La contraseña del usuario.
Prefijo de las tablas: Puedes dejarlo como ps_ por defecto.

El instalador de prestashop conectar mysql cpanel hará la comprobación de la conexión y, si todo es correcto, continuará con la instalación. Si falla, revisa que has copiado bien los nombres y la contraseña.

Configurar PrestaShop con una base de datos existente: El método manual (para migraciones o restauraciones)

Este es el escenario más común cuando ya tienes una tienda funcionando en otro sitio y quieres moverla a un servidor con cPanel, o si has restaurado una copia de seguridad de tu base de datos en un nuevo hosting.

Aquí no ejecutarás el instalador, sino que modificarás el archivo de configuración de PrestaShop para que apunte a la nueva base de datos.

Paso 1: Localizar y editar el archivo `parameters.php`

PrestaShop guarda la configuración de la conexión a la base de datos en un archivo llamado parameters.php. Lo encontrarás en la ruta /config/ dentro de la carpeta raíz donde hayas instalado PrestaShop (normalmente public_html/config/parameters.php).

Accede a tu servidor mediante el Administrador de archivos de cPanel o a través de un cliente FTP (como FileZilla).
Navega hasta la carpeta /config/ y busca el archivo parameters.php.
Haz clic derecho sobre él y selecciona "Editar" (o descárgalo, edítalo con un editor de texto plano como Notepad++ y vuelve a subirlo).

Paso 2: Modificar los parámetros de conexión

Dentro del archivo, verás un array de PHP con varios parámetros. Tienes que buscar las claves que empiezan por database_. Estas son las que nos interesan:

database_host: Este es el host de la base de datos. Casi siempre es localhost, pero verifica este dato en tu cPanel.
database_name: Aquí debes poner el nombre completo de la nueva base de datos (con el prefijo de tu usuario de cPanel).
database_user: El nombre completo del usuario de la base de datos (con el prefijo).
database_password: La contraseña del usuario de la base de datos.
database_prefix: Este es el prefijo de las tablas (ej. ps_). IMPORTANTE: Si estás migrando una tienda, el prefijo debe ser exactamente el mismo que tenía en la base de datos original, de lo contrario, PrestaShop no encontrará sus tablas.

[WARNING] Ten mucho cuidado al editar este archivo. No toques ninguna otra línea que no sean las claves database_. Un solo carácter mal puesto (una comilla, un punto y coma) hará que tu tienda muestre un error de conexión a la base de datos.

Paso 3: Guardar los cambios y verificar

Guarda los cambios en el archivo y, si lo habías descargado, vuelve a subirlo a la misma ruta en el servidor, sobrescribiendo el antiguo.

Ahora, intenta acceder a tu tienda (o al panel de administración /admin). Si los datos son correctos y la base de datos está bien importada, la tienda debería cargar con normalidad.

Solución de problemas comunes al conectar PrestaShop y MySQL

Es muy posible que te encuentres con algún error en el camino. No te preocupes, son los fallos más típicos y casi todos tienen solución.

Error "Fallo al conectar con la base de datos" durante la instalación

Este es el error más común. Las causas suelen ser:

Datos incorrectos: Revisa letra por letra el nombre de la base de datos, el usuario y la contraseña. Asegúrate de incluir el prefijo completo de cPanel.
Host incorrecto: Aunque lo normal es localhost, algunos servidores usan un host específico que puedes encontrar en la sección de "Bases de datos MySQL" de tu cPanel.
El usuario no tiene privilegios: Vuelve a la sección "Añadir usuario a la base de datos" en cPanel y asegúrate de que el usuario tiene TODOS LOS PRIVILEGIOS.

Error "La conexión a la base de datos no se pudo establecer" al abrir la tienda

Esto suele ocurrir después de una migración o cambio de servidor.

El archivo parameters.php no se actualizó: Vuelve a revisar que los datos en este archivo son correctos y que coinciden con los de la nueva base de datos.
El prefijo de las tablas es incorrecto: Si cambiaste el prefijo en el archivo parameters.php pero las tablas en la base de datos tienen otro, la conexión fallará. Deben coincidir exactamente.
La base de datos no se importó correctamente: Asegúrate de haber importado el archivo .sql de tu antigua base de datos en la nueva. Puedes comprobarlo en cPanel, en la sección de "Bases de datos MySQL", viendo el tamaño de la base de datos. Si es muy pequeña (unos pocos KB), es que la importación no se ha hecho bien.

[TIP] Si has migrado la tienda, además de la base de datos, es muy probable que necesites limpiar la caché de PrestaShop. Para ello, borra el contenido de la carpeta /var/cache/ (o /cache/ en versiones antiguas) y la carpeta /var/logs/. Esto forzará a PrestaShop a regenerar los archivos de configuración y puede solucionar muchos errores extraños.

La tienda funciona pero las imágenes no cargan

Esto no es un problema de conexión a la base de datos, sino de rutas de archivos. PrestaShop guarda las rutas absolutas en la base de datos. Para solucionarlo:

Ve a tu panel de administración.
Navega a Parámetros avanzados > Rendimiento.
Activa el "Modo de depuración" o busca la opción de "Forzar la compilación" y actívala.
Guarda los cambios y recarga la tienda. Esto suele regenerar las rutas de las imágenes.

Preguntas frecuentes (FAQ) sobre la conexión de PrestaShop a MySQL

Para terminar, resolvamos algunas dudas que surgen muy a menudo a los usuarios que están configurando prestashop mysql en cPanel.

¿Qué es el host de la base de datos y por qué es `localhost`?

El host es la dirección del servidor donde se encuentra tu base de datos MySQL. En el 99% de los casos, si tu web y tu base de datos están en el mismo servidor (mismo cPanel), el host es localhost. Esto significa que la base de datos está en la misma máquina que tu web, por lo que la conexión es interna y más rápida. Solo si tu proveedor te indica un host específico deberías cambiarlo.

¿Puedo usar la misma base de datos para dos instalaciones de PrestaShop?

Técnicamente sí, pero no es recomendable en absoluto. Cada instalación de PrestaShop necesita su propio conjunto de tablas. Si usas la misma base de datos, tendrás que cambiar el prefijo de las tablas en cada instalación (ej. tienda1_ y tienda2_). Esto puede causar conflictos y problemas de rendimiento. Es mucho más seguro y limpio crear una base de datos independiente para cada tienda.

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

No hay problema. Puedes cambiarla fácilmente desde tu cPanel. Ve a la sección "Bases de datos MySQL", busca la sección de "Usuarios" y haz clic en "Cambiar contraseña" para el usuario que necesitas. Después de cambiarla, tendrás que actualizar el archivo parameters.php con la nueva contraseña.

¿Es necesario usar SSL para la conexión a la base de datos?

No, la conexión entre PrestaShop y MySQL se realiza internamente en el servidor, por lo que no necesita cifrado SSL. El SSL es para la conexión entre el navegador del visitante y tu servidor web (HTTPS), lo cual es totalmente independiente.

Si cambio el prefijo de las tablas, ¿afecta a algo?

Sí, afecta a toda la estructura de la base de datos. Cambiar el prefijo después de la instalación es una tarea compleja que implica renombrar todas las tablas y actualizar algunas configuraciones en la base de datos y en el archivo parameters.php. No lo hagas a menos que sepas exactamente lo que estás haciendo. Es mejor decidir el prefijo al principio.

Espero que esta guía te haya sido de gran ayuda. Con estos pasos y consejos, conectar PrestaShop a una base de datos MySQL existente en cPanel será pan comido. Recuerda siempre verificar los datos y tener paciencia, ¡todo tiene solución!