PrestaShop y Plesk: Configurar Base de Datos Paso a Paso

Introducción: ¿Por qué es importante configurar bien la base de datos en PrestaShop?

Cuando instalas PrestaShop en un servidor que utiliza Plesk, uno de los pasos más críticos (y a veces más frustrantes) es la configuración de la conexión a la base de datos. Una mala configuración puede provocar errores como el famoso "Error de conexión a la base de datos", pantallas en blanco o tiendas que funcionan a medias.

La buena noticia es que este proceso, aunque técnico, es totalmente manejable si sigues los pasos adecuados. En este artículo, te guiaré de forma clara y sencilla para que puedas configurar la conexión entre PrestaShop y MySQL en Plesk, ya sea durante la instalación inicial o cuando necesitas corregir problemas existentes.

Hablaré de conceptos como prestashop plesk base de datos, te mostraré cómo crear usuarios y bases de datos desde Plesk, y te daré trucos para que la configuración sea a prueba de fallos. Al final, también resolveré las dudas más comunes que recibimos en soporte técnico.

Requisitos previos: Qué necesitas tener a mano

Antes de empezar a tocar nada, asegúrate de tener lo siguiente:

Acceso al panel de control de Plesk con permisos de administrador o de gestión de bases de datos.
Credenciales de acceso a tu servidor (usuario y contraseña de Plesk).
Los datos de tu tienda PrestaShop (si ya está instalada, necesitarás acceso al archivo de configuración).
Ganas de aprender, ¡que no falten!

Si ya tienes una base de datos creada, perfecto. Si no, te explicaré cómo crearla desde cero.

Paso 1: Crear la base de datos en Plesk

Lo primero que necesitas es una base de datos vacía donde PrestaShop pueda guardar sus tablas. Plesk hace esto muy sencillo.

1.1 Accede a la sección de Bases de Datos

Inicia sesión en Plesk y busca la sección "Bases de datos" en el menú lateral o en la pantalla principal de tu dominio. Normalmente aparece con un icono de un cilindro de base de datos.

1.2 Crear una nueva base de datos

Haz clic en "Agregar base de datos" o "Crear nueva base de datos". Se abrirá un formulario con los siguientes campos:

Nombre de la base de datos: Elige un nombre descriptivo, por ejemplo tienda_prestashop. Es recomendable no usar espacios ni caracteres especiales, solo letras, números y guiones bajos.
Tipo de base de datos: Selecciona MySQL (o MariaDB, si tu servidor lo ofrece, es totalmente compatible).
Servidor de base de datos: Si tienes varios, selecciona el que corresponda (normalmente hay uno solo).

1.3 Crear un usuario para la base de datos

En el mismo formulario, Plesk te pedirá que crees un usuario. Este usuario será el que PrestaShop utilizará para conectarse. Rellena:

Nombre de usuario: Por ejemplo presta_user.
Contraseña: Algo seguro pero que puedas recordar o guardar en un gestor. Plesk tiene un generador de contraseñas que puedes usar.

Importante: Marca la casilla de que el usuario tendrá todos los privilegios sobre esta base de datos. PrestaShop necesita permisos completos (SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP) para funcionar correctamente.

Haz clic en "Aceptar" o "OK". Plesk creará la base de datos y el usuario automáticamente.

[TIP] Anota en un lugar seguro el nombre de la base de datos, el usuario y la contraseña. Los necesitarás en el siguiente paso y no podrás recuperar la contraseña desde Plesk (solo podrás cambiarla).

Paso 2: Configurar la conexión durante la instalación de PrestaShop

Si estás instalando PrestaShop desde cero, el asistente de instalación te pedirá los datos de conexión en el paso de "Configuración de la base de datos". Aquí es donde entra en juego la magia.

2.1 Los campos del instalador

El asistente de PrestaShop te mostrará un formulario con estos campos:

Dirección del servidor de base de datos: Normalmente es localhost o 127.0.0.1. En Plesk, casi siempre es localhost, pero si tu base de datos está en un servidor externo, tendrás que poner la IP o el nombre del servidor.
Nombre de la base de datos: Exactamente el nombre que creaste en Plesk (ej. tienda_prestashop).
Usuario de la base de datos: El usuario que creaste (ej. presta_user).
Contraseña: La contraseña de ese usuario.
Prefijo de las tablas: Te recomiendo dejar el prefijo por defecto (ps_). Si quieres más seguridad, puedes cambiarlo, pero luego es más complicado.

2.2 Pruébalo antes de continuar

El instalador tiene un botón de "Comprobar" o "Probar conexión". Úsalo siempre. Si todo es correcto, verás un mensaje verde. Si no, revisa los datos.

[WARNING] Si ves el error "No se pudo conectar a la base de datos", verifica que el usuario tenga el prefijo correcto. En Plesk, a veces el nombre de usuario se muestra como usuario@localhost o usuario@%. En el campo de usuario del instalador, solo debes poner el nombre, sin el @localhost.

Paso 3: Configurar la conexión en una instalación existente

¿Ya tienes PrestaShop instalado y necesitas cambiar la conexión a la base de datos? Esto es común si has movido la tienda de servidor o si has cambiado las credenciales. No te preocupes, no necesitas reinstalar nada.

3.1 Localiza el archivo de configuración

PrestaShop guarda la configuración de la base de datos en el archivo app/config/parameters.php (en versiones modernas de PrestaShop 1.7 y 8.x). En versiones antiguas (1.6 o anteriores), era el archivo config/settings.inc.php.

Accede a tu servidor por FTP o a través del Administrador de archivos de Plesk y busca ese archivo.

3.2 Editar los parámetros de conexión

Abre el archivo con un editor de texto plano (nada de Word). Verás un array de PHP con valores como este:

return [
    'parameters' => [
        'database_host' => 'localhost',
        'database_port' => '3306',
        'database_name' => 'tienda_prestashop',
        'database_user' => 'presta_user',
        'database_password' => 'tu_contraseña',
        'database_prefix' => 'ps_',
        // ... otros parámetros
    ],
];

Cambia los valores según las credenciales que tengas:

database_host: localhost o la IP del servidor de base de datos.
database_name: El nombre de tu base de datos.
database_user: El usuario de la base de datos.
database_password: La contraseña del usuario.
database_prefix: El prefijo de las tablas (si no lo cambiaste, será ps_).

Guarda el archivo y súbelo de nuevo al servidor si lo estabas editando localmente.

[INFO] Si usas Plesk y tienes acceso SSH, también puedes editar el archivo directamente con comandos como nano. Pero para usuarios novatos, lo más fácil es usar el Administrador de archivos de Plesk.

3.3 Comprobar la conexión

Después de guardar, intenta acceder a tu tienda. Si la conexión es correcta, la tienda cargará con normalidad. Si ves un error, revisa que no haya espacios en blanco antes de <?php en el archivo, ya que eso puede dar errores de "headers already sent".

Paso 4: Solucionar problemas comunes de conexión

A veces, aunque hagas todo bien, surgen problemas. Aquí tienes los más frecuentes y cómo solucionarlos.

4.1 Error "Access denied for user"

Este error significa que el usuario o la contraseña son incorrectos, o que el usuario no tiene permisos para conectarse desde el host donde está PrestaShop.

Solución 1: Revisa que el usuario y la contraseña sean exactamente los que creaste en Plesk.
Solución 2: En Plesk, ve a la base de datos, entra en la pestaña de "Usuarios" y asegúrate de que el usuario tiene asignada la base de datos correcta.
Solución 3: Si el host de tu base de datos no es localhost sino una IP, puede que el usuario solo tenga permisos para conectarse desde localhost. En Plesk, al crear el usuario, hay una opción de "Host remoto" o "Acceso desde cualquier host". Asegúrate de que está configurado correctamente.

4.2 Error "Unknown database"

Esto indica que el nombre de la base de datos que has puesto no existe.

Solución: Ve a Plesk, a la sección de Bases de datos, y verifica el nombre exacto. A veces Plesk añade un prefijo automáticamente (por ejemplo, dominio_tienda_prestashop). Copia el nombre exacto que aparece en Plesk.

4.3 Error "Connection refused" o "Timeout"

Este problema suele estar relacionado con el servidor de base de datos o con el puerto.

Solución 1: Verifica que el puerto sea el correcto (normalmente 3306 para MySQL).
Solución 2: Si tu base de datos está en un servidor externo, asegúrate de que el firewall de ese servidor permite conexiones desde la IP de tu servidor web.
Solución 3: En Plesk, revisa que el servicio de MySQL esté activo. Puedes hacerlo desde "Herramientas y ajustes" > "Servicios".

4.4 Pantalla en blanco al instalar

Si la instalación se queda en blanco, suele ser por un problema de permisos en los archivos o porque la base de datos ya tiene tablas de una instalación anterior.

Solución: Elimina todas las tablas de la base de datos desde Plesk (puedes usar la herramienta "phpMyAdmin" que viene integrada en Plesk) y vuelve a intentarlo.

Paso 5: Buenas prácticas y seguridad

Configurar la conexión es solo el primer paso. Aquí tienes algunas recomendaciones para que tu tienda esté segura y funcione bien.

5.1 No uses el usuario root

Es muy tentador usar el usuario root de MySQL para todo, pero es una pésima práctica. Crea siempre usuarios específicos para cada base de datos. Si un atacante compromete tu tienda, tendrá acceso solo a esa base de datos, no a todo el servidor.

5.2 Cambia las contraseñas periódicamente

Plesk te permite cambiar la contraseña de un usuario de base de datos en cualquier momento. Si sospechas que ha podido filtrarse, cámbiala cuanto antes y actualiza el archivo parameters.php.

5.3 Haz copias de seguridad

Antes de tocar la configuración de la base de datos, haz siempre una copia de seguridad. En Plesk, puedes hacerlo desde la sección de "Bases de datos", seleccionando la base y haciendo clic en "Copiar" o usando la herramienta de "Administrador de copias de seguridad".

[TIP] Si vas a editar el archivo parameters.php, descarga una copia a tu ordenador antes de modificarlo. Así, si algo sale mal, puedes restaurarlo en segundos.

5.4 Utiliza el prefijo de tablas

Si bien el prefijo ps_ es el estándar, cambiarlo a algo como mydb_ o shop_ añade una capa extra de seguridad al dificultar que los atacantes adivinen los nombres de las tablas. Eso sí, hazlo durante la instalación inicial.

Preguntas frecuentes (FAQ)

Aquí tienes las dudas que más nos llegan al soporte técnico sobre este tema.

¿Puedo usar MariaDB en lugar de MySQL en Plesk?

Sí, PrestaShop es totalmente compatible con MariaDB. De hecho, MariaDB es un reemplazo directo de MySQL y funciona igual. En Plesk, al crear la base de datos, verás la opción de elegir entre MySQL y MariaDB.

¿Qué significa el prefijo `@localhost` en el usuario de la base de datos?

En Plesk, cuando creas un usuario, internamente se guarda como usuario@localhost o usuario@%. El @localhost significa que solo puede conectarse desde el mismo servidor donde está la base de datos. El @% significa que puede conectarse desde cualquier host. Para PrestaShop en el mismo servidor, localhost es suficiente.

¿Puedo cambiar el nombre de la base de datos después de instalar PrestaShop?

Técnicamente sí, pero es un proceso delicado. Tendrías que exportar la base de datos, crear una nueva con el nombre deseado, importar los datos y luego actualizar el archivo parameters.php. Te recomiendo hacerlo con una copia de seguridad y con mucho cuidado.

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

No puedes recuperarla, pero sí puedes cambiarla. En Plesk, ve a la base de datos, entra en la pestaña de "Usuarios", selecciona el usuario y haz clic en "Cambiar contraseña". Luego actualiza el archivo parameters.php con la nueva contraseña.

¿Es normal que la instalación tarde tanto en el paso de la base de datos?

Sí, PrestaShop crea cientos de tablas durante la instalación. Si tu servidor es un poco lento, puede tardar unos minutos. No cierres la página ni recargues. Ten paciencia.

¿Puedo usar una base de datos externa (de otro servidor) con PrestaShop en Plesk?

Sí, es posible. Solo tienes que poner la IP del servidor externo en el campo database_host y asegurarte de que el usuario de la base de datos tenga permisos para conectarse desde tu servidor de origen. En Plesk, al crear el usuario, selecciona la opción de "Acceso desde cualquier host" o especifica la IP de tu servidor web.

Conclusión y resumen

Configurar la conexión a la base de datos en PrestaShop con Plesk es un proceso que, una vez que le coges el truco, no te llevará más de 10 minutos. Lo más importante es tener claros los tres datos clave: nombre de la base de datos, usuario y contraseña, y saber dónde ponerlos (en el instalador o en el archivo parameters.php).

Recuerda estos puntos clave:

Crea siempre una base de datos y un usuario específicos para PrestaShop.
Utiliza localhost como host en la mayoría de los casos.
Prueba la conexión antes de continuar con la instalación.
Guarda una copia de seguridad antes de hacer cambios.
Si tienes errores, revisa los permisos del usuario y el nombre exacto de la base de datos.

Con esta guía, ya tienes todo lo necesario para dominar la configuración de prestashop plesk base de datos. Si te surge cualquier duda, no dudes en consultar la documentación oficial de PrestaShop o abrir un ticket con tu proveedor de hosting, que para eso estamos.

¡Espero que tu tienda online funcione perfectamente y que vendas mucho!

[INFO] Si estás migrando una tienda desde otro panel de control (por ejemplo, desde cPanel o un servidor con Syspanel —que es el nuevo nombre de HestiaCP y se accede por el puerto 2106—), el proceso es el mismo: exporta tu base de datos, impórtala en Plesk y luego ajusta el archivo parameters.php con las nuevas credenciales. La lógica no cambia, solo el entorno.