Conectar PrestaShop a MySQL en cPanel | Configuración

¿Qué necesitas saber antes de conectar PrestaShop a MySQL?

Conectar tu tienda PrestaShop a una base de datos MySQL es uno de los pasos más importantes durante la instalación o migración de tu negocio online. Sin una conexión correcta, tu tienda simplemente no funcionará, ya que todos los productos, pedidos, clientes y configuraciones se guardan en esa base de datos.

Si estás usando cPanel como panel de control de tu hosting, el proceso es bastante sencillo, pero requiere que prestes atención a los parámetros exactos. Un error común es confundir el nombre de la base de datos con el nombre de usuario, o no recordar que en la mayoría de los hosts compartidos, el prefijo de tu cuenta se añade automáticamente.

En esta guía vamos a desglosar todo el proceso paso a paso, desde cómo crear la base de datos en cPanel hasta qué valores exactos debes escribir en el instalador de PrestaShop. También resolveremos las dudas más frecuentes para que no te quedes atascado a mitad de camino.

Primer paso: Crear la base de datos MySQL en cPanel

Antes de intentar conectar PrestaShop a MySQL, necesitas tener una base de datos creada y un usuario con permisos. Muchos usuarios novatos intentan usar bases de datos existentes de otras aplicaciones, y eso casi siempre genera conflictos.

Localiza la sección de Bases de Datos en cPanel

Entra en tu cPanel y busca la sección "Bases de Datos MySQL" o "Asistentes de Bases de Datos MySQL". Dependiendo del tema de tu cPanel, puede aparecer con nombres ligeramente distintos, pero siempre estará dentro del grupo de herramientas de bases de datos.

Crea una nueva base de datos

Haz clic en "Crear nueva base de datos" y escribe un nombre descriptivo. Por ejemplo: tienda_prestashop. No uses espacios ni caracteres raros, solo letras minúsculas, números y guiones bajos.

IMPORTANTE: En la mayoría de los hosts compartidos, el nombre final de tu base de datos será algo como tuusuario_tiendaprestashop. El sistema añade automáticamente tu nombre de usuario de cPanel como prefijo. Deberás usar el nombre completo cuando configures PrestaShop.

Crea un usuario para la base de datos

En la misma sección, busca "Crear usuario". Elige un nombre de usuario fácil de recordar, por ejemplo: presta_user. También tendrás que asignar una contraseña segura. Usa el generador de contraseñas de cPanel si no sabes cómo crear una que sea fuerte.

Tip de seguridad: Guarda esta contraseña en un gestor de contraseñas. La necesitarás en el siguiente paso y también si algún día tienes que migrar tu tienda.

Asigna todos los privilegios al usuario

Ahora viene el paso crítico: vincular el usuario con la base de datos. En la sección "Añadir usuario a la base de datos", selecciona el usuario y la base de datos que acabas de crear. Después, marca "Todos los privilegios" y haz clic en "Hacer cambios".

[!WARNING]
[WARNING] Sin privilegios completos, PrestaShop no podrá crear tablas ni escribir datos. Si solo marcas algunos privilegios, la instalación fallará o tu tienda dará errores raros al guardar productos o pedidos.

Los 5 parámetros que PrestaShop te pedirá para conectar a MySQL

Cuando ejecutas el instalador de PrestaShop (o cuando configuras el archivo parameters.php manualmente), te solicitará exactamente estos datos:

1. Dirección del servidor de base de datos (host)

El valor más común es localhost. En la gran mayoría de hosts compartidos con cPanel, este valor funciona perfectamente porque tu sitio web y la base de datos están en el mismo servidor.

Sin embargo, hay excepciones. Algunos proveedores de hosting usan servidores de bases de datos separados. En ese caso, cPanel te mostrará un nombre de host como mysql.tudominio.com o localhost:3306. Revisa el correo de bienvenida de tu hosting o la documentación de tu proveedor si localhost no funciona.

[!TIP]
[TIP] Si estás migrando una tienda desde otro hosting, no uses la IP remota de tu antiguo servidor. La base de datos debe estar en el mismo hosting donde está instalado PrestaShop, a menos que uses un servicio externo como RDS de AWS (no recomendado para principiantes).

2. Nombre de la base de datos

Aquí debes escribir el nombre completo, incluyendo el prefijo de tu cuenta. Si tu usuario de cPanel es juanperez y creaste una base llamada tienda_prestashop, el valor será:

juanperez_tiendaprestashop

No se te olvide el guion bajo entre tu usuario y el nombre de la base. Este es uno de los errores más comunes entre quienes intentan conectar PrestaShop a MySQL por primera vez.

3. Usuario de la base de datos

Igual que con el nombre, el usuario también lleva el prefijo. Si creaste el usuario presta_user, el valor final será:

juanperez_prestauser

Algunos hosts no exigen el prefijo en el usuario, pero es mejor que lo uses siempre para evitar problemas.

4. Contraseña del usuario

Escribe la contraseña exacta que configuraste al crear el usuario. Ten cuidado con mayúsculas, minúsculas y caracteres especiales. Si la copiaste de un gestor de contraseñas, asegúrate de que no se haya añadido un espacio invisible.

5. Prefijo de las tablas

PrestaShop te preguntará por un prefijo para las tablas de la base de datos. El valor por defecto es ps_, y es lo que recomendamos usar. Si planeas tener varias tiendas en la misma base de datos (algo poco común pero posible), puedes cambiarlo a algo como shop1_ o mistienda_.

[!INFO]
[INFO] No necesitas crear las tablas manualmente. PrestaShop las generará automáticamente durante la instalación. Solo asegúrate de que la base de datos esté vacía o, si estás reinstalando, que las tablas antiguas se eliminen o se sobrescriban.

Instalación de PrestaShop en cPanel: paso a paso con los parámetros BD

Ahora que ya tienes la base de datos creada y los parámetros claros, vamos a ver cómo se aplican durante la instalación típica de PrestaShop en un hosting con cPanel.

Sube los archivos de PrestaShop a tu hosting

Primero, descarga la última versión de PrestaShop desde su web oficial. Descomprime el archivo en tu ordenador. Luego, usa el Administrador de Archivos de cPanel o un cliente FTP (como FileZilla) para subir el contenido a la carpeta public_html de tu dominio.

Si ya tienes contenido en esa carpeta, crea una subcarpeta llamada tienda y sube los archivos ahí. Así tu tienda quedará accesible en tudominio.com/tienda.

Ejecuta el instalador

Abre tu navegador y ve a la URL donde subiste los archivos. Por ejemplo: https://tudominio.com/tienda. El instalador de PrestaShop se iniciará automáticamente.

Selecciona el idioma y acepta los términos

Elige el idioma español y marca la casilla de aceptación de licencia. Haz clic en "Siguiente".

Configura la tienda (datos de tu negocio)

En esta pantalla te pedirá el nombre de tu tienda, el sector, el país y los datos de la cuenta de administrador. Rellena todo con calma.

Configura la conexión a la base de datos

Aquí es donde aplicamos todo lo que hemos visto. En el asistente de instalación de PrestaShop, verás un formulario con los campos:

Dirección de la base de datos: localhost (o el host que te indique tu proveedor)
Nombre de la base de datos: juanperez_tiendaprestashop
Usuario de la base de datos: juanperez_prestauser
Contraseña: La que configuraste
Prefijo de las tablas: ps_

Pulsa en "Comprobar la conexión" o "Siguiente". Si todo es correcto, el instalador continuará. Si hay un error, te mostrará un mensaje en rojo indicando cuál de los parámetros falla.

[!WARNING]
[WARNING] Si ves el error "No se puede conectar a la base de datos", revisa primero el nombre de la base y el usuario. El error más habitual es que falte el prefijo de la cuenta. También verifica que no hayas puesto espacios al final de los campos.

Finaliza la instalación

El instalador creará las tablas y te pedirá que configures los detalles finales de tu tienda. Una vez terminado, borra la carpeta install de tu servidor por seguridad. No la dejes nunca accesible, ya que alguien podría reinstalar tu tienda y tomar el control.

Cómo conectar PrestaShop a MySQL si ya está instalado (modificar parameters.php)

¿Ya tienes PrestaShop instalado pero necesitas cambiar la base de datos? Esto puede pasar si migras de hosting o si cambiaste la contraseña de tu base de datos.

Localiza el archivo de configuración

PrestaShop guarda los parámetros de conexión en el archivo:

app/config/parameters.php

Puedes acceder a él desde el Administrador de Archivos de cPanel o por FTP. Ábrelo con el editor de texto de cPanel o con un editor como Notepad++.

Edita los valores de conexión

Dentro de ese archivo encontrarás una estructura similar a esta (simplificada):

'database_host' => 'localhost',
'database_name' => 'juanperez_tiendaprestashop',
'database_user' => 'juanperez_prestauser',
'database_password' => 'tucontraseña',
'database_prefix' => 'ps_',

Modifica los valores que necesites y guarda el archivo. Asegúrate de no romper la sintaxis PHP: las comillas deben permanecer intactas.

[!TIP]
[TIP] Antes de tocar este archivo, haz una copia de seguridad. Si algo falla, puedes restaurar el original y tu tienda seguirá funcionando.

Limpia la caché

Después de modificar parameters.php, es recomendable borrar la caché. Ve a la carpeta var/cache dentro de tu instalación de PrestaShop y elimina el contenido (excepto el archivo .htaccess si existe). Esto fuerza a la tienda a recargar la configuración.

Errores comunes al conectar PrestaShop a MySQL en cPanel

Aunque el proceso es sencillo, hay varios errores que se repiten constantemente. Te los detallo para que los evites:

Error: "Acceso denegado para el usuario"

Esto significa que el usuario no tiene permisos sobre la base de datos. Vuelve a cPanel y verifica que has añadido el usuario a la base de datos con todos los privilegios.

Error: "No se encuentra la base de datos"

El nombre que has escrito no existe. Revisa que has incluido el prefijo de tu cuenta. Por ejemplo, no es tienda, sino tuusuario_tienda.

Error: "Host no válido"

localhost no funciona en tu hosting. Contacta con tu proveedor y pregunta cuál es el host de MySQL. En algunos casos es 127.0.0.1 o un subdominio específico.

Error: "La conexión se restableció" al finalizar la instalación

Esto suele deberse a un límite de memoria PHP o a un tiempo de ejecución demasiado corto. En cPanel, puedes aumentar estos límites desde la sección "Select PHP Version" o "MultiPHP INI Editor". Sube memory_limit a 512M y max_execution_time a 300.

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

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

Técnicamente sí, si usas prefijos diferentes (ps_ y shop2_). Pero no lo recomiendo. Si algo falla, es muy difícil separar los datos. Mejor crea una base de datos independiente para cada tienda.

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

Entra en cPanel, ve a la sección de bases de datos MySQL y cambia la contraseña del usuario. Luego actualiza el archivo parameters.php con la nueva contraseña.

¿Es lo mismo conectar PrestaShop a MySQL que a MariaDB?

En la práctica, sí. cPanel suele usar MariaDB, que es un reemplazo directo de MySQL. Los parámetros de conexión son idénticos y PrestaShop funciona perfectamente con ambos.

¿Puedo conectar mi PrestaShop a una base de datos externa?

Sí, pero no es recomendable. La latencia será mayor y si el servidor externo cae, tu tienda se vuelve inaccesible. Además, muchos hosts bloquean conexiones externas a MySQL por seguridad.

¿Qué pasa si cambio el prefijo de las tablas después de la instalación?

No lo hagas. El prefijo está en todas las consultas SQL de PrestaShop. Cambiarlo manualmente romperá tu tienda por completo. Si necesitas cambiarlo, es mejor migrar los datos con una herramienta especializada.

Consejos finales para una conexión exitosa

Para terminar, quiero darte algunos consejos que te ahorrarán dolores de cabeza:

Siempre usa localhost como host si tu hosting es compartido. Es el valor más fiable.
Escribe los nombres manualmente en lugar de copiar y pegar desde un correo. A veces se cuelan caracteres invisibles.
Activa el registro de errores de PrestaShop durante la instalación para ver mensajes detallados si algo falla.
No uses contraseñas débiles para la base de datos. Un atacante con acceso a tu BD puede robar todos los datos de tus clientes.
Si tu hosting usa Syspanel en lugar de cPanel, el proceso es similar pero el puerto de acceso al panel es el 2106. La creación de bases de datos y usuarios sigue la misma lógica, aunque la interfaz puede variar ligeramente.

Conectar PrestaShop a una base de datos MySQL en cPanel no tiene por qué ser una pesadilla. Siguiendo estos pasos y respetando los parámetros exactos, tu tienda estará funcionando en cuestión de minutos. Si tienes más dudas, no dudes en consultar la documentación oficial de PrestaShop o preguntar a tu proveedor de hosting. Ellos conocen la configuración exacta de sus servidores y pueden resolverte cualquier incidencia específica.