Conectar PrestaShop a MySQL en cPanel: Guía rápida y segura

Antes de Empezar: ¿Por Qué PrestaShop Necesita una Base de Datos MySQL?

Cuando instalas PrestaShop, no solo subes archivos a tu hosting. La tienda necesita un lugar donde guardar toda su información: productos, clientes, pedidos, precios, configuraciones y contraseñas. Ese "almacén" es una base de datos MySQL.

Piensa en la base de datos como el cerebro de tu tienda online. Sin ella, PrestaShop no puede recordar nada y, por tanto, no puede funcionar. Por eso, conectar PrestaShop con MySQL en cPanel es uno de los pasos más críticos durante la instalación o al migrar tu tienda a un nuevo servidor.

Si alguna vez ves un mensaje de error conexión PrestaShop, casi siempre significa que los datos de acceso a esa base de datos no son correctos o que la base de datos no existe. No te preocupes: en esta guía te lo explico todo paso a paso para que lo hagas sin miedo y sin necesitar ser un experto en informática.

¿Qué Necesitas Antes de Conectar PrestaShop a MySQL en cPanel?

Antes de lanzarnos a los pasos, asegúrate de tener a mano estos tres datos:

El nombre de tu base de datos MySQL (lo crearemos en cPanel).
El nombre de usuario de esa base de datos (también lo crearemos).
La contraseña de ese usuario.

Además, necesitas tener instalado PrestaShop en tu hosting (es decir, haber subido los archivos a la carpeta public_html o a una subcarpeta). Si aún no lo has subido, no pasa nada, pero esta guía asume que ya tienes los archivos de PrestaShop en tu servidor.

Paso 1: Encontrar el Asistente de "Bases de Datos MySQL" en cPanel

Lo primero es acceder a tu panel de control de cPanel. Normalmente se accede a través de una URL como tudominio.com/cpanel o cpanel.tudominio.com. Introduce tu usuario y contraseña.

Una vez dentro, busca la sección "Bases de Datos". En la mayoría de los temas de cPanel, verás un icono que dice "Bases de Datos MySQL" o "MySQL Databases". Haz clic ahí.

[INFO]:
Si tu cPanel está en inglés, no te preocupes. Busca las palabras "MySQL Databases". La interfaz es muy visual y los iconos suelen ser un cilindro o un servidor de base de datos.

Paso 2: Crear la Base de Datos para PrestaShop

Ya estás en la página de administración de bases de datos. Ahora vamos a crear el "almacén" donde PrestaShop guardará todo.

Encuentra el campo "Create New Database" (Crear nueva base de datos). Suele estar en la parte superior de la página.
Escribe un nombre para tu base de datos. Te sugiero algo como prestashop_db o tienda_online. Un consejo: usa solo letras minúsculas, números y guiones bajos (_). No uses espacios ni caracteres raros como ñ o ç.
Haz clic en el botón "Create Database" (Crear base de datos).

cPanel te mostrará un mensaje de confirmación como "Database created". ¡Perfecto! Ya tienes el primer ingrediente. Anota el nombre completo de la base de datos, porque cPanel suele añadir un prefijo con tu nombre de usuario (por ejemplo, usuariohosting_prestashop_db).

Paso 3: Crear un Usuario para la Base de Datos

Ahora necesitamos crear un "usuario" que tenga permiso para entrar en esa base de datos. Este usuario será el que PrestaShop usará para comunicarse con el cerebro de la tienda.

Baja un poco en la misma página hasta encontrar la sección "MySQL Users" (Usuarios MySQL) o "Add New User" (Añadir nuevo usuario).
Escribe un nombre de usuario. Por ejemplo, prestauser o tienda_user. Recuerda, cPanel le añadirá el prefijo de tu cuenta (ej: usuariohosting_prestauser).
Crea una contraseña segura. Usa una combinación de letras mayúsculas, minúsculas, números y símbolos. cPanel tiene un generador de contraseñas que puedes usar (el botón "Generate Password"). Anota esta contraseña en un lugar seguro, porque la necesitarás muy pronto.
Haz clic en "Create User" (Crear usuario).

Paso 4: Añadir el Usuario a la Base de Datos y Darle Permisos

Este es el paso que mucha gente olvida y que causa el temido error conexión PrestaShop. No basta con crear la base y el usuario por separado; hay que "unirlos" y darles permisos.

Busca la sección "Add User to Database" (Añadir usuario a la base de datos). Suele estar un poco más abajo en la misma página.
En el primer desplegable, selecciona el usuario que acabas de crear.
En el segundo desplegable, selecciona la base de datos que creaste en el Paso 2.
Haz clic en "Add" (Añadir).

Inmediatamente, cPanel te mostrará una lista de privilegios (permisos). Aquí tienes que marcar la opción que dice "ALL PRIVILEGES" (Todos los privilegios). Esto le da al usuario control total sobre la base de datos, que es justo lo que PrestaShop necesita para funcionar correctamente.

Haz clic en "Make Changes" (Hacer cambios) o "Update".

[TIP]:
Aunque solo necesites algunos permisos, es recomendable dar "ALL PRIVILEGES" para PrestaShop. Así evitas errores extraños en el futuro cuando intentes instalar módulos o actualizar la tienda.

Paso 5: Configurar PrestaShop para Conectar con la Base de Datos

Ahora viene la parte emocionante. Vamos a decirle a PrestaShop dónde está su base de datos y cómo acceder a ella. Esto se hace durante el proceso de instalación.

Abre tu navegador y visita la URL donde has subido los archivos de PrestaShop. Por ejemplo, tudominio.com o tudominio.com/prestashop.
Se iniciará el asistente de instalación de PrestaShop. Selecciona tu idioma y continúa hasta llegar al paso de "System Compatibility" (Compatibilidad del sistema). Si todo está en verde, continúa.
Llegarás a un paso llamado "Store Information" (Información de la tienda). Rellena estos datos (nombre de la tienda, actividad, país, etc.). Importante: Aquí te pedirá una cuenta de administrador. Guarda bien este correo y contraseña, porque será tu acceso al panel de administración de la tienda.
El siguiente paso es "Database Configuration" (Configuración de la base de datos). ¡Aquí es donde ocurre la magia!

En esta pantalla, PrestaShop te pedirá los siguientes datos:

Database Engine (Motor de base de datos): Déjalo en MySQL o InnoDB.
Database Server Address (Dirección del servidor): Aquí normalmente escribes localhost. En la mayoría de los hosts con cPanel, la base de datos está en el mismo servidor que tu sitio web, así que localhost es correcto. Si tu hosting usa un servidor de base de datos externo, te lo habrán indicado en un correo de bienvenida.
Database Name (Nombre de la base de datos): Escribe el nombre completo que viste en cPanel, incluyendo el prefijo (ej: usuariohosting_prestashop_db).
Database Login (Usuario de la base de datos): Escribe el nombre de usuario completo que creaste (ej: usuariohosting_prestauser).
Database Password (Contraseña de la base de datos): Escribe la contraseña que asignaste a ese usuario.
Database Prefix (Prefijo de las tablas): Puedes dejarlo como ps_. Es un prefijo que se añade a las tablas de la base de datos. Si estás migrando una tienda, asegúrate de que coincida con el prefijo original.

Haz clic en "Test your database connection now!" (¡Prueba tu conexión a la base de datos ahora!). Si todo es correcto, verás un mensaje verde de éxito. Si no, revisa los datos, especialmente el nombre de usuario y la base de datos (recuerda que cPanel añade prefijos).

Paso 6: Finalizar la Instalación

Una vez que la conexión sea exitosa, PrestaShop continuará con la instalación. Este proceso puede tardar unos minutos. Verás una barra de progreso.

Cuando termine, verás un resumen con los datos de tu tienda y el enlace al panel de administración. ¡Enhorabuena! Ya has conseguido conectar PrestaShop con MySQL en cPanel.

Resolución de Problemas: El Temido "Error Conexión PrestaShop"

Es muy común encontrarse con el mensaje "Error de conexión a la base de datos" o "Database connection failed" durante la instalación. No es el fin del mundo. Aquí tienes las causas más habituales y cómo solucionarlas:

1. El Nombre de la Base de Datos o Usuario es Incorrecto

Como mencioné antes, cPanel añade un prefijo. Si tu cuenta se llama juanperez y creaste una base llamada prestashop_db, el nombre real es juanperez_prestashop_db. Lo mismo con el usuario. Revisa en cPanel el nombre exacto que aparece en la lista de bases de datos y usuarios.

2. Contraseña Incorrecta

Asegúrate de no tener el bloqueo de mayúsculas activado. Copia y pega la contraseña directamente desde el lugar donde la guardaste para evitar errores tipográficos.

3. El Usuario No Tiene Permisos Sobre la Base de Datos

Vuelve al Paso 4. Asegúrate de que el usuario está añadido a la base de datos y que tiene "ALL PRIVILEGES". Si no, PrestaShop no podrá crear sus tablas.

4. El Host de la Base de Datos No Es "localhost"

Algunos hosts (especialmente los de gama alta) usan servidores de bases de datos separados. Si localhost no funciona, prueba con 127.0.0.1 o busca en la documentación de tu hosting el nombre del servidor MySQL (suele ser algo como mysql.tudominio.com).

5. Puertos de Conexión

A veces, el servidor de base de datos no usa el puerto estándar (3306). Si tu hosting usa un puerto diferente, te lo indicarán. En PrestaShop, en el campo de dirección del servidor, puedes escribir algo como localhost:3307 para especificar el puerto.

Preguntas Frecuentes (FAQ) sobre la Conexión de PrestaShop y MySQL

¿Qué hago si ya tengo una tienda y quiero moverla a otro hosting con cPanel?

En ese caso, no usas el instalador estándar. Debes:

Exportar tu base de datos antigua (con phpMyAdmin o una herramienta similar).
Crear la base de datos y el usuario en el nuevo cPanel (Pasos 1-4).
Importar tu base de datos antigua en la nueva.
Subir los archivos de PrestaShop.
Editar el archivo parameters.php que se encuentra en la carpeta app/config/ de tu PrestaShop. Ahí pondrás los nuevos datos de conexión (nombre de base, usuario y contraseña).

¿Puedo usar el mismo usuario de la base de datos para dos tiendas PrestaShop?

Técnicamente sí, pero no es recomendable. Si usas el mismo usuario para dos bases de datos, un error en una tienda podría afectar a la otra. Es mucho más seguro crear un usuario y una base de datos independientes para cada tienda.

¿Qué es el prefijo `ps_` que me pide PrestaShop?

Es un texto que se añade al principio de cada tabla de la base de datos. Por ejemplo, la tabla de productos se llamará ps_product. Esto sirve para que, si compartes la base de datos con otra aplicación, no haya conflictos de nombres. Puedes cambiarlo por cualquier cosa, pero lo más común es dejarlo como ps_.

¿Cómo puedo hacer una copia de seguridad de mi base de datos de PrestaShop?

En cPanel, busca la herramienta "phpMyAdmin". Dentro, selecciona tu base de datos, ve a la pestaña "Exportar" y elige el método "Rápido" y formato SQL. Descargarás un archivo con todos los datos. Es recomendable hacer esto antes de cualquier actualización grande.

Conclusión Final

Conectar PrestaShop con una base de datos MySQL en cPanel es un proceso de 4 pasos fundamentales: crear la base, crear el usuario, unirlos con permisos y usar esos datos exactos en el instalador. La clave del éxito está en la precisión de los nombres y en asegurarse de que el usuario tiene todos los privilegios.

No temas a los errores. Un mensaje de error conexión PrestaShop solo significa que alguno de esos datos no coincide. Vuelve a cPanel, verifica los nombres y prueba de nuevo. Es un proceso que, una vez que lo has hecho, te resultará muy sencillo.

[WARNING]:
Nunca compartas tu contraseña de la base de datos en foros públicos o con soportes no oficiales. Es la llave de acceso a la información más sensible de tu tienda, como datos de clientes y pedidos.

Si has seguido todos los pasos al pie de la letra, tendrás tu tienda online funcionando en muy poco tiempo. ¡Buena suerte con tu nuevo proyecto de e-commerce!