Conectar PrestaShop a MySQL en Syspanel | Parámetros correctos

¿Estás intentando conectar tu PrestaShop a una base de datos en Syspanel y te encuentras con pantallas de error o simplemente no sabes por dónde empezar? No te preocupes, es una de las tareas más comunes al montar una tienda online, y hoy vamos a desglosarla paso a paso, como si lo hiciéramos juntos en una llamada de soporte.

En esta guía completa, vamos a explicar todo lo que necesitas saber sobre la conexión MySQL de PrestaShop con Syspanel. Hablaremos de los parámetros exactos que debes introducir, dónde encontrarlos dentro de tu panel de control y, lo más importante, cómo solucionar el temido error de conexión de PrestaShop si aparece. Vamos a ello.

¿Qué necesitas antes de empezar?

Antes de lanzarnos a escribir código o configurar archivos, es crucial tener dos cosas claras: tu dominio y tu acceso a Syspanel. Si ya tienes una tienda funcionando, este proceso suele ser necesario cuando cambias de servidor, restauras una copia de seguridad o instalas PrestaShop desde cero.

Para conectar PrestaShop a Syspanel, necesitarás tener creada una base de datos y un usuario con permisos sobre ella. Si no sabes cómo hacerlo, no te preocupes, lo veremos en la siguiente sección. Asegúrate de tener a mano:

Tu nombre de usuario y contraseña de Syspanel.
El nombre de tu dominio principal (por ejemplo, mydominio.com).
Si tu tienda usa un subdominio (como tienda.mydominio.com), también lo necesitarás.

Paso 1: Localizar y crear tu base de datos en Syspanel

El primer paso para una correcta conexión MySQL PrestaShop es asegurarte de que la base de datos existe. Syspanel (recuerda, el acceso es a través del puerto 2106) tiene una sección específica para esto. Aquí te cuento cómo navegar.

Acceso a la sección de Bases de Datos

Abre tu navegador y escribe la dirección de tu servidor seguido de dos puntos y el puerto. Normalmente será algo como https://tu-servidor:2106. Introduce tus credenciales de administrador y accede.
Una vez dentro, busca en el menú lateral o superior la opción que dice "Bases de Datos" o "Base de datos MySQL". En Syspanel, esta sección suele estar claramente identificada.

Crear una nueva base de datos (si no la tienes)

Si es la primera vez que entras, verás un botón que dice "Añadir base de datos" o "Crear base de datos". Haz clic ahí.

Nombre de la base de datos: Elige un nombre descriptivo, por ejemplo, prestashop_db. IMPORTANTE: En Syspanel, a menudo el nombre se prefija con tu usuario, por ejemplo, usuario_prestashop_db. Anota el nombre completo tal y como se muestra.
Usuario de la base de datos: Crea un usuario nuevo, por ejemplo, prestashop_user.
Contraseña: Genera una contraseña segura. Guarda esta información en un lugar seguro, la necesitarás en el siguiente paso.

[INFO] En Syspanel, a diferencia de otros paneles, la creación de la base de datos y el usuario suele hacerse en el mismo formulario. No necesitas crear el usuario por separado, el sistema lo hace por ti y te lo muestra en la confirmación.

Una vez creada, verás una lista con tu nueva base de datos y los detalles de acceso. No cierres esta ventana todavía, la necesitamos para el siguiente paso.

Paso 2: Los parámetros de conexión exactos para PrestaShop

Ahora viene la parte técnica. Cuando PrestaShop te pide los datos de conexión, encontrarás campos como "Dirección del servidor de base de datos", "Nombre de la base de datos", etc. Aquí tienes la equivalencia exacta con Syspanel.

Parámetros que debes rellenar

Abre tu instalación de PrestaShop o el archivo de configuración parameters.php (si ya tienes una tienda). En la pantalla de instalación, encontrarás el formulario de "Información de la base de datos". Rellénalo así:

Dirección del servidor de base de datos (Host): Aquí viene el truco. No pongas localhost a la ligera. En Syspanel, el host suele ser localhost si tu tienda está en el mismo servidor que la base de datos. Sin embargo, si estás usando un servidor externo o un hosting compartido de Syspanel, es posible que necesites la dirección IP o el nombre de host que se te proporcionó. La opción más segura es usar localhost, pero si te da error, revisa el correo de bienvenida de tu servicio o la sección de "Detalles de la base de datos" en Syspanel, donde a veces aparece la IP del servidor MySQL.
Nombre de la base de datos: Aquí va el nombre completo que anotaste antes, incluyendo el prefijo de usuario si lo tiene. Ejemplo: usuario_prestashop_db.
Usuario de la base de datos: El usuario que creaste, también con su prefijo si aplica. Ejemplo: usuario_prestashop_user.
Contraseña de la base de datos: La contraseña que generaste.
Prefijo de las tablas: Por defecto, PrestaShop usa ps_. Puedes dejarlo así o cambiarlo por seguridad (por ejemplo, shop_). Es un campo opcional pero recomendable.

[TIP] Si estás editando el archivo parameters.php manualmente, busca las líneas que dicen database_host, database_name, database_user y database_password. Asegúrate de que los valores estén entre comillas simples, así: 'database_host' => 'localhost',.

¿Y si uso puertos diferentes?

Syspanel, por defecto, usa el puerto estándar de MySQL (3306). No suele ser necesario especificarlo. Sin embargo, si tu configuración es avanzada y tienes un puerto personalizado, en el campo "Dirección del servidor" puedes escribirlo así: localhost:3307. Pero en el 99% de los casos, con localhost es suficiente.

Paso 3: Instalación de PrestaShop desde cero

Si estás instalando PrestaShop por primera vez, el asistente te guiará. Después de los pasos de idioma y licencia, llegarás a la pantalla de "Información de la base de datos". Simplemente rellena los campos con los parámetros de base de datos de PrestaShop que hemos visto en el paso anterior.

El asistente comprobará la conexión automáticamente. Si todo está bien, verás un mensaje verde de éxito y podrás continuar con la instalación de tu tienda.

Error de conexión PrestaShop: Solución de problemas comunes

Es el momento que todos tememos. Has introducido los datos y, de repente, aparece un mensaje rojo: "Error de conexión a la base de datos" o similar. No entres en pánico. Aquí tienes las causas más frecuentes y cómo solucionarlas.

1. El problema del Host: `localhost` vs. IP

El error más común es usar localhost cuando no corresponde. En algunos entornos de Syspanel, especialmente si tu dominio está en un servidor y la base de datos en otro (aunque sea el mismo panel), la conexión falla.

Solución: Prueba a cambiar el campo "Dirección del servidor" a 127.0.0.1. Si eso no funciona, busca en Syspanel el nombre de host de tu base de datos. A veces aparece como mysql.tudominio.com. Usa ese valor.

2. Usuario, contraseña o nombre incorrectos

Es muy fácil equivocarse al copiar el nombre de usuario o la base de datos, sobre todo con los prefijos.

Solución: Revisa en Syspanel que has copiado exactamente el nombre de la base de datos y el usuario, incluyendo mayúsculas y minúsculas. Te recomiendo que uses la opción de "ver" o el icono de ojo para mostrar la contraseña y asegurarte de que no hay espacios.

[WARNING] Los nombres de usuario y bases de datos en Syspanel son sensibles a mayúsculas. Usuario_Pre no es lo mismo que usuario_pre. Cópialos siempre directamente.

3. Permisos de usuario insuficientes

A veces, el usuario que creaste no tiene todos los privilegios sobre la base de datos.

Solución: En Syspanel, entra en la sección de tu base de datos. Busca la pestaña o botón de "Usuarios" o "Privilegios". Asegúrate de que tu usuario tiene seleccionados TODOS los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.). Si no, márcalos todos y guarda los cambios.

4. El puerto de conexión está bloqueado

Aunque es raro, algunos firewalls bloquean el puerto MySQL (3306) entre aplicaciones.

Solución: No es algo que se pueda solucionar desde PrestaShop. Deberías contactar con el soporte de Syspanel para verificar que el puerto está abierto para conexiones locales. Si usas una IP externa, asegúrate de que está permitida en la lista blanca de Syspanel (si existe esa opción).

5. El archivo `parameters.php` está corrupto o mal configurado

Si estás restaurando una copia de seguridad, el archivo de configuración puede tener datos antiguos.

Solución: Edita el archivo parameters.php en la raíz de tu instalación de PrestaShop. Busca las líneas de la base de datos y actualízalas con los nuevos parámetros. Asegúrate de que el archivo tenga permisos de lectura (644) para que PHP pueda leerlo.

Configuración avanzada: Editar `parameters.php` manualmente

Si ya tienes PrestaShop instalado y solo quieres cambiar la conexión (por ejemplo, tras una migración), no necesitas reinstalar. Solo tienes que editar un archivo.

Localizar y editar el archivo

Conecta a tu servidor por FTP o mediante el administrador de archivos de Syspanel.
Navega a la carpeta raíz de tu tienda (donde están las carpetas admin, config, src, etc.).
Busca la carpeta app y dentro de ella, la carpeta config.
Encuentra el archivo parameters.php. Ábrelo con un editor de texto (como el Bloc de notas o Visual Studio Code).

Modificar los parámetros

Dentro del archivo, verás una estructura similar a esta:

return array (
  'parameters' => array (
    'database_host' => 'localhost',
    'database_port' => '',
    'database_name' => 'tu_base_de_datos',
    'database_user' => 'tu_usuario',
    'database_password' => 'tu_contraseña',
    'database_prefix' => 'ps_',
    // ... otros parámetros
  ),
);

Cambia los valores de database_host, database_name, database_user y database_password por los correctos. Guarda el archivo y súbelo de nuevo si lo has editado localmente.

[WARNING] Haz siempre una copia de seguridad de parameters.php antes de editarlo. Un error tipográfico puede dejar tu tienda inaccesible.

Preguntas Frecuentes (FAQ) sobre la conexión MySQL en Syspanel

Para finalizar, resolvamos algunas dudas rápidas que suelen surgir.

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

No es recomendable. Cada instalación necesita su propio conjunto de tablas con un prefijo único. Si usas la misma base, los datos se mezclarán y causarán conflictos graves. Crea una base de datos separada para cada tienda.

¿Qué hago si olvido mi contraseña de la base de datos?

En Syspanel, ve a la sección de "Bases de Datos", selecciona tu base de datos y busca la opción de "Cambiar contraseña" o "Resetear contraseña". Te pedirá que introduzcas una nueva. Luego, actualiza el valor en parameters.php.

¿Necesito crear un usuario para cada base de datos?

Sí, es la práctica más segura. Cada base de datos debe tener un usuario específico con permisos solo sobre esa base. Esto limita el daño si una cuenta se ve comprometida.

¿Por qué me sale el error "Connection refused" (Conexión rechazada)?

Esto casi siempre indica que el host que has puesto no es correcto o que el servidor MySQL no está accesible desde donde estás ejecutando PrestaShop. Revisa el paso 3.1 sobre el host.

¿Syspanel soporta conexiones SSL para MySQL?

Algunas configuraciones avanzadas de Syspanel pueden ofrecer SSL para las conexiones a bases de datos. Sin embargo, para una instalación estándar en el mismo servidor, no es necesario y puede complicar la configuración. Es mejor dejarlo desactivado a menos que sepas con certeza que tu proveedor lo requiere.

Con esta guía, ya tienes todo lo necesario para que tu PrestaShop y Syspanel hablen entre sí sin problemas. Recuerda que la paciencia es clave. Si has seguido todos los pasos y el error de conexión de PrestaShop persiste, revisa los logs de error de tu servidor (en Syspanel, dentro de la sección de "Registros" o "Logs") para obtener pistas más concretas. ¡Mucha suerte con tu tienda online!