Conectar PrestaShop a MySQL en Plesk: configurar parameters.php

¿Tu tienda PrestaShop te da un error de conexión a la base de datos? ¿No sabes por dónde empezar a configurar el archivo parameters.php en tu servidor Plesk? No te preocupes, es una de las tareas más comunes (y de las que más dolores de cabeza dan) en el mundo del hosting, pero con esta guía paso a paso lo vas a resolver en menos de lo que canta un gallo. Vamos a desglosar todo el proceso de forma sencilla, clara y sin tecnicismos innecesarios.

¿Por qué es tan importante el archivo parameters.php en PrestaShop?

Piensa en tu tienda online como una casa. La fachada (las plantillas, los módulos, las imágenes) es lo que ven tus clientes, pero la base de datos es el sótano donde guardas todos los muebles, la mercancía y los cimientos. Sin una conexión correcta a ese sótano, tu casa se viene abajo.

El archivo parameters.php es, literalmente, el mapa que le dice a PrestaShop dónde está ese sótano, con qué llave abrirlo y qué idioma hablar con él. Este archivo se encuentra en la carpeta app/config/ de tu instalación de PrestaShop. Si este archivo tiene datos incorrectos, tu tienda no cargará, mostrará errores de conexión a MySQL o simplemente te redirigirá a la página de instalación.

Aquí es donde entra en juego Plesk, el panel de control de tu hosting. Plesk es la herramienta que te permite gestionar tus bases de datos, dominios y archivos de forma visual, sin necesidad de ser un hacker. Conectar prestashop plesk base datos es un proceso mecánico, y una vez que lo entiendes, lo harás en menos de 5 minutos.

Paso 1: Localizar los datos de tu base de datos en Plesk

Antes de tocar nada, necesitas reunir tres datos clave: el nombre de la base de datos, el usuario y la contraseña. Sin ellos, es como intentar abrir una puerta sin llave. Vamos a buscarlos.

### Acceso al panel de Plesk

Primero, inicia sesión en tu panel de Plesk. Normalmente lo encuentras en una URL tipo https://tu-dominio.com:8443 o https://tu-ip:8443. Si no estás seguro, pregúntale a tu proveedor de hosting o revisa el correo de bienvenida que te enviaron al contratar el servicio.

Una vez dentro, busca la sección que dice "Bases de datos" o "Databases" en el menú lateral izquierdo o en el panel principal de "Sitios web y dominios". Haz clic en ella.

### Crear o identificar la base de datos

Si ya tienes una base de datos creada (por ejemplo, para una instalación previa de PrestaShop), la verás listada aquí. Si estás empezando de cero, tendrás que crear una nueva. Haz clic en "Agregar base de datos" o "Add Database".

Te pedirá un nombre. Elige uno descriptivo, por ejemplo, tienda_prestashop. Es importante que anotes este nombre exactamente como aparece, ya que Plesk suele añadir un prefijo con el nombre de tu usuario (ej: usuario_tienda_prestashop). Ese nombre completo es el que usarás.

### Crear un usuario para la base de datos

En la misma ventana de creación, o en la pestaña de la base de datos ya creada, busca la opción de "Agregar usuario de base de datos". Crea un usuario (ej: usuario_presta) y una contraseña segura. IMPORTANTE: Guarda esta contraseña en un lugar seguro, porque la necesitarás en unos minutos. Asegúrate de otorgarle todos los privilegios (suele venir marcado por defecto "Todos los privilegios").

Ahora ya tienes los tres datos mágicos:

Nombre de la base de datos: (ej. usuario_tienda_prestashop)
Usuario de la base de datos: (ej. usuario_presta)
Contraseña del usuario: (ej. TuClaveSuperSecreta)

Paso 2: Localizar y editar el archivo parameters.php

Ahora viene la parte técnica, pero no te asustes, es más fácil de lo que parece. Vamos a usar el administrador de archivos de Plesk para editar el archivo.

### Acceso al Administrador de Archivos

En Plesk, ve a tu dominio y busca el botón "Administrador de archivos" o "File Manager". Se abre una ventana donde verás todas las carpetas de tu sitio web.

### Navegando a la carpeta de configuración

Dentro del Administrador de Archivos, navega hasta la raíz de tu instalación de PrestaShop. Normalmente es la carpeta httpdocs o public_html. Dentro de ella, busca la carpeta app y luego la carpeta config. Dentro de config, encontrarás el archivo parameters.php. Haz clic derecho sobre él y selecciona "Editar" o "Edit in Text Editor".

### Editando los parámetros de conexión

Se abrirá un editor de texto con el contenido del archivo. Verás una estructura similar a esta (aunque con más parámetros, pero estos son los que nos interesan):

<?php
return array (
  'parameters' => array (
    'database_host' => 'localhost',
    'database_port' => '',
    'database_name' => 'nombre_base_datos',
    'database_user' => 'usuario_base_datos',
    'database_password' => 'contraseña_base_datos',
    'database_prefix' => 'ps_',
    // ... otros parámetros
  ),
);

Ahora, vamos a modificar los valores clave:

'database_host': En el 99% de los casos en Plesk, este valor debe ser localhost. Si tu hosting usa un servidor de bases de datos externo, te lo habrán indicado en el correo de bienvenida (algo como mysql.tu-dominio.com). Cambia localhost por esa dirección si es necesario.
'database_name': Reemplaza nombre_base_datos por el nombre exacto que anotaste en el Paso 1.
'database_user': Reemplaza usuario_base_datos por el usuario que creaste.
'database_password': Reemplaza contraseña_base_datos por la contraseña que elegiste.

[!WARNING]
Asegúrate de no borrar las comillas simples que rodean a cada valor. Si las eliminas, el archivo se romperá y PrestaShop no podrá leer la configuración. Respeta las mayúsculas y minúsculas del nombre de la base de datos y del usuario.

Una vez hayas modificado estos cuatro campos, guarda el archivo (Ctrl+S o el botón de guardar del editor) y cierra el Administrador de Archivos.

Paso 3: Probar la conexión y solucionar errores comunes

Ya has configurado la conexión. Ahora viene el momento de la verdad. Intenta acceder a tu tienda en el navegador (ej: https://tu-dominio.com).

Si todo ha ido bien, verás tu tienda funcionando. Si no, aquí tienes los errores más comunes y cómo solucionarlos:

### Error: "Link to database cannot be established"

Este es el error clásico. Significa que PrestaShop no puede conectar con MySQL. Las causas suelen ser:

Datos incorrectos: Revisa que el nombre de la base de datos, usuario y contraseña estén escritos exactamente igual que en Plesk. Un simple espacio o una mayúscula mal puesta rompe la conexión.
El usuario no tiene permisos: Vuelve a Plesk, entra en tu base de datos y asegúrate de que el usuario tiene marcados todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.). Si no estás seguro, borra al usuario y créalo de nuevo marcando "Todos los privilegios".
Host incorrecto: Aunque lo más común es localhost, en algunos servidores dedicados o VPS, el host de la base de datos puede ser un nombre distinto. Revisa la documentación de tu hosting o contacta con soporte para confirmar el valor correcto.

### Error: "PrestaShop is not installed"

Este error suele aparecer cuando el archivo parameters.php está vacío o no existe. A veces, al mover la tienda de servidor, el archivo se corrompe. En este caso, la solución más rápida es reinstalar PrestaShop, pero en el paso de configuración de la base de datos, introduce los datos que has configurado en Plesk. Si no quieres reinstalar, puedes intentar reparar el archivo desde el instalador, pero es más complejo.

[!INFO]
Si estás migrando una tienda desde otro servidor, es fundamental que además de cambiar los datos de conexión, verifiques que el prefijo de las tablas (database_prefix) sea el mismo que usaba tu tienda original (normalmente ps_). Si no coincide, tu tienda no encontrará sus tablas y dará error.

### Error de permisos de archivo

A veces, el archivo parameters.php tiene permisos demasiado restrictivos y el servidor web no puede leerlo. En Plesk, puedes cambiar los permisos desde el Administrador de Archivos. Haz clic derecho sobre el archivo, selecciona "Cambiar permisos" y asegúrate de que el propietario (normalmente www-data o tu usuario FTP) tiene permisos de lectura (644 es el estándar).

Consejos avanzados para tu configuración PrestaShop en Plesk

Ya tienes la conexión funcionando, pero aquí van algunos trucos de profesional para que tu experiencia con prestashop plesk base datos sea aún más fluida.

### Utiliza la IP del servidor en lugar de "localhost"

En algunos entornos Plesk con múltiples versiones de PHP o configuraciones de red complejas, usar 127.0.0.1 en lugar de localhost puede resolver problemas de conexión más rápido, ya que fuerza la conexión a través de TCP/IP en lugar de un socket Unix.

### Activa el modo de depuración (si estás en desarrollo)

Si estás configurando la tienda en un entorno de pruebas y necesitas ver más detalles sobre los errores, puedes activar el modo de depuración de PrestaShop. En el archivo parameters.php, busca el parámetro 'debug' y cámbialo a true. Esto mostrará errores detallados en pantalla, lo que te ayudará a diagnosticar problemas. Recuerda ponerlo a false cuando vayas a producción.

### Haz una copia de seguridad antes de tocar nada

[!TIP]
Siempre, siempre, siempre haz una copia de seguridad de tu base de datos y de tus archivos antes de modificar cualquier cosa. En Plesk puedes hacerlo fácilmente desde la sección "Bases de datos" (botón "Copiar" o "Backup") y desde "Administrador de archivos" (comprimiendo la carpeta). Si algo sale mal, podrás volver atrás en dos minutos.

Preguntas frecuentes (FAQ) sobre la conexión PrestaShop y Plesk

¿Qué hago si no tengo Plesk, sino otro panel como cPanel o Syspanel?

Este tutorial está enfocado a Plesk, pero el concepto es el mismo en cualquier panel. En Syspanel (anteriormente HestiaCP, que se accede por el puerto 2106), tendrás que buscar la sección de "Bases de datos" en el menú lateral. El proceso de crear la base de datos y el usuario es idéntico, y el archivo parameters.php se edita de la misma forma. La única diferencia es la interfaz visual.

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

Técnicamente sí, pero es una mala idea. PrestaShop usa un prefijo para sus tablas (ej: ps_). Si creas una segunda tienda con un prefijo diferente (ej: tienda2_), podrían coexistir en la misma base de datos. Sin embargo, esto complica las copias de seguridad y el mantenimiento. Es mucho más limpio y seguro crear una base de datos separada para cada tienda.

He cambiado la contraseña de la base de datos en Plesk y ahora mi tienda da error.

Lógico. Si cambias la contraseña en Plesk, debes actualizarla también en el archivo parameters.php. Es un error muy común. Repite el Paso 2 y cambia el valor de 'database_password' por la nueva contraseña.

¿Por qué mi tienda muestra el error "PrestaShop could not connect to the database" después de una actualización de Plesk?

Las actualizaciones de Plesk a veces cambian la configuración del servidor de bases de datos. Por ejemplo, puede que cambien el host de localhost a una IP específica o que modifiquen los usuarios. En ese caso, revisa la configuración de tus bases de datos en Plesk y verifica que los datos en parameters.php sigan siendo correctos. Si no lo son, actualízalos.

¿Qué es el database_prefix y por qué no lo toco?

El prefijo es una cadena de texto que se añade al nombre de todas las tablas de tu tienda. Es una medida de seguridad para que, si alguien intenta inyectar código SQL, sea más difícil adivinar los nombres de las tablas. Si estás migrando una tienda, el prefijo debe ser el mismo que tenías antes. Si lo cambias, la tienda no encontrará sus tablas y te dará un error de "tabla no encontrada".

Conectar prestashop plesk base datos es una tarea de mantenimiento básico que, una vez dominada, te ahorrará muchos quebraderos de cabeza. Recuerda: paciencia, datos correctos y una copia de seguridad. Con estos tres elementos, podrás conectar tu tienda a su base de datos en Plesk sin ningún problema. Ahora, ¡ve y hazlo!