Conectar PrestaShop a MySQL en Plesk | Configuración Parámetros

Antes de Empezar: ¿Qué Necesitas para Conectar PrestaShop a MySQL en Plesk?

Conectar tu tienda PrestaShop a una base de datos MySQL en Plesk es un paso fundamental para que tu negocio online funcione correctamente. Si estás leyendo esto, probablemente estés en medio de una instalación, una migración o quizás hayas recibido un error de conexión. No te preocupes, es un proceso más sencillo de lo que parece y aquí te lo voy a explicar paso a paso, como si lo hiciéramos juntos.

Para empezar, necesitarás tener a mano tres datos esenciales que te proporcionará tu panel de control Plesk. Piensa en ellos como la combinación de una cerradura: el nombre de la base de datos, el nombre de usuario y la contraseña. Sin estos tres elementos, la conexión será imposible.

También es importante que sepas que, aunque trabajaremos con Plesk, los conceptos son muy similares en otros paneles como cPanel o incluso Syspanel (anteriormente conocido como HestiaCP, que se accede por el puerto 2106). La lógica de configuración es universal: siempre necesitas localizar el archivo de configuración de PrestaShop y rellenar los datos de tu base de datos.

[INFO] Si estás migrando una tienda desde otro servidor, asegúrate de tener una copia de seguridad de tu base de datos original. Este proceso no la crea, solo la conecta.

Paso 1: Localiza tus Datos de Conexión MySQL en Plesk

Antes de tocar ningún archivo de PrestaShop, vamos a buscar la información que necesitamos dentro de Plesk. Es como ir a la oficina a recoger las llaves antes de abrir la puerta de casa.

### Accediendo a la Sección de Bases de Datos

Inicia sesión en tu panel de Plesk. Normalmente será algo como https://tudominio.com:8443 o la URL que te haya proporcionado tu proveedor de hosting.
En el menú lateral izquierdo, busca la sección que dice "Bases de datos". Haz clic en ella. Verás un listado con todas las bases de datos que tienes creadas en tu plan de hosting.
Si aún no tienes una base de datos creada para tu PrestaShop, este es el momento de crearla. Haz clic en el botón "Agregar base de datos" (o "Add Database"). Te pedirá un nombre para la base de datos y, en la mayoría de los casos, se creará automáticamente un usuario con una contraseña. Anota todo esto, es oro puro.

### Identificando el Nombre Completo de la Base de Datos

Un error muy común es no darse cuenta de que Plesk añade un prefijo al nombre de tu base de datos y al usuario. Por ejemplo, si tu cuenta de hosting se llama usuario123 y creas una base de datos llamada prestashop, el nombre real será usuario123_prestashop. Lo mismo ocurre con el usuario: si creas el usuario shopadmin, el nombre real será usuario123_shopadmin.

Ten mucho cuidado con esto. Copia los nombres exactamente como aparecen en el listado de Plesk, no como los escribiste tú. Este es el motivo del 90% de los errores de conexión.

### La Contraseña: Un Secreto Bien Guardado

Plesk normalmente no te muestra la contraseña de la base de datos una vez creada. Si no la anotaste en el momento de la creación, tendrás que restablecerla. Para ello, entra en tu base de datos desde el listado, busca la opción de "Cambiar contraseña" (o "Change Password") y establece una nueva. Asegúrate de que sea segura pero que puedas recordarla o guardarla en tu gestor de contraseñas.

[TIP] Te recomiendo encarecidamente que guardes estos datos en un lugar seguro, como un gestor de contraseñas. Los necesitarás no solo para la instalación, sino también para futuras configuraciones o migraciones.

Paso 2: Entendiendo el Archivo `parameters.php` de PrestaShop

PrestaShop guarda toda la configuración de su conexión a la base de datos en un archivo muy específico llamado parameters.php. Este archivo es el corazón de la comunicación entre tu tienda y MySQL. Está ubicado en la carpeta app/config/ de tu instalación de PrestaShop.

### ¿Qué es y Para Qué Sirve?

Piensa en parameters.php como la agenda de contactos de tu tienda. En él, PrestaShop guarda el número de teléfono (la dirección del servidor MySQL), el nombre del contacto (el nombre de la base de datos) y la contraseña para poder llamar (el usuario y su clave). Sin esta agenda, tu tienda no sabe a quién llamar para obtener sus productos, clientes o pedidos.

### Localizando el Archivo en tu Servidor

Para editarlo, necesitas acceder a los archivos de tu hosting. Tienes dos opciones principales:

El Administrador de Archivos de Plesk: Es la forma más visual y sencilla. Dentro de Plesk, busca la sección "Administrador de archivos" (File Manager). Navega hasta la carpeta donde tienes instalado PrestaShop. Normalmente será httpdocs o public_html. Luego, entra en la carpeta app y después en config. Ahí encontrarás el archivo parameters.php.
FTP (File Transfer Protocol): Si te sientes más cómodo con un cliente FTP como FileZilla, conéctate a tu servidor y navega a la misma ruta (/httpdocs/app/config/). Descarga el archivo parameters.php a tu ordenador para editarlo con un editor de texto plano como Notepad++ o Sublime Text.

[WARNING] Es crucial que hagas una copia de seguridad de este archivo antes de modificarlo. Si algo sale mal, podrás restaurarlo fácilmente. Simplemente descarga una copia a tu ordenador o renómbralo a parameters.php.bak en el servidor.

Paso 3: Configurando los Parámetros de Conexión en `parameters.php`

Ahora viene la parte práctica. Una vez que tengas el archivo parameters.php abierto en tu editor, verás un código PHP con una serie de parámetros. No te asustes, no necesitas ser un experto en programación. Solo tienes que buscar las líneas que empiezan con 'database_host', 'database_name', etc., y cambiar sus valores.

### Los Parámetros Clave que Debes Modificar

Aquí tienes una tabla con los parámetros que te interesan y qué valor debes poner en cada uno:

Parámetro	Descripción	Qué poner
`'database_host'`	La dirección del servidor MySQL.	Normalmente `127.0.0.1` o `localhost`. Si tu hosting usa un servidor externo, te lo habrán indicado.
`'database_port'`	El puerto de conexión.	Casi siempre es `3306`. Es el puerto por defecto de MySQL.
`'database_name'`	El nombre de tu base de datos.	El nombre completo que viste en Plesk, incluyendo el prefijo (ej: `usuario123_prestashop`).
`'database_user'`	El nombre de usuario de la base de datos.	El nombre completo de usuario que viste en Plesk (ej: `usuario123_shopadmin`).
`'database_password'`	La contraseña del usuario.	La contraseña que estableciste o te proporcionó Plesk.

### Un Ejemplo Práctico para que lo Veas Claro

Imagina que en Plesk ves esto:

Nombre de la base de datos: mishop_prestashop
Nombre de usuario: mishop_admin_shop
Contraseña: TuClaveSuperSecreta123

Entonces, en tu archivo parameters.php, deberías tener algo así:

'database_host' => '127.0.0.1',
'database_port' => '3306',
'database_name' => 'mishop_prestashop',
'database_user' => 'mishop_admin_shop',
'database_password' => 'TuClaveSuperSecreta123',

### ¿Qué es `database_prefix`?

Este parámetro es menos común, pero muy útil. Define el prefijo que se añade a las tablas de PrestaShop en la base de datos. Por defecto es ps_. Si no sabes qué es, déjalo como está. No lo toques a menos que sepas que tu base de datos usa un prefijo diferente, ya que si lo cambias sin necesidad, romperás la conexión.

[INFO] No confundas el database_prefix con el prefijo que añade Plesk al nombre de la base de datos. Son cosas totalmente distintas. El primero es interno de PrestaShop, el segundo es una convención de tu hosting.

Paso 4: Guardar los Cambios y Probar la Conexión

Una vez que hayas editado los parámetros, es hora de guardar el archivo y ver si todo funciona.

### Guardando el Archivo Correctamente

Si estás editando el archivo en tu ordenador, guárdalo con el mismo nombre (parameters.php) y asegúrate de que la codificación sea UTF-8 sin BOM (esto suele ser una opción en el editor). Esto evita problemas con caracteres especiales.
Sube el archivo modificado a tu servidor, sobrescribiendo el original. Si usas el Administrador de Archivos de Plesk, puedes editar el archivo directamente y guardar los cambios.

### Probando la Conexión: Accede a tu Tienda

Ahora viene el momento de la verdad. Abre tu navegador y escribe la URL de tu tienda (por ejemplo, https://tudominio.com).

Si todo ha ido bien: Verás la página principal de tu tienda o, si estás en plena instalación, el asistente de instalación continuará sin problemas.
Si hay un error: Verás un mensaje de error de conexión a la base de datos. No te desanimes. Respira y vuelve a revisar cada uno de los parámetros. El error más común es un error tipográfico en el nombre de la base de datos o del usuario, o una contraseña incorrecta.

Solución de Problemas Comunes al Conectar PrestaShop con MySQL

Aquí te dejo una lista de los problemas más frecuentes y cómo solucionarlos. Es la parte que más buscan los usuarios cuando intentan configurar prestashop mysql.

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

Este es el error más genérico y frustrante. Significa que PrestaShop no puede conectarse al servidor MySQL. Las causas más probables son:

Datos incorrectos: Verifica una y otra vez el database_name, database_user y database_password. Recuerda que Plesk añade prefijos.
Host incorrecto: Aunque lo normal es 127.0.0.1 o localhost, a veces el servidor MySQL está en otra máquina. Revisa la documentación de tu hosting o contacta con su soporte. Si usas Syspanel, la configuración de host suele ser localhost.
Contraseña con caracteres especiales: Si tu contraseña tiene caracteres como $, # o %, es posible que haya que escaparlos en el archivo PHP. Por ejemplo, un $ se escribiría como \$. Para simplificar, si tienes problemas, prueba a cambiar la contraseña a una que solo tenga letras y números.

### Error: "Access denied for user"

Este error indica que el usuario o la contraseña son incorrectos, o que el usuario no tiene permisos para acceder a esa base de datos concreta desde esa dirección IP.

Revisa los permisos: En Plesk, entra en tu base de datos y asegúrate de que el usuario que has configurado tiene todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.) sobre la base de datos.
Añade el usuario a la base de datos: A veces, el usuario existe pero no está vinculado a la base de datos. En Plesk, dentro de la sección de la base de datos, busca "Añadir usuario a la base de datos" y añade el usuario que quieres usar.

### Error: "Unknown database"

Este error significa que el nombre de la base de datos que has puesto en parameters.php no existe en el servidor. Vuelve a comprobar el nombre exacto en Plesk, prestando atención al prefijo.

### Mi tienda funciona pero no puedo acceder al Panel de Administración

Esto suele pasar si has cambiado el database_prefix sin necesidad. Si tu tienda era funcional antes, es muy probable que hayas alterado algo que no debías. Restaura la copia de seguridad del archivo parameters.php que hiciste al principio.

[WARNING] Si después de varios intentos sigues sin poder conectar, no dudes en contactar con el soporte técnico de tu proveedor de hosting. Ellos pueden verificar la configuración del servidor y ayudarte a diagnosticar el problema. Es mejor pedir ayuda que estar horas dando vueltas a un error que puede ser muy simple.

Preguntas Frecuentes (FAQ) sobre la Conexión a MySQL en Plesk

Aquí tienes algunas de las preguntas que más me suelen hacer los usuarios, y que seguro te ayudarán a resolver dudas adicionales.

### ¿Puedo usar `localhost` o `127.0.0.1` indistintamente?

Sí, en la gran mayoría de los casos son equivalentes. Ambos apuntan al servidor local. Si uno no funciona, prueba con el otro, pero es raro que haya diferencias.

### ¿Qué hago si no encuentro el archivo `parameters.php`?

Si no lo encuentras en app/config/, puede que tengas una versión antigua de PrestaShop (1.6 o anterior). En ese caso, el archivo de configuración se llama config/settings.inc.php. El proceso es el mismo, solo cambia el nombre del archivo.

### ¿Es seguro editar el archivo `parameters.php`?

Sí, es seguro si sigues los pasos correctamente. Lo único que estás haciendo es cambiar los datos de conexión a la base de datos. Es un archivo de texto plano y no hay riesgo de romper la lógica de tu tienda siempre que no borres o alteres otras líneas de código.

### ¿Necesito reiniciar algo después de cambiar el archivo?

No, no es necesario reiniciar ningún servicio. Los cambios en el archivo parameters.php se aplican automáticamente en la siguiente petición que haga tu tienda. Simplemente recarga la página.

### ¿Qué es el prefijo `ps_` en las tablas de mi base de datos?

Es el prefijo que utiliza PrestaShop para nombrar sus tablas (por ejemplo, ps_products, ps_orders). Si tienes varias aplicaciones en la misma base de datos, este prefijo evita conflictos de nombres. No lo cambies a menos que sepas exactamente lo que estás haciendo.

### ¿Puedo usar un servidor MySQL externo?

Sí, es posible. En ese caso, en database_host deberás poner la dirección IP o el nombre del servidor externo. Sin embargo, ten en cuenta que la latencia puede aumentar y que tu proveedor de hosting puede tener restricciones sobre conexiones externas. Para un sitio web normal, usar el servidor local es siempre la mejor opción.

Conclusión: Ya has Conectado tu Tienda

Conectar PrestaShop a una base de datos MySQL en Plesk es un proceso mecánico que, una vez que lo has hecho un par de veces, te resultará muy sencillo. La clave está en ser meticuloso con los nombres de usuario y base de datos, y en no tener miedo a mirar dentro de un archivo de configuración.

Recuerda que este mismo procedimiento te servirá para conectar prestashop plesk mysql en cualquier otro panel de control. La lógica es universal: localizar el archivo de configuración y rellenar los datos correctos.

Espero que esta guía te haya sido de gran ayuda y que tu tienda online esté funcionando a pleno rendimiento. Si has seguido todos los pasos y aun así tienes problemas, no dudes en dejar un comentario o contactar con tu proveedor de hosting. ¡Buena suerte con tu negocio!