Conectar PrestaShop a MySQL: Configuración de Parámetros

¿Tu tienda PrestaShop te da error de conexión a la base de datos o estás migrando a un servidor nuevo? No te preocupes, es una tarea mucho más sencilla de lo que parece si sigues los pasos adecuados. En esta guía completa y detallada, te explicaré cómo conectar PrestaShop a una base de datos MySQL, tanto si tu hosting usa el panel de control Plesk como si usa cPanel. Al final, tendrás tu tienda funcionando sin ningún problema de conexión.

Vamos a desglosar el proceso en partes muy claras. Primero entenderemos qué significa exactamente esta conexión, luego veremos cómo crear la base de datos en cada panel, y finalmente, cómo introducir esos datos en PrestaShop, ya sea durante una instalación nueva o en un archivo de configuración existente. Coge papel y lápiz (o una pestaña nueva), porque vamos a ello.

¿Qué significa realmente "conectar PrestaShop a MySQL"?

Antes de ponernos manos a la obra, es fundamental que entiendas qué estamos haciendo. PrestaShop es un software escrito en PHP que necesita un lugar donde guardar todos sus datos: productos, clientes, pedidos, configuraciones, etc. Ese "lugar" es la base de datos MySQL. La conexión PrestaShop MySQL no es más que el puente que une tu tienda con ese almacén de información.

Este puente se construye con cuatro datos clave que siempre te pedirá PrestaShop:

Nombre de la base de datos: Es el nombre único que le asignas a tu almacén de datos.
Usuario de la base de datos: Es la identificación que usará PrestaShop para entrar a la base de datos. No es lo mismo que el usuario de tu panel de control.
Contraseña: La clave secreta de ese usuario. Debe ser robusta.
Servidor de la base de datos (Host): Es la dirección del servidor donde se encuentra tu base de datos. Normalmente es localhost, pero a veces puede ser una dirección IP o un nombre como mysql.tudominio.com.

Si falla cualquiera de estos cuatro datos, la conexión fallará y verás el famoso error "Error de conexión a la base de datos" o un mensaje similar. Por eso es tan importante seguir los pasos al pie de la letra.

Paso 1: Preparar el terreno (antes de tocar nada)

Lo primero que debes hacer es asegurarte de tener a mano las credenciales de acceso a tu panel de control de hosting. Si tu proveedor te ha dado acceso a Plesk, cPanel o incluso a un panel llamado Syspanel (este último es muy común en algunos hostings y se accede normalmente por el puerto 2106, por ejemplo: https://tudominio.com:2106), necesitarás ese usuario y contraseña.

[INFO]: Si tu hosting utiliza Syspanel (el antiguo HestiaCP), recuerda que la URL de acceso suele incluir el puerto 2106. El proceso de creación de bases de datos es muy similar al de cPanel, pero si te pierdes, busca la sección "Bases de Datos" o "Base de datos MySQL".

Una vez que tengas acceso, abre en otra pestaña de tu navegador la instalación de PrestaShop o el archivo de configuración que vayas a editar. Tener ambas ventanas abiertas te facilitará copiar y pegar los datos sin errores.

Paso 2: Crear la base de datos en cPanel (paso a paso)

cPanel es uno de los paneles más utilizados en el mundo del hosting compartido. Su interfaz es muy amigable, así que no tendrás problema. Sigue estos pasos para crear la base de datos PrestaShop:

Inicia sesión en cPanel: Accede con tu usuario y contraseña. Normalmente la URL es tudominio.com/cpanel o cpanel.tudominio.com.
Busca la sección "Bases de Datos": En la pantalla principal, busca un icono que diga "Bases de Datos MySQL®" o simplemente "Base de datos MySQL". Haz clic en él.
Crea la base de datos: En el apartado "Crear nueva base de datos", escribe el nombre que quieras (por ejemplo, tienda_presta). Ten en cuenta que cPanel suele añadir un prefijo con tu nombre de usuario (ej: usuarioho_tienda_presta). Anota el nombre completo tal y como aparece. Haz clic en "Crear base de datos".
Crea el usuario de la base de datos: Un poco más abajo, verás la sección "Usuarios de MySQL". Aquí debes crear un usuario específico para PrestaShop (ej: usuarioho_prestashop). Escribe un nombre y una contraseña segura. Guárdala en un lugar seguro, la necesitarás. Haz clic en "Crear usuario".
Añade el usuario a la base de datos: Ahora viene el paso crucial. En la sección "Añadir usuario a la base de datos", selecciona el usuario que acabas de crear y la base de datos que creaste en el paso 3. Haz clic en "Añadir".
Asigna los privilegios: Se abrirá una nueva pantalla con una lista de privilegios. Para PrestaShop, necesitas todos los privilegios. La forma más fácil es marcar la casilla "TODOS LOS PRIVILEGIOS" (o "ALL PRIVILEGES") que suele estar en la parte superior. Luego haz clic en "Realizar cambios" o "Hacer cambios".

¡Listo! Ya tienes tu base de datos y usuario creados y vinculados. Ahora tienes los datos que necesitas:

Nombre de la BD: usuarioho_tienda_presta
Usuario de la BD: usuarioho_prestashop
Contraseña: La que hayas puesto.
Servidor: localhost (en el 99% de los casos en cPanel).

Paso 3: Crear la base de datos en Plesk (paso a paso)

Plesk es otro panel muy popular, especialmente en VPS y servidores dedicados, aunque también se usa en hosting compartido. Su estructura es un poco diferente a cPanel, pero igual de sencilla.

Inicia sesión en Plesk: Accede con tu usuario administrador o el usuario que te haya dado tu proveedor. La URL suele ser tudominio.com:8443 o una dirección específica que te hayan proporcionado.
Localiza la sección de Bases de Datos: En el menú lateral izquierdo, busca la pestaña "Bases de datos" (o "Databases"). Haz clic en ella.
Añade una nueva base de datos: Haz clic en el botón "Añadir base de datos" (o "Add Database").
Configura los detalles:
- Nombre de la base de datos: Escribe un nombre descriptivo (ej: prestashop_bd). Plesk no suele añadir prefijos, así que el nombre que pongas será el definitivo.
- Tipo de base de datos: Asegúrate de que esté seleccionado "MySQL".
- Servidor de bases de datos: Si tienes varios, selecciona el servidor MySQL local (suele ser localhost).
Crea el usuario: En la misma pantalla, verás la opción "Usuario de la base de datos". Plesk te permite crear un usuario nuevo en ese momento. Marca la casilla "Crear un usuario de base de datos" (o "Create a database user").
- Nombre de usuario: Escribe un nombre (ej: usuario_presta).
- Contraseña: Introduce una contraseña segura y repítela para confirmarla.
Haz clic en "Aceptar" (u "OK"): Plesk creará la base de datos y el usuario automáticamente, otorgándole todos los privilegios necesarios sobre esa base de datos.

Ahora ya tienes tus datos listos:

Nombre de la BD: prestashop_bd
Usuario de la BD: usuario_presta
Contraseña: La que hayas puesto.
Servidor: localhost (en la mayoría de los casos en Plesk).

Paso 4: Conectar PrestaShop a tu base de datos (Instalación nueva)

Si estás instalando PrestaShop desde cero, este es el momento de la verdad. Después de subir los archivos a tu hosting y ejecutar el instalador, llegarás a un paso llamado "Configuración de la base de datos".

Introduce los datos: En la pantalla de instalación, verás los campos que mencionamos al principio. Rellénalos con la información que has recopilado en el paso anterior (ya sea de cPanel o Plesk).
- Dirección de la base de datos (Host): localhost
- Nombre de la base de datos: El nombre completo que anotaste.
- Usuario de la base de datos: El usuario que creaste.
- Contraseña: La contraseña del usuario.
Prefijo de las tablas: PrestaShop te pedirá un prefijo. Por defecto viene ps_. No lo cambies a menos que sepas muy bien lo que haces. Es útil si vas a tener varias tiendas en la misma base de datos, pero para una sola, déjalo como está.
Comprueba la conexión: Haz clic en el botón "Comprobar ahora" o "Test your connection". Si todo es correcto, verás un mensaje de éxito y podrás continuar con la instalación. Si no, revisa los datos de nuevo, prestando especial atención a los nombres y a la contraseña (las mayúsculas y minúsculas importan).

[TIP]: Si la conexión falla, lo más común es un error tipográfico en el nombre de la base de datos o del usuario. En cPanel, asegúrate de que has incluido el prefijo completo del usuario del hosting. En Plesk, verifica que no hay espacios en blanco.

Paso 5: Conectar PrestaShop a tu base de datos (Migración o error)

¿Ya tienes PrestaShop instalado pero necesitas cambiarlo de servidor o simplemente se ha roto la conexión? Entonces tendrás que editar el archivo de configuración principal: app/config/parameters.php.

Este archivo contiene los datos de conexión en un formato de array de PHP. Debes editarlo con un editor de texto plano (como el Bloc de notas o Notepad++). No uses Word ni procesadores de texto similares.

Accede a tu hosting: Usa el Administrador de Archivos de cPanel/Plesk o un cliente FTP como FileZilla.
Navega a la carpeta: Ve a la raíz de tu instalación de PrestaShop. Normalmente es public_html o httpdocs. Dentro, busca la carpeta app, luego config y abre el archivo parameters.php.

Edita los parámetros: Busca las líneas que dicen database_host, database_name, database_user y database_password. Sustituye los valores entre comillas por los nuevos datos.

Así se ve un ejemplo:

'parameters' => array(
    'database_host' => 'localhost',
    'database_table_prefix' => 'ps_',
    'database_engine' => 'InnoDB',
    'database_name' => 'usuarioho_tienda_presta',
    'database_user' => 'usuarioho_prestashop',
    'database_password' => 'TuContraseñaSegura',
    // ... otros parámetros
)

Guarda los cambios: Sube el archivo modificado a tu servidor, sobrescribiendo el original.

[WARNING]: Antes de tocar este archivo, haz una copia de seguridad del original. Si cometes un error, podrías dejar tu tienda completamente inaccesible. También es recomendable poner la tienda en modo mantenimiento mientras haces el cambio.

Solución de problemas comunes en la conexión PrestaShop BD

A veces, incluso siguiendo todos los pasos, pueden surgir problemas. Aquí tienes los más habituales y cómo solucionarlos:

Error: "El usuario no tiene acceso a la base de datos": Esto significa que el usuario no ha sido vinculado correctamente a la base de datos. Vuelve a revisar el paso 5 de cPanel (Añadir usuario a la base de datos) o la configuración del usuario en Plesk. Asegúrate de que el usuario tiene todos los privilegios sobre esa base de datos específica.
Error: "Host 'x' no está permitido conectar a esta base de datos": Este error es menos común, pero puede aparecer. Suele significar que el servidor MySQL no está en localhost. En algunos hostings, el host de la base de datos es una URL como mysql.tudominio.com o una IP. Consulta la información de tu proveedor de hosting.
Error: "Acceso denegado para el usuario 'x'@'localhost'": Este error indica que la contraseña es incorrecta o que el usuario no existe. Verifica que has escrito bien la contraseña (recuerda que es sensible a mayúsculas) y que el nombre del usuario es exactamente el que aparece en tu panel (incluyendo el prefijo en cPanel).
La conexión funciona, pero la tienda muestra errores de memoria o de tablas: Esto no es un problema de conexión en sí, sino de la base de datos. Puede que necesites optimizar las tablas o que la versión de MySQL no sea compatible. Asegúrate de que tu hosting cumple con los requisitos de versión de MySQL para tu versión de PrestaShop.

Preguntas Frecuentes (FAQ) sobre la conexión de PrestaShop

¿Qué es `localhost` en la conexión a la base de datos?

localhost es la dirección estándar que indica que la base de datos MySQL se encuentra en el mismo servidor que tu web. En la gran mayoría de los casos de hosting compartido (tanto cPanel como Plesk), será localhost. Solo en configuraciones avanzadas o servidores separados tendrás que usar una dirección diferente.

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

Técnicamente sí, pero no es recomendable. Tendrás que usar un prefijo de tabla diferente para cada instalación (ej: ps_ y tienda2_). Es mucho más seguro y limpio crear una base de datos separada para cada tienda. Esto evita conflictos y facilita las copias de seguridad.

¿Qué hago si he olvidado mi contraseña de la base de datos MySQL?

No pasa nada, no necesitas recordarla. Tanto en cPanel como en Plesk, puedes cambiar la contraseña del usuario de la base de datos. Ve a la sección de "Bases de datos MySQL", encuentra tu usuario y busca la opción de "Cambiar contraseña". Después de cambiarla, deberás actualizar el archivo parameters.php de PrestaShop con la nueva contraseña.

¿Es lo mismo "base de datos" que "usuario de la base de datos"?

No, son conceptos diferentes. La base de datos es el contenedor donde se almacena la información. El usuario es la persona o el programa (en este caso PrestaShop) que tiene permiso para entrar en ese contenedor y manipular los datos. Necesitas ambos para que la conexión funcione.

¿Por qué me pide un "prefijo de tabla"?

El prefijo es un texto que se añade al principio de cada tabla que crea PrestaShop en tu base de datos. Por ejemplo, si el prefijo es ps_, la tabla de productos se llamará ps_product. Es útil para identificar las tablas de una aplicación concreta si compartes la base de datos con otras aplicaciones. Para una instalación estándar, deja el prefijo por defecto ps_.

Conclusión y consejo final

Conectar PrestaShop a una base de datos MySQL en Plesk o cPanel es un proceso muy mecánico una vez que le coges el truco. Resumiendo: crea la base de datos, crea un usuario, dale permisos y usa esos datos en la instalación o en el archivo parameters.php.

Mi consejo final es que tengas mucha paciencia y atención a los detalles. Los errores más comunes se deben a pequeñas confusiones con los nombres de usuario (especial