Conectar PrestaShop a MySQL | Tutorial práctico

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

Si estás leyendo esto, probablemente estás en medio de la instalación de tu tienda online o quizás has recibido un error de conexión a la base de datos. No te preocupes, es más común de lo que parece y hoy vamos a resolverlo juntos, paso a paso y sin tecnicismos innecesarios.

Primero, vamos a poner las cartas sobre la mesa: PrestaShop MySQL es la combinación perfecta para que tu tienda funcione. PrestaShop es el software que ves (la tienda), y MySQL es el almacén donde se guardan todos los datos (productos, clientes, pedidos). Para que ambos se entiendan, necesitan una conexión estable y bien configurada.

En esta guía para principiantes, te voy a enseñar exactamente cómo conectar PrestaShop a una base de datos MySQL, tanto durante la instalación como si necesitas hacerlo manualmente editando el archivo parameters.php. Vamos a ello.

1. ¿Qué es exactamente la conexión PrestaShop-MySQL?

Antes de lanzarnos a los pasos, es importante que entiendas qué estamos haciendo. Cuando hablamos de conectar PrestaShop base de datos, nos referimos a que el software de tu tienda envía consultas constantemente a MySQL para guardar y recuperar información.

Imagina que MySQL es un archivador gigante con cajones etiquetados. PrestaShop necesita la llave correcta para abrir esos cajones. Esa llave se compone de cuatro datos básicos:

Nombre de la base de datos (el archivador)
Usuario (quién tiene permiso para abrir)
Contraseña (la clave de acceso)
Host (dónde está ubicado el archivador, normalmente localhost)

Si cualquiera de estos cuatro datos falla, tu tienda no cargará o te mostrará el temido error: "Error de conexión a la base de datos".

2. Requisitos previos antes de empezar

Para que todo sea más fácil, asegúrate de tener esto listo:

Acceso a tu panel de control de hosting (cPanel, Plesk, Syspanel, etc.)
Credenciales de acceso a MySQL (te las da tu proveedor de hosting)
Un editor de texto simple (el Bloc de notas de Windows o TextEdit en Mac sirven perfectamente)
Cliente FTP o el administrador de archivos de tu hosting (por si necesitas editar archivos manualmente)

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), recuerda que el acceso al panel se realiza a través del puerto 2106. Por ejemplo: https://tu-dominio.com:2106. Allí encontrarás la sección de bases de datos MySQL.

3. Método 1: Conectar PrestaShop a MySQL durante la instalación

Este es el escenario más común si estás montando tu tienda desde cero. La instalación de PrestaShop te guía paso a paso, pero hay un momento crítico: la configuración de la base de datos.

Paso 1: Accede al instalador de PrestaShop

Sube los archivos de PrestaShop a tu servidor (normalmente en public_html o www) y abre tu navegador con tu dominio. Verás el asistente de instalación.

Paso 2: Llega a la pantalla de "Configuración de la base de datos"

Después de aceptar la licencia y verificar los requisitos, llegarás a la pantalla donde te pide los datos de la base de datos. Esto es lo que verás:

Servidor de base de datos: normalmente localhost, pero verifica con tu hosting.
Nombre de la base de datos: el que hayas creado previamente.
Usuario de la base de datos: el usuario asociado a esa base.
Contraseña: la clave de ese usuario.
Prefijo de las tablas: déjalo como ps_ por defecto.

[TIP] En la mayoría de hostings, el nombre de la base y el usuario llevan un prefijo con tu cuenta. Por ejemplo, si tu hosting es mihosting, podría ser mihosting_prestashop y mihosting_admin. Revisa tu panel de control.

Paso 3: Prueba la conexión

PrestaShop tiene un botón para comprobar la conexión. Si todo está bien, continúa. Si falla, revisa que hayas escrito bien los datos. Un error típico es copiar espacios extra o confundir mayúsculas.

4. Método 2: Conectar PrestaShop a MySQL manualmente mediante parameters.php

¿Ya tienes PrestaShop instalado pero necesitas cambiar la base de datos? ¿O quizás tu archivo de configuración se ha corrompido? Aquí es donde entra en juego el archivo parameters.php.

Este archivo es el corazón de la configuración de tu tienda. Se encuentra en la carpeta app/config/ de tu instalación de PrestaShop.

Paso 1: Localiza el archivo

Accede a tu servidor mediante FTP o el administrador de archivos del hosting. Busca la ruta:

/public_html/app/config/parameters.php

Paso 2: Descarga y abre el archivo

Descárgalo a tu computadora y ábrelo con tu editor de texto. Verás un código PHP con una estructura similar a esta (simplificada):

<?php
return [
    'parameters' => [
        'database_host' => 'localhost',
        'database_name' => 'tu_base_de_datos',
        'database_user' => 'tu_usuario',
        'database_password' => 'tu_contraseña',
        'database_prefix' => 'ps_',
        // ... más parámetros
    ],
];

Paso 3: Edita los valores

Cambia estos cuatro campos clave:

database_host: generalmente localhost, pero puede ser una IP o un hostname remoto.
database_name: el nombre exacto de tu base de datos MySQL.
database_user: el usuario con permisos sobre esa base.
database_password: la contraseña del usuario.

[WARNING] Respeta las comillas simples. Si tu contraseña contiene comillas simples, debes escaparlas con una barra invertida (ej: \'). De lo contrario, el archivo dará un error de sintaxis.

Paso 4: Guarda y sube el archivo

Guarda los cambios y sube el archivo de vuelta a tu servidor, reemplazando el original.

Paso 5: Borra el caché

Después de subir el archivo, es muy importante borrar la caché de PrestaShop. Puedes hacerlo eliminando la carpeta var/cache (en versiones modernas) o cache (en versiones antiguas). No te preocupes, PrestaShop la recreará automáticamente.

[TIP] Si no puedes borrar la carpeta completa, elimina solo su contenido. En muchas ocasiones, dejar archivos residuales en caché provoca que los cambios en parameters.php no se apliquen de inmediato.

5. Cómo crear una base de datos MySQL para PrestaShop

Si aún no tienes la base de datos creada, aquí te explico cómo hacerlo según el panel de tu hosting. Es un proceso de 2 minutos.

En cPanel

Ve a la sección "Bases de datos MySQL".
Crea una nueva base de datos (ej: tienda_prestashop).
Crea un usuario (ej: tienda_admin) con una contraseña segura.
Asigna el usuario a la base de datos con todos los privilegios.

En Syspanel (puerto 2106)

Accede a https://tu-dominio.com:2106.
Busca la sección "Base de datos" o "MySQL".
Crea una base de datos nueva.
Crea un usuario y asígnalo a la base con permisos completos.

[INFO] Asegúrate de que la contraseña sea robusta. PrestaShop guarda esta contraseña en parameters.php, así que no la compartas ni la uses en otros servicios.

6. Errores comunes al conectar PrestaShop con MySQL y cómo solucionarlos

Aquí tienes una lista de los problemas más frecuentes que te puedes encontrar:

Error: "La conexión a la base de datos no se pudo establecer"

Causa probable: Datos incorrectos.
Solución: Revisa el nombre de la base, el usuario y la contraseña. Prueba a conectarte desde phpMyAdmin (o la herramienta de tu hosting) con esas mismas credenciales.

Error: "Access denied for user"

Causa probable: El usuario no tiene permisos o la contraseña está mal.
Solución: Ve a tu panel de hosting y verifica los privilegios del usuario. Asegúrate de que tenga acceso a la base de datos específica.

Error: "Unknown database"

Causa probable: La base de datos no existe o escribiste mal el nombre.
Solución: Verifica en tu panel de control que el nombre sea exacto, incluyendo prefijos.

Error: "Maximum execution time exceeded"

Causa probable: La base de datos es muy grande o el servidor está lento.
Solución: Aumenta el tiempo de ejecución en php.ini o contacta con tu hosting.

7. Preguntas frecuentes (FAQ) sobre PrestaShop y MySQL

¿Puedo cambiar la base de datos de PrestaShop sin reinstalar?

Sí. Solo tienes que editar el archivo parameters.php y borrar la caché. Eso sí, asegúrate de que la nueva base de datos tenga la estructura de PrestaShop (tablas). Si es una base vacía, necesitarás importar una copia de seguridad.

¿Qué prefijo de tablas debo usar?

El prefijo por defecto es ps_. Si tienes varias tiendas en la misma base, puedes diferenciarlas con prefijos distintos. Si no, déjalo como está.

¿Puedo usar MariaDB en lugar de MySQL?

Sí, son compatibles. PrestaShop funciona perfectamente con MariaDB, que es un reemplazo directo de MySQL en la mayoría de los casos.

¿Necesito conocimientos avanzados para editar `parameters.php`?

No. Si sigues los pasos de esta guía, solo necesitas saber copiar y pegar los datos correctos. Eso sí, haz siempre una copia de seguridad del archivo antes de editarlo.

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

Puedes cambiar la contraseña desde tu panel de control de hosting. Luego actualiza parameters.php con la nueva contraseña y borra la caché.

8. Consejos finales para mantener tu base de datos PrestaShop en buen estado

Una vez que hayas logrado conectar PrestaShop a tu base de datos MySQL, es importante mantenerla sana:

Haz copias de seguridad periódicas de tu base de datos. Muchos hostings ofrecen backups automáticos, pero no está de más tener una copia manual.
Optimiza las tablas de vez en cuando desde phpMyAdmin (opción "Optimizar tabla").
No compartas las credenciales de acceso a la base de datos con nadie que no sea de confianza.
Mantén PrestaShop actualizado para evitar vulnerabilidades que puedan comprometer tu base de datos.

[WARNING] Nunca modifiques los parámetros de la base de datos mientras tu tienda esté recibiendo visitas. El cambio de conexión puede causar errores temporales. Es recomendable hacerlo en horas de bajo tráfico o poner tu tienda en modo mantenimiento.

Resumen final

Conectar PrestaShop a una base de datos MySQL no tiene por qué ser un dolor de cabeza. Tanto si lo haces durante la instalación como si necesitas editar el archivo parameters.php manualmente, lo único que necesitas son los cuatro datos correctos: host, nombre de base, usuario y contraseña.

Recuerda que el archivo parameters.php es tu mejor amigo cuando algo falla. Si tu tienda se cae por un problema de conexión, ese archivo es el primer lugar donde debes mirar.

Si tu hosting usa Syspanel, no olvides que el acceso se realiza a través del puerto 2106 y allí podrás gestionar tus bases de datos MySQL de forma sencilla.

Ahora que ya sabes cómo hacerlo, ponte manos a la obra. Tu tienda online te lo agradecerá. Si te surge cualquier duda, repasa esta guía paso a paso o consulta con tu proveedor de hosting. ¡Buena suerte con tu PrestaShop!