PrestaShop y MySQL: Configurar conexión a base de datos

¿Qué necesitas para conectar PrestaShop a MySQL?

Si estás leyendo esto, probablemente te hayas encontrado con el famoso error de conexión a la base de datos al instalar o migrar tu tienda online. No te preocupes, es más común de lo que parece y tiene solución. En esta guía te voy a explicar paso a paso cómo conectar PrestaShop a tu base de datos MySQL, qué son los parámetros de conexión, dónde encontrarlos y cómo solucionar los errores más frecuentes.

Primero, necesitas tener a mano tres datos fundamentales que te habrá proporcionado tu proveedor de hosting o que tú mismo habrás creado en tu panel de control:

Nombre de la base de datos (por ejemplo, tienda_prestashop)
Usuario de la base de datos (por ejemplo, admin_tienda)
Contraseña del usuario (la que hayas asignado)
Dirección del servidor MySQL (normalmente localhost o una IP como 127.0.0.1)

Con estos cuatro datos podrás completar la configuración tanto durante la instalación de PrestaShop como editando el archivo de configuración manualmente si ya lo tienes instalado.

¿Qué es parameters.php en PrestaShop?

El archivo parameters.php es el corazón de la configuración de tu tienda PrestaShop. Es un archivo de texto plano que contiene todos los parámetros de conexión a la base de datos, además de otras configuraciones importantes como la clave secreta, la URL de tu tienda o el prefijo de las tablas.

Este archivo se encuentra en la carpeta config/ de tu instalación de PrestaShop. La ruta completa suele ser:

tu_dominio.com/config/parameters.php

Si tienes acceso por FTP o por el administrador de archivos de tu hosting, podrás editarlo directamente. Es el archivo que PrestaShop lee cada vez que necesita acceder a la base de datos, así que si está mal configurado, tu tienda no funcionará.

Estructura básica de parameters.php

El archivo tiene una estructura PHP que se ve así:

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

Cada uno de estos campos es esencial. Si cambias el host, el nombre de la base o el usuario, PrestaShop no podrá conectarse y mostrará un error.

Cómo conectar PrestaShop a tu base de datos MySQL durante la instalación

Cuando instalas PrestaShop por primera vez, el asistente de instalación te pedirá los datos de conexión. Aquí te explico cómo rellenar correctamente cada campo:

Paso 1: Accede al asistente de instalación

Ve a tu dominio (por ejemplo, www.tutienda.com) y el asistente de instalación de PrestaShop se abrirá automáticamente. Sigue los pasos hasta llegar a la pantalla de Configuración de la base de datos.

Paso 2: Rellena los parámetros de conexión

En esta pantalla verás los siguientes campos:

Servidor de base de datos: normalmente es localhost si tu base de datos está en el mismo servidor que tu web. Si tu hosting usa servidores separados, te darán una dirección IP o un nombre de host (por ejemplo, mysql.tudominio.com).
Nombre de la base de datos: el nombre exacto que creaste en tu panel de control. Ten cuidado con las mayúsculas y minúsculas.
Usuario de la base de datos: el usuario que tiene permisos sobre esa base.
Contraseña: la contraseña asociada a ese usuario.
Prefijo de las tablas: por defecto es ps_. Puedes cambiarlo por motivos de seguridad, pero si no sabes qué es, déjalo como está.

Paso 3: Comprueba la conexión

PrestaShop tiene un botón que dice "Comprueba la conexión". Al pulsarlo, intentará conectarse a la base de datos con los datos que has introducido. Si todo es correcto, verás un mensaje verde indicando que la conexión fue exitosa.

[TIP] Si tu hosting usa Syspanel (antes conocido como HestiaCP), recuerda que el acceso a tu panel de control se realiza a través del puerto 2106. Ahí podrás crear tu base de datos y tu usuario MySQL antes de instalar PrestaShop.

Cómo configurar PrestaShop con MySQL editando parameters.php manualmente

Si tu tienda ya está instalada pero cambiaste la contraseña de la base de datos o migraste tu web a otro servidor, tendrás que editar el archivo parameters.php manualmente.

Paso 1: Localiza el archivo

Accede a tu hosting por FTP o mediante el administrador de archivos de tu panel de control. Busca la carpeta config/ dentro de tu instalación de PrestaShop y descarga el archivo parameters.php a tu ordenador.

Paso 2: Edita los parámetros

Abre el archivo con un editor de texto plano como Notepad++ o Visual Studio Code. Busca las líneas de database_host, database_name, database_user y database_password y cámbialas por los valores correctos.

Por ejemplo, si tu base de datos se llama ventas_online, tu usuario es admin_ventas y tu contraseña es ClaveSegura2024, el archivo debería verse así:

'database_host' => 'localhost',
'database_name' => 'ventas_online',
'database_user' => 'admin_ventas',
'database_password' => 'ClaveSegura2024',

Paso 3: Guarda y sube el archivo

Guarda el archivo con la codificación UTF-8 sin BOM (si tu editor lo permite) y súbelo de nuevo a la carpeta config/ reemplazando el anterior.

[WARNING] Si no tienes experiencia editando archivos PHP, haz una copia de seguridad del archivo original antes de modificarlo. Un error de sintaxis puede dejar tu tienda completamente inaccesible.

Errores comunes al conectar PrestaShop a MySQL y cómo solucionarlos

A continuación te presento los errores más habituales que te puedes encontrar al configurar la conexión de PrestaShop con MySQL, junto con sus soluciones.

Error: "No se puede conectar a la base de datos"

Este es el error más genérico y puede deberse a varias causas:

Datos incorrectos: revisa que el nombre de la base, el usuario y la contraseña sean exactamente los que tienes en tu panel de control. A veces hay espacios en blanco que no se ven.
Servidor MySQL caído: comprueba que el servicio MySQL está activo en tu hosting. En Syspanel puedes ver el estado de los servicios desde la sección de bases de datos.
Puerto incorrecto: MySQL normalmente usa el puerto 3306. Si tu hosting usa otro puerto, deberás añadirlo en el campo database_port.

Error: "Acceso denegado para el usuario"

Este error significa que el usuario no tiene permisos para acceder a la base de datos. Las soluciones son:

Verifica que el usuario tiene todos los privilegios sobre la base de datos (SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP).
Comprueba que el usuario está asociado a la base de datos correcta. En muchos paneles de control, primero creas el usuario y luego lo vinculas a una base de datos.

Error: "Base de datos no encontrada"

Esto indica que el nombre de la base de datos que has introducido no existe. Revisa que lo has escrito correctamente y que la base se ha creado en el mismo servidor donde tienes la web.

Error: "La conexión se cerró inesperadamente"

Este error suele estar relacionado con la configuración del servidor. Prueba lo siguiente:

Aumenta el tiempo de espera de MySQL en tu hosting.
Comprueba que no hay límite de conexiones simultáneas.
Si tienes muchos módulos activos, puede que estés saturado el servidor. Prueba a desactivar temporalmente algunos.

[INFO] Si tu web está alojada en un servidor con Syspanel, puedes acceder a las estadísticas de MySQL desde el panel para ver cuántas conexiones se están realizando.

Consejos para evitar errores de conexión en el futuro

Para que no tengas que volver a pasar por este proceso, te recomiendo seguir estos consejos:

1. Usa contraseñas seguras

Una contraseña débil puede ser comprometida y provocar que alguien acceda a tu base de datos. Usa combinaciones de letras, números y símbolos.

2. Mantén el prefijo de tablas por defecto

Si cambias el prefijo ps_ por otro, asegúrate de recordarlo siempre. Es fácil olvidarlo y luego no entender por qué la tienda no carga.

3. Realiza copias de seguridad periódicas

Antes de hacer cualquier cambio en parameters.php, descarga una copia del archivo original. También es buena idea hacer copias de seguridad de la base de datos regularmente.

4. Documenta tus parámetros de conexión

Guarda en un lugar seguro (como un gestor de contraseñas) el nombre de tu base de datos, el usuario y la contraseña. Así, si necesitas migrar tu tienda, tendrás todos los datos a mano.

Preguntas frecuentes sobre conectar PrestaShop a MySQL

¿Puedo usar el mismo usuario MySQL para varias bases de datos?

Sí, es posible, pero no es recomendable por seguridad. Si un usuario tiene acceso a varias bases, un fallo de seguridad en una podría comprometer a todas. Lo ideal es crear un usuario específico para cada base de datos.

¿Qué hago si no recuerdo la contraseña de mi base de datos MySQL?

En la mayoría de los paneles de control de hosting puedes restablecer la contraseña de un usuario MySQL. En Syspanel, ve a la sección de bases de datos, selecciona el usuario y elige la opción de cambiar contraseña. Luego actualiza el archivo parameters.php con la nueva contraseña.

¿Puedo conectarme a una base de datos MySQL remota?

Sí, PrestaShop permite conectarse a una base de datos en otro servidor. Solo tienes que poner la dirección IP o el hostname del servidor MySQL en el campo database_host y asegurarte de que el puerto 3306 está abierto en el firewall del servidor remoto.

¿Cómo sé qué puerto usa mi MySQL?

El puerto por defecto es el 3306, pero algunos hosting usan puertos alternativos por seguridad. Puedes comprobarlo en el panel de control de tu hosting o contactando con el soporte.

Resumen final

Conectar PrestaShop a tu base de datos MySQL no tiene por qué ser un dolor de cabeza. Solo necesitas los datos correctos y saber dónde aplicarlos. Recuerda que el archivo parameters.php es tu mejor amigo en este proceso, y que tanto durante la instalación como en la configuración manual, los campos son los mismos.

Si te encuentras con un error de conexión, revisa primero los datos, luego el estado del servidor MySQL y finalmente los permisos del usuario. En la mayoría de los casos, el problema se resuelve con una simple corrección en el archivo de configuración.

Espero que esta guía te haya sido de ayuda. Si tienes alguna duda adicional, no dudes en contactar con el soporte técnico de tu hosting. Ellos podrán verificar si los parámetros que estás usando son correctos y ayudarte a solucionar cualquier problema con tu servidor MySQL.

[TIP] Si tu hosting utiliza Syspanel, recuerda que el acceso al panel es a través del puerto 2106. Allí podrás gestionar tus bases de datos, crear usuarios y comprobar el estado de los servicios MySQL de forma muy intuitiva.

Ahora ya sabes cómo conectar PrestaShop a tu base de datos MySQL. ¡Ponlo en práctica y tu tienda online funcionará sin problemas!