Conectar PrestaShop a MySQL: Configuración de la Base de Datos

Introducción: ¿Por qué es tan importante la conexión a la base de datos en PrestaShop?

Cuando decides montar una tienda online con PrestaShop, uno de los pasos más críticos y, a la vez, más temidos para los principiantes es la configuración de la base de datos. Sin una conexión correcta entre tu instalación de PrestaShop y tu servidor MySQL, simplemente no podrás operar. La base de datos es el cerebro de tu tienda: almacena desde los productos, clientes, pedidos, precios, módulos, hasta la configuración más básica del sistema.

Muchos usuarios se bloquean en este paso, especialmente si no tienen experiencia previa con servidores o con el panel de control de su hosting. Sin embargo, te adelanto que no es tan complicado como parece. En esta guía extensa, te explicaré paso a paso, con un lenguaje muy sencillo y didáctico, cómo conectar PrestaShop a una base de datos MySQL. Al final, tendrás tu instalación funcionando y entenderás perfectamente qué es cada dato que te piden.

Vamos a desglosar todo el proceso: desde qué es una base de datos, cómo crearla en tu hosting (incluyendo ejemplos con paneles como cPanel o Syspanel), hasta la configuración final en el instalador de PrestaShop. También resolveremos las dudas más frecuentes que nos llegan al soporte técnico. Así que, si estás listo, ¡empecemos!

¿Qué es una base de datos y por qué PrestaShop la necesita?

Antes de lanzarnos a la acción, es fundamental que entiendas el concepto. Una base de datos es un sistema organizado para almacenar y recuperar información. En el contexto de una tienda online, imagina que es un gigantesco almacén con estanterías perfectamente etiquetadas. Cada estantería contiene datos: una para los productos, otra para los clientes, otra para los pedidos, etc.

PrestaShop es un software que se comunica constantemente con esa base de datos para mostrar información en tu tienda y para guardar las acciones que realizan tus clientes. Cuando un visitante entra a tu web, PrestaShop consulta la base de datos para saber qué productos tienes, qué precio tienen, si hay stock, etc. Cuando alguien hace un pedido, PrestaShop escribe en la base de datos los detalles de esa compra.

Por lo tanto, sin una conexión estable y correcta entre PrestaShop y MySQL, tu tienda no podría funcionar. El instalador de PrestaShop te pedirá los datos de acceso a esa base de datos para poder "enganchar" el software a tu almacén de información. Si esos datos son incorrectos, la instalación fallará o, si ya está instalada, la tienda mostrará errores graves.

Requisitos previos antes de conectar PrestaShop a MySQL

No queremos que te encuentres con sorpresas a mitad del proceso. Aquí tienes una lista de verificación de lo que necesitas tener a mano antes de comenzar la instalación de PrestaShop y la conexión a la base de datos:

Acceso a tu panel de control de hosting: Normalmente cPanel, Plesk o Syspanel. Necesitas poder crear bases de datos y usuarios.
Credenciales de acceso a MySQL: Incluye el nombre de la base de datos, el nombre de usuario y la contraseña.
Los archivos de PrestaShop: Ya sea descargados desde la web oficial o subidos a tu servidor mediante FTP.
Un dominio o subdominio: Donde quieras instalar la tienda.
PHP y MySQL en tu servidor: La mayoría de los hostings ya lo incluyen, pero verifica que la versión sea compatible con la de PrestaShop que vas a instalar.

[!INFO]
Si tu hosting utiliza el panel Syspanel (antes conocido como HestiaCP), recuerda que el acceso a este panel se realiza a través del puerto 2106 (por ejemplo, https://tu-dominio.com:2106). El proceso de creación de bases de datos es muy similar a otros paneles, pero te lo detallaré más adelante para que no te pierdas.

Paso 1: Crear la base de datos y el usuario MySQL

Este es el primer gran escollo para muchos. No puedes simplemente poner cualquier nombre; debes crear una base de datos vacía y un usuario con permisos para que PrestaShop pueda conectarse. Te explico cómo hacerlo en los dos paneles de control más comunes.

Crear base de datos en cPanel

Accede a cPanel con tus credenciales.
Busca la sección "Bases de Datos MySQL" (a veces aparece como "MySQL Databases").
En el campo "Crear nueva base de datos", escribe un nombre descriptivo, por ejemplo, tienda_prestashop. Haz clic en "Crear base de datos".
Un poco más abajo, en la sección "Crear usuario de MySQL", escribe un nombre de usuario (ej. admin_tienda) y una contraseña segura. Anota estos datos, los necesitarás después.
Ahora, en la sección "Añadir usuario a la base de datos", selecciona el usuario que acabas de crear y la base de datos que creaste. Haz clic en "Añadir".
Te aparecerá una ventana para asignar privilegios. Marca la casilla "TODOS LOS PRIVILEGIOS" y haz clic en "Realizar cambios".

¡Listo! Ya tienes tu base de datos y tu usuario creados en cPanel.

Crear base de datos en Syspanel (HestiaCP)

Como mencioné, si usas Syspanel, el acceso es por el puerto 2106. El proceso es un poco diferente pero igual de sencillo:

Accede a Syspanel con tu usuario y contraseña.
En el menú superior o lateral, busca la opción "Bases de datos" o "Databases".
Haz clic en "Añadir base de datos" o el botón "+".
Te pedirá un nombre para la base de datos, un usuario y una contraseña. En Syspanel, el nombre de la base de datos y el usuario suelen llevar un prefijo automático (por ejemplo, tu_usuario_nombre_bd). No te preocupes, es normal.
Rellena los campos y guarda. Syspanel creará automáticamente el usuario con todos los privilegios sobre esa base de datos.

[!TIP]
En Syspanel, a diferencia de cPanel, no tienes que añadir el usuario a la base de datos manualmente, ya se hace en el mismo paso. Es un poco más directo.

Paso 2: Subir los archivos de PrestaShop a tu servidor

Una vez que tienes la base de datos creada, es hora de subir los archivos de PrestaShop. Puedes hacerlo de dos maneras: usando el instalador web (recomendado para principiantes) o subiendo los archivos por FTP.

Opción A: Usar el instalador web (más fácil)

Descarga el paquete de PrestaShop desde la web oficial (prestashop.com) o desde el área de clientes de tu hosting.
Sube el archivo .zip a la carpeta public_html (o la carpeta raíz de tu dominio) mediante el administrador de archivos de tu panel de control o FTP.
Una vez subido, descomprime el archivo. Si tu hosting no tiene un descompresor, puedes hacerlo en tu ordenador y subir todos los archivos descomprimidos por FTP.
Asegúrate de que el archivo index.php de PrestaShop esté en la raíz de tu dominio o en la subcarpeta donde quieras instalarlo.

Opción B: Subir los archivos por FTP

Conecta a tu servidor usando un cliente FTP como FileZilla.
Navega hasta la carpeta public_html.
Arrastra todos los archivos de PrestaShop (ya descomprimidos en tu ordenador) a esa carpeta.

[!WARNING]
Asegúrate de que la carpeta de instalación esté vacía o que no exista un archivo index.php de otro sistema, ya que podría interferir con la instalación. Si ya tienes contenido, es mejor instalar PrestaShop en una subcarpeta (ej. /tienda).

Paso 3: Ejecutar el instalador de PrestaShop

Ahora viene lo bueno. Abre tu navegador y escribe la URL de tu dominio (o la subcarpeta donde subiste los archivos). El instalador de PrestaShop se lanzará automáticamente y te guiará en varios pasos. Uno de los pasos más importantes es el de la configuración de la base de datos.

Configuración de la base de datos en el instalador

Este es el paso clave que da título a nuestro artículo: conectar PrestaShop MySQL. En la pantalla del instalador, verás un formulario con varios campos. Te explico cada uno:

Motor de base de datos: Normalmente ya viene seleccionado por defecto como "MySQL" o "MariaDB". No lo cambies si no sabes lo que haces.
Dirección del servidor de base de datos: Aquí debes poner el host. En el 90% de los casos, es localhost. Pero en algunos hostings, especialmente en Syspanel, puede ser algo como localhost:3306 o una dirección IP específica. Si no estás seguro, consulta la documentación de tu hosting. Si usas Syspanel, lo más común es que sea localhost.
Nombre de la base de datos: Es el nombre que creaste en el paso 1. Por ejemplo, tienda_prestashop o tu_usuario_nombre_bd.
Usuario de la base de datos: El usuario que creaste. Ejemplo: admin_tienda o tu_usuario_nombre_bd.
Contraseña de la base de datos: La contraseña que asignaste a ese usuario.
Prefijo de las tablas: Puedes dejarlo como ps_ por defecto. Esto se usa para diferenciar las tablas de PrestaShop si compartes la base de datos con otra aplicación. No lo cambies a menos que sepas lo que haces.

Rellena todos los campos con los datos que anotaste anteriormente. Es importante que sean exactos, incluyendo mayúsculas y minúsculas.

[!TIP]
Si tu hosting tiene un nombre de usuario con prefijo (como en Syspanel), es posible que el nombre de la base de datos y el usuario también tengan ese prefijo. Por ejemplo, si tu usuario de hosting es cliente01, la base de datos podría llamarse cliente01_tienda. Revisa bien en el panel de control para copiar el nombre exacto.

Solución de problemas comunes en la conexión

A veces, a pesar de seguir los pasos, el instalador da un error. Los más comunes son:

"Error al conectar con la base de datos": Revisa que el nombre de la base de datos, usuario y contraseña sean correctos. Recuerda que en cPanel el nombre de la base de datos suele llevar el prefijo del usuario de cPanel (ej. usuario_bd).
"La base de datos no existe": Verifica que la base de datos se haya creado correctamente en el panel de control.
"Acceso denegado para el usuario": Asegúrate de que has añadido el usuario a la base de datos y que le has dado todos los privilegios. En cPanel, este es un error muy común si olvidas este paso.
"El servidor MySQL no está disponible": Esto puede deberse a que el servidor está caído o a que la dirección del servidor es incorrecta. Prueba con localhost o consulta con tu proveedor de hosting.

[!WARNING]
Si estás usando Syspanel, asegúrate de que el puerto de la base de datos no esté bloqueado. Aunque el acceso al panel sea por el puerto 2106, la base de datos MySQL normalmente usa el puerto 3306. No deberías tener que tocar nada, pero si el error persiste, contacta con tu proveedor de hosting.

Paso 4: Completar la instalación

Una vez que el instalador acepta la conexión a la base de datos, continúa con el resto de la instalación. Te pedirá:

Información de tu tienda: Nombre, actividad, país, etc.
Creación de la cuenta de administrador: Correo electrónico y contraseña para acceder al panel de administración de PrestaShop.
Instalación de módulos: Puedes elegir instalar módulos adicionales o dejarlo solo con los básicos.

Al finalizar, PrestaShop te pedirá que elimines la carpeta install por seguridad. Es crucial que lo hagas para evitar que alguien pueda reinstalar tu tienda o acceder a tu base de datos.

Paso 5: Verificar la conexión y la configuración

Una vez instalado, es hora de asegurarse de que todo funciona correctamente. Puedes hacer lo siguiente:

Accede a tu tienda en el front-end (la parte pública) y navega por ella. Deberías ver los productos de ejemplo que se instalan por defecto.
Accede al panel de administración (normalmente en /admin o la URL que configuraste). Si puedes entrar, la conexión a la base de datos es correcta.
Realiza una prueba de compra (puedes usar el modo de prueba o crear un pedido ficticio) para verificar que los datos se guardan correctamente.

Si todo esto funciona, ¡felicidades! Has conectado PrestaShop a tu base de datos MySQL con éxito.

FAQ: Preguntas frecuentes sobre la conexión de PrestaShop a MySQL

Aquí tienes las dudas más habituales que nos llegan al soporte:

¿Puedo usar una base de datos existente para PrestaShop?

Sí, puedes usar una base de datos existente, pero te recomiendo encarecidamente que crees una nueva y dedicada solo para PrestaShop. Esto evita conflictos con otras aplicaciones y facilita las copias de seguridad y la gestión. Si usas una existente, asegúrate de que el prefijo de las tablas sea único (ej. ps_).

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

Puedes cambiar la contraseña del usuario de MySQL desde tu panel de control (cPanel, Syspanel, etc.). Busca la sección de "Bases de datos MySQL" y allí encontrarás la opción de cambiar la contraseña. Después, actualiza el archivo app/config/parameters.php de tu instalación de PrestaShop con la nueva contraseña.

¿Puedo conectar PrestaShop a una base de datos remota?

Sí, es posible, pero no es recomendable para principiantes. Necesitarás la dirección IP del servidor remoto y asegurarte de que el puerto 3306 esté abierto. Además, la latencia puede afectar al rendimiento de tu tienda. En la mayoría de los casos, es mejor usar una base de datos local.

¿Qué es el prefijo de tabla y por qué es importante?

El prefijo de tabla es un texto que se añade al nombre de cada tabla en la base de datos (ej. ps_productos, ps_pedidos). Sirve para que, si compartes una base de datos con otras aplicaciones, no haya conflictos de nombres. Puedes cambiarlo durante la instalación, pero es más seguro dejarlo como ps_.

¿Cómo migro mi base de datos de PrestaShop a otro servidor?

Este es un proceso más avanzado. Deberás exportar la base de datos desde el servidor original (usando phpMyAdmin, por ejemplo) e importarla en el nuevo servidor. Luego, debes editar el archivo app/config/parameters.php con los nuevos datos de conexión. Si no te sientes seguro, es mejor contratar un servicio de migración.

Conclusión

Conectar PrestaShop a una base de datos MySQL es un proceso que, aunque puede parecer intimidante al principio, es totalmente manejable si sigues los pasos correctos. Hemos visto desde qué es una base de datos, cómo crearla en paneles como cPanel o Syspanel, hasta cómo rellenar correctamente el formulario del instalador de PrestaShop.

Recuerda siempre estos puntos clave:

Crea una base de datos y un usuario dedicados para tu tienda.
Anota todos los datos (nombre, usuario, contraseña) en un lugar seguro.
Añade todos los privilegios al usuario sobre la base de datos.
Revisa que el host sea localhost en la mayoría de los casos.
Elimina la carpeta install al terminar.

Si has llegado hasta aquí y has seguido los pasos, es muy probable que tu tienda ya esté operativa. Si te encuentras con algún error, no dudes en consultar la documentación oficial de PrestaShop o contactar con el soporte de tu hosting. La