Conectar PrestaShop a MySQL: Guía para cPanel y Plesk

Conectar PrestaShop a una base de datos MySQL es uno de los pasos más críticos durante la instalación o migración de tu tienda online. Sin una conexión correcta, tu catálogo de productos, pedidos y clientes simplemente no funcionarán.

Si estás usando un panel de control como cPanel o Plesk, el proceso es bastante sencillo, pero hay que prestar atención a los detalles. En esta guía extensa y paso a paso, te explicaré cómo hacerlo desde cero, sin necesidad de ser un experto en programación.

Vamos a desglosar todo el proceso, desde la creación de la base de datos hasta la configuración final en el archivo parameters.php de PrestaShop.

1. Preparación: Qué necesitas antes de empezar

Antes de lanzarte a escribir comandos o rellenar formularios, es importante que tengas a mano tres datos clave que te pedirán tanto cPanel como Plesk:

Nombre de la base de datos: Lo elegirás tú o el sistema lo generará (ej: tienda_shop).
Nombre de usuario de la base de datos: Debe tener permisos sobre la base de datos (ej: tienda_admin).
Contraseña del usuario: Debe ser segura, con mayúsculas, minúsculas y números.

Además, necesitas saber el nombre del servidor de la base de datos (host). En el 90% de los casos, en cPanel y Plesk será localhost, pero en algunos servidores dedicados o VPS puede ser una IP como 127.0.0.1 o un nombre tipo mysql.tudominio.com.

[INFO] Si no sabes cuál es tu host, mira el correo de bienvenida de tu proveedor de hosting o consulta el panel de administración. Usar localhost es la opción estándar para hosting compartido.

2. Conectar PrestaShop a MySQL en cPanel

cPanel es el panel más común en el hosting compartido. Su interfaz es amigable, pero hay que saber dónde mirar. Vamos a dividir el proceso en dos fases: crear la base de datos y luego conectar PrestaShop.

2.1. Crear la base de datos y el usuario en cPanel

Este paso es obligatorio si estás haciendo una instalación manual. Si tu hosting tiene "Instalador de aplicaciones" (Softaculous), normalmente se hace solo, pero saber hacerlo manualmente te salvará en el futuro.

Inicia sesión en cPanel con tu usuario y contraseña.
Busca la sección "Bases de Datos" y haz clic en "Bases de Datos MySQL®".
En el campo "Crear nueva base de datos", escribe un nombre (ej: prestashop_db). El sistema añadirá automáticamente tu prefijo de usuario (ej: usuario_prestashop_db). Anota el nombre completo.
Haz clic en "Crear base de datos" y luego en "Volver".
Ahora, baja hasta la sección "Usuarios de MySQL" y crea un nuevo usuario. Rellena el nombre de usuario y una contraseña robusta. Haz clic en "Crear usuario".
Verás una sección llamada "Añadir usuario a la base de datos". Selecciona el usuario que acabas de crear y la base de datos que creaste antes. Haz clic en "Añadir".
IMPORTANTE: Te aparecerá una lista de privilegios (permisos). Marca la casilla "TODOS LOS PRIVILEGIOS" para que PrestaShop pueda leer, escribir y modificar tablas sin errores. Haz clic en "Hacer cambios".

[WARNING] No olvides el prefijo del usuario. En cPanel, el nombre completo del usuario suele ser tuusuario_nombre. Si no lo copias entero, la conexión fallará.

2.2. Configurar PrestaShop con los datos de cPanel

Ahora que ya tienes la base de datos vacía, toca decirle a PrestaShop dónde y cómo conectarse. Esto ocurre durante el asistente de instalación web.

Sube los archivos de PrestaShop a tu servidor (normalmente en public_html).
Abre tu navegador y escribe tudominio.com. Se iniciará el asistente de instalación.
Sigue los pasos hasta llegar a la pantalla de "Configuración de la base de datos".
Rellena los campos con los datos de cPanel:
- Dirección del servidor de base de datos: localhost (o la que te indique tu hosting).
- Nombre de la base de datos: El nombre completo que copiaste antes (ej: usuario_prestashop_db).
- Usuario de la base de datos: El nombre completo del usuario (ej: usuario_admin).
- Contraseña de la base de datos: La que pusiste al crear el usuario.
- Prefijo de las tablas: Déjalo como ps_ a menos que tengas una razón específica para cambiarlo.
Haz clic en "Probar la conexión". Si todo es correcto, verás un mensaje verde de éxito. Si no, revisa los nombres y la contraseña.

[TIP] Si tu hosting tiene el puerto MySQL personalizado (ej: 3307), el campo de servidor debe ser localhost:3307. Pregunta a tu proveedor si no estás seguro.

3. Conectar PrestaShop a MySQL en Plesk

Plesk es otro panel muy popular, especialmente en VPS y servidores dedicados con interfaz gráfica. La lógica es la misma, pero la interfaz cambia.

3.1. Crear la base de datos y el usuario en Plesk

Plesk suele ser más directo que cPanel, ya que te permite crear la base de datos y el usuario en un solo paso.

Inicia sesión en Plesk (normalmente en tudominio.com:8443).
En el menú lateral izquierdo, haz clic en "Bases de datos".
Haz clic en el botón "Agregar base de datos" (o "+").
Rellena el formulario:
- Nombre de la base de datos: Elige uno (ej: tienda_presta).
- Tipo de base de datos: Selecciona MySQL.
- Servidor de base de datos: Si tienes varios, elige el principal (normalmente localhost).
En la sección "Usuario de la base de datos", marca la opción "Crear nuevo usuario".
Introduce el nombre de usuario y una contraseña.
Haz clic en "Aceptar".

Plesk creará automáticamente el usuario con todos los privilegios necesarios sobre esa base de datos. No necesitas gestionar permisos manualmente como en cPanel, aunque puedes hacerlo si entras en la base de datos y vas a la pestaña "Usuarios".

3.2. Configurar PrestaShop con los datos de Plesk

El proceso de instalación de PrestaShop es idéntico al de cPanel, solo cambian los datos que introduces.

Ejecuta el instalador de PrestaShop en tu navegador.
Cuando llegues a la pantalla de base de datos, introduce:
- Servidor: localhost (o el que aparece en Plesk).
- Nombre BD: El nombre que pusiste en Plesk (ej: tienda_presta).
- Usuario: El usuario que creaste en Plesk.
- Contraseña: La contraseña del usuario.
Haz clic en "Probar conexión".

[INFO] En Plesk, a diferencia de cPanel, el nombre de la base de datos y el usuario no llevan prefijos adicionales. Usa el nombre exacto que escribiste en el formulario.

4. ¿Y si ya tengo PrestaShop instalado? (Migración o cambio de servidor)

A veces no estás instalando desde cero, sino que estás moviendo tu tienda a un nuevo hosting. En ese caso, no ejecutas el asistente, sino que editas un archivo.

El archivo clave se llama parameters.php y se encuentra en la carpeta app/config/ de tu instalación de PrestaShop.

Conéctate a tu hosting por FTP (FileZilla, por ejemplo) o usa el administrador de archivos de cPanel/Plesk.
Navega a app/config/.
Descarga el archivo parameters.php y ábrelo con un editor de texto (Notepad++ o Sublime Text).
Busca el bloque que dice 'database_host', 'database_name', 'database_user' y 'database_password'.

El bloque se verá así:

'database_host' => 'localhost',
'database_name' => 'tu_bd',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña',
'database_prefix' => 'ps_',

Edita los valores con los nuevos datos de tu cPanel o Plesk.
Guarda el archivo y súbelo de nuevo al servidor, sobrescribiendo el antiguo.

[WARNING] Haz una copia de seguridad del archivo original antes de modificarlo. Un error de sintaxis (una comilla mal puesta) puede dejar tu tienda completamente inaccesible.

5. Solución de problemas comunes (FAQ)

Aquí te dejo las dudas más frecuentes que nos llegan al soporte. Si algo falla, revisa esta lista antes de llamarnos.

5.1. "Error de conexión a la base de datos" al instalar

Esto es lo más común. Las causas suelen ser:

Nombre de usuario o base de datos mal escritos. Revisa los prefijos (en cPanel) y los caracteres especiales.
Contraseña incorrecta. Asegúrate de que no tienes el Bloq Mayús activado.
El usuario no tiene permisos. En cPanel, vuelve a la sección "Añadir usuario a la base de datos" y verifica que tenga "TODOS LOS PRIVILEGIOS".
El host no es localhost. Si tu hosting usa un host remoto, no funcionará. Revisa la documentación de tu proveedor.

5.2. "Tabla no encontrada" o "Prefijo incorrecto"

Esto ocurre si intentas conectar PrestaShop a una base de datos que ya tiene tablas de otra instalación (por ejemplo, WordPress). PrestaShop necesita una base de datos vacía o usar un prefijo diferente. Si estás migrando, asegúrate de que el prefijo en parameters.php coincide con el de las tablas que importaste.

5.3. ¿Puedo usar la misma base de datos para dos tiendas?

Técnicamente sí, pero no es recomendable. Usa prefijos distintos (ps_ para una y shop2_ para otra) para evitar conflictos. Es mucho más limpio crear una base de datos separada para cada tienda.

5.4. ¿Qué hago si mi hosting usa Syspanel?

Si tu proveedor usa el panel Syspanel (antes conocido como HestiaCP), el proceso es muy similar al de Plesk. La diferencia principal es que el acceso al panel se realiza a través del puerto 2106 (ej: tudominio.com:2106). Dentro de Syspanel, busca la sección "Bases de Datos" y crea una nueva. El host de la base de datos también será localhost en la mayoría de los casos.

[INFO] Syspanel es una alternativa moderna a cPanel/Plesk. Si ves ese nombre en tu área de cliente, ya sabes cómo acceder: puerto 2106.

5.5. Error "Connection refused" o "No such file or directory"

Esto suele pasar en servidores VPS donde MySQL no está escuchando en el puerto estándar. Si el host es localhost, prueba a cambiarlo por 127.0.0.1. Si sigue fallando, contacta con tu proveedor, ya que puede ser un problema de configuración del servidor.

6. Consejos finales de rendimiento y seguridad

Conectar PrestaShop a MySQL es solo el primer paso. Para que tu tienda vuele, ten en cuenta lo siguiente:

Utiliza un prefijo de tabla personalizado (ps_ es el estándar, pero si usas algo como mishop_, dificultas los ataques por inyección SQL automatizados).
No uses la cuenta root de MySQL para la tienda. Siempre crea un usuario específico con permisos limitados a esa base de datos.
Si tu base de datos crece mucho, considera usar el motor InnoDB (el predeterminado en PrestaShop 8) para mejor integridad de datos.
Haz copias de seguridad periódicas de la base de datos. En cPanel puedes usar "Backup" y en Plesk la herramienta "Copias de seguridad". No confíes solo en el hosting.

Conclusión

Conectar PrestaShop a una base de datos MySQL no es un misterio. Tanto en cPanel como en Plesk, el proceso se reduce a crear un recurso (la BD), crear un usuario con permisos y luego introducir esos datos en el instalador o en el archivo parameters.php.

La clave del éxito está en copiar exactamente los nombres completos (especialmente en cPanel con los prefijos) y en verificar los permisos. Si sigues los pasos de esta guía, tendrás tu tienda online funcionando en menos de lo que tardas en tomarte un café.

Si a pesar de todo te surge un error, recuerda revisar la sección de preguntas frecuentes (FAQ) de este mismo artículo. Y si el problema persiste, nuestro equipo de soporte está a un clic de distancia para ayudarte a configurar PrestaShop con tu base de datos sin dolores de cabeza.