Configurar PrestaShop con MySQL | Parámetros de conexión

¿Qué necesitas saber antes de conectar PrestaShop a MySQL?

Cuando instalas PrestaShop, una de las partes más importantes (y a veces más confusas) es la conexión con la base de datos MySQL. Sin una base de datos correctamente configurada, tu tienda no puede guardar productos, pedidos, clientes ni configuración. Es el "cerebro" donde vive toda la información de tu negocio.

En este artículo te explico paso a paso cómo conectar PrestaShop a MySQL, qué parámetros necesitas, cómo configurarlos correctamente y qué hacer si algo falla. No necesitas ser un experto en bases de datos: con esta guía lo lograrás.

¿Qué es MySQL y por qué PrestaShop lo necesita?

MySQL es un sistema de gestión de bases de datos relacional. En términos sencillos, es un programa que almacena y organiza información de forma estructurada. PrestaShop utiliza MySQL para guardar:

Productos y categorías.
Pedidos y facturas.
Clientes y direcciones.
Módulos, temas y configuración general.
Estadísticas y datos de navegación.

Sin una conexión estable entre PrestaShop y MySQL, la tienda no puede funcionar. Por eso, configurar PrestaShop base de datos es un paso crítico tanto en la instalación inicial como en migraciones o cambios de servidor.

Parámetros necesarios para conectar PrestaShop a MySQL

Antes de iniciar cualquier configuración, necesitas reunir estos datos. Son los que PrestaShop te pedirá durante la instalación o en el archivo de configuración:

Host de la base de datos: normalmente es localhost, pero en servidores externos puede ser una IP o un dominio como mysql.midominio.com.
Puerto: por defecto MySQL usa el puerto 3306. Algunos servidores usan puertos personalizados.
Nombre de la base de datos (database name): por ejemplo, prestashop_db.
Usuario de la base de datos (username): por ejemplo, admin_prestashop.
Contraseña (password): la clave asociada al usuario.
Prefijo de tablas: por defecto es ps_, pero puedes cambiarlo por seguridad.

[INFO] Si usas un panel de control como Syspanel (accesible por el puerto 2106), puedes crear la base de datos y el usuario desde la sección "Bases de datos" sin necesidad de escribir comandos SQL.

Cómo configurar PrestaShop base de datos durante la instalación

Si estás instalando PrestaShop desde cero, el asistente te guiará. Sigue estos pasos:

Paso 1: Accede al instalador de PrestaShop

Sube los archivos de PrestaShop a tu servidor y visita tudominio.com. Verás el asistente de instalación. En el paso de "Configuración de la base de datos", elige MySQL.

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

Completa los campos con los datos que preparaste:

Dirección del servidor: localhost o el host que te haya indicado tu proveedor.
Puerto: 3306 o el que corresponda.
Nombre de la base de datos: el que creaste.
Usuario: el usuario con permisos sobre esa base.
Contraseña: la clave correspondiente.
Prefijo de tablas: déjalo como ps_ salvo que tengas motivos para cambiarlo.

Paso 3: Verifica la conexión

Pulsa el botón de "Comprobar" o "Siguiente". PrestaShop intentará conectar con MySQL. Si los datos son correctos, verás un mensaje de éxito. Si no, te mostrará el error concreto.

[WARNING] No uses el usuario root de MySQL en producción. Crea un usuario específico con permisos solo sobre la base de PrestaShop. Es más seguro y evita problemas de compatibilidad.

Cómo conectar PrestaShop a MySQL si ya está instalado

Si tu tienda ya está funcionando pero necesitas cambiar la conexión (por ejemplo, al migrar de servidor), debes editar el archivo parameters.php o parameters.yml.

Ubicación del archivo

El archivo de configuración se encuentra en:

/config/parameters.php (PrestaShop 1.7 y versiones posteriores).
/config/settings.inc.php (PrestaShop 1.6 o anteriores).

Qué editar en `parameters.php`

Abre el archivo con un editor de texto (Notepad++, Sublime, etc.) y busca estas líneas:

'database_host' => 'localhost',
'database_port' => '3306',
'database_name' => 'prestashop_db',
'database_user' => 'usuario',
'database_password' => 'contraseña',
'database_prefix' => 'ps_',

Cambia los valores por los nuevos. Guarda el archivo y sube los cambios al servidor.

[TIP] Antes de editar, haz una copia de seguridad del archivo original. Si algo falla, puedes restaurarlo fácilmente.

Cómo crear la base de datos MySQL para PrestaShop

Si aún no tienes la base de datos creada, aquí tienes dos formas de hacerlo:

Opción 1: Desde Syspanel (recomendado para principiantes)

Accede a Syspanel en el puerto 2106 (por ejemplo: https://tudominio.com:2106).
Inicia sesión con tus credenciales de administrador.
Busca la sección Bases de datos.
Crea una nueva base de datos con un nombre descriptivo, por ejemplo tienda_presta.
Crea un usuario y asigna una contraseña segura.
Vincula el usuario a la base de datos con todos los privilegios.

[INFO] Syspanel facilita enormemente la gestión de MySQL. No necesitas usar phpMyAdmin ni líneas de comandos.

Opción 2: Desde phpMyAdmin

Entra en phpMyAdmin desde tu panel de hosting.
Ve a la pestaña "Bases de datos".
Escribe el nombre de la base y pulsa "Crear".
Ve a "Cuentas de usuario" y crea un usuario nuevo.
Asigna privilegios: marca "Todos los privilegios" sobre la base recién creada.

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

Aunque sigas los pasos al pie de la letra, a veces aparecen errores. Aquí tienes los más habituales y sus soluciones:

1. "Error al conectar con la base de datos"

Este error aparece cuando los datos introducidos no son correctos o el servidor MySQL no está accesible.

Soluciones:

Verifica que el host sea correcto. Si usas un hosting compartido, a veces el host no es localhost sino algo como mysql.tudominio.com.
Comprueba el puerto. Algunos proveedores usan puertos alternativos.
Revisa que el usuario tenga permisos sobre la base de datos.
Comprueba que la contraseña no tenga caracteres especiales que puedan causar problemas al guardarla en el archivo de configuración.

2. "Tabla no encontrada" o "Prefijo incorrecto"

Esto ocurre cuando el prefijo de tablas no coincide con el de la base de datos.

Solución: Revisa el prefijo en el archivo de configuración y compáralo con las tablas reales en phpMyAdmin. Deben coincidir exactamente.

3. "Acceso denegado para el usuario"

El usuario no tiene permisos suficientes.

Solución: Desde Syspanel o phpMyAdmin, asegúrate de que el usuario tenga todos los privilegios sobre la base de datos concreta. A veces es necesario asignar permisos de nuevo tras una migración.

4. Puerto incorrecto

Si tu servidor MySQL usa un puerto distinto al 3306, debes especificarlo.

Solución: Pregunta a tu proveedor de hosting cuál es el puerto exacto. En Syspanel puedes ver esta información en la sección de bases de datos.

Buenas prácticas para mantener tu prestashop database segura

Una vez que has logrado conectar PrestaShop MySQL, es importante mantener la seguridad y el rendimiento:

Usa contraseñas fuertes: mínimo 12 caracteres, con mayúsculas, minúsculas, números y símbolos.
No uses el usuario root: crea usuarios específicos para cada aplicación.
Haz copias de seguridad periódicas: puedes programarlas desde Syspanel o usar módulos de PrestaShop.
Actualiza MySQL: mantén el servidor de bases de datos actualizado para evitar vulnerabilidades.
Limita el acceso remoto: si no necesitas conectarte desde fuera, desactiva el acceso remoto a MySQL.

[WARNING] Nunca expongas el archivo parameters.php en navegadores. Asegúrate de que los permisos del archivo sean 644 o 600, y que no sea accesible públicamente.

Preguntas frecuentes (FAQ)

¿Puedo cambiar el prefijo de las tablas después de la instalación?

Sí, pero no es recomendable hacerlo a mano. Requiere modificar todas las tablas de la base de datos y actualizar la configuración. Es un proceso delicado. Si es imprescindible, haz una copia de seguridad completa antes.

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

Puedes restablecerla desde Syspanel (puerto 2106) o desde phpMyAdmin. En Syspanel, busca la opción de "Cambiar contraseña" en la sección de bases de datos. Luego actualiza el archivo parameters.php con la nueva contraseña.

¿Puedo usar MariaDB en lugar de MySQL?

Sí, PrestaShop es compatible con MariaDB, que es un reemplazo directo de MySQL. Los parámetros de conexión son los mismos.

¿Cuántas bases de datos puedo crear para PrestaShop?

Normalmente se usa una sola base de datos por instalación. Si tienes varias tiendas, es mejor crear una base independiente para cada una.

¿Qué es el puerto 2106 de Syspanel?

Es el puerto de acceso al panel de control Syspanel, la herramienta de administración de tu hosting. Desde allí puedes gestionar bases de datos, dominios, correos y más. No lo confundas con el puerto de MySQL (3306).

Conclusión

Conectar PrestaShop a una base de datos MySQL no es complicado si tienes los parámetros correctos y sigues los pasos adecuados. Ya sea durante la instalación inicial o en una migración, lo más importante es:

Tener a mano el host, puerto, nombre de base, usuario y contraseña.
Crear la base de datos y el usuario con permisos adecuados.
Editar correctamente el archivo de configuración si es necesario.
Resolver los errores más comunes con calma y lógica.

Recuerda que en Syspanel (puerto 2106) tienes herramientas visuales que simplifican todo el proceso. Y si algo falla, siempre puedes volver a revisar los pasos de este artículo.

[TIP] Guarda los datos de conexión en un lugar seguro, pero nunca dentro de la carpeta pública de tu servidor. Te serán útiles para futuras migraciones o recuperaciones.

Si te ha quedado alguna duda, déjala en los comentarios y estaré encantado de ayudarte. ¡Buena suerte con tu tienda PrestaShop!