Cómo conectar PrestaShop a tu base de datos - Tutorial fácil

Conectar PrestaShop a una base de datos es uno de los pasos más importantes durante la instalación de tu tienda online. Sin una conexión correcta a MySQL, tu sitio no podrá almacenar productos, clientes ni pedidos. Esta guía paso a paso está diseñada para que cualquier persona, incluso sin experiencia técnica, pueda realizar esta configuración sin errores.

Vamos a explicarte desde qué necesitas hasta cómo solucionar los problemas más comunes. Sigue cada paso con atención y tendrás tu PrestaShop funcionando en pocos minutos.

¿Qué necesitas para empezar?

Antes de lanzarte a la configuración, asegúrate de tener a mano la siguiente información. Te la proporciona tu proveedor de hosting o tu panel de control (como Syspanel, que se accede por el puerto 2106).

Nombre de la base de datos: Un nombre único que hayas creado previamente.
Usuario de la base de datos: El usuario que tiene permisos sobre esa base de datos.
Contraseña del usuario: La contraseña asociada a ese usuario.
Servidor de base de datos: Generalmente es localhost, pero a veces puede ser una dirección IP o un nombre como mysql.tudominio.com.
Puerto de conexión: Normalmente es el 3306, aunque algunos hosts usan puertos alternativos.

[INFO] Si usas Syspanel (acceso por puerto 2106), puedes crear la base de datos y el usuario desde la sección "Bases de Datos". Allí verás todos estos datos listos para copiar.

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

Este paso se realiza desde el panel de control de tu hosting. Si ya tienes una base de datos creada, puedes saltarlo.

Desde Syspanel (HestiaCP)

Inicia sesión en Syspanel usando la URL: https://tudominio.com:2106.
Ve a la sección Bases de Datos.
Haz clic en Añadir base de datos.
Completa los campos:
- Nombre de la base de datos: Por ejemplo, prestashop_db.
- Usuario: Se generará automáticamente o puedes poner uno, por ejemplo presta_user.
- Contraseña: Elige una segura o usa la generada.
Haz clic en Guardar.

[TIP] Anota el nombre de la base de datos, el usuario y la contraseña. Los necesitarás en el siguiente paso.

Desde phpMyAdmin

Si tu hosting no tiene Syspanel, puedes usar phpMyAdmin:

Accede a phpMyAdmin desde el panel de tu hosting (normalmente en tudominio.com/phpmyadmin).
Inicia sesión con tu usuario administrador de MySQL.
Ve a la pestaña Bases de datos.
Escribe un nombre para tu base (ej: prestashop_db) y haz clic en Crear.
Luego, ve a la pestaña Privilegios y añade un nuevo usuario.
Asigna todos los privilegios a la base de datos que acabas de crear.

Paso 2: Descargar y preparar PrestaShop

Ahora necesitas tener los archivos de PrestaShop en tu servidor. Si aún no los has subido, hazlo ahora.

Subir los archivos al servidor

Descarga la última versión de PrestaShop desde el sitio oficial.
Descomprime el archivo ZIP en tu computadora.
Usa un cliente FTP (como FileZilla) o el administrador de archivos de Syspanel para subir la carpeta prestashop a la raíz de tu dominio (normalmente public_html o www).

[WARNING] Asegúrate de que la carpeta tenga permisos de escritura (755 o 777) para que el instalador pueda crear los archivos de configuración.

Paso 3: Iniciar el asistente de instalación

Una vez que los archivos están en el servidor, abre tu navegador y escribe la URL de tu tienda. Por ejemplo:

https://tudominio.com/prestashop

Si todo está bien, verás la pantalla de bienvenida del instalador de PrestaShop.

Seleccionar el idioma

Elige tu idioma preferido y haz clic en Siguiente. El asistente te guiará a través de varios pasos, pero el que nos interesa es la configuración de la base de datos.

Paso 4: Configurar la conexión a la base de datos

Llegarás a una pantalla titulada Configuración de la base de datos. Aquí es donde debes ingresar los datos que obtuviste en el Paso 1.

Campos a llenar

Dirección del servidor de base de datos: Escribe localhost (o la dirección que te haya dado tu hosting).
Puerto: Déjalo en 3306 a menos que sepas que es diferente.
Nombre de la base de datos: Pon el nombre que creaste, por ejemplo prestashop_db.
Usuario de la base de datos: El usuario que creaste, por ejemplo presta_user.
Contraseña: La contraseña de ese usuario.
Prefijo de las tablas: Puedes dejarlo como ps_ o cambiarlo por seguridad (ej: shop_).

[TIP] Si no estás seguro de algún dato, revisa la sección de bases de datos en Syspanel (puerto 2106) o en phpMyAdmin. Allí verás toda la información.

Probar la conexión

Antes de continuar, haz clic en el botón ¡Probar la conexión a la base de datos!. El asistente verificará si los datos son correctos.

Si todo está bien, verás un mensaje verde: "Conexión exitosa a la base de datos".
Si hay un error, aparecerá un mensaje en rojo. Los errores más comunes son:
- "No se puede conectar al servidor de base de datos": Revisa la dirección del servidor y el puerto.
- "Acceso denegado para el usuario": Verifica el usuario y la contraseña.
- "Base de datos no encontrada": Asegúrate de que el nombre de la base de datos existe.

[WARNING] Si usas Syspanel, recuerda que el puerto de acceso al panel es el 2106, pero el puerto de MySQL sigue siendo el 3306 a menos que tu hosting lo haya cambiado.

Paso 5: Completar la instalación

Una vez que la conexión es exitosa, el instalador creará las tablas necesarias en tu base de datos. Luego te pedirá:

Nombre de la tienda: El nombre de tu negocio.
Actividad principal: Elige la categoría de tu tienda.
País: Selecciona tu país.
Configuración de la cuenta de administrador: Crea un email y contraseña para acceder al back office.

Haz clic en Siguiente y espera a que termine el proceso. Al final, verás un mensaje de éxito y podrás acceder a tu tienda.

Solución de problemas comunes

A veces, incluso siguiendo todos los pasos, pueden surgir errores. Aquí tienes los más frecuentes y cómo resolverlos.

Error: "No se puede conectar al servidor MySQL"

Causa: La dirección del servidor es incorrecta o el puerto no es el 3306.
Solución: Prueba con 127.0.0.1 en lugar de localhost. Si usas Syspanel, revisa en la sección de bases de datos si hay una IP específica.

Error: "Acceso denegado para el usuario"

Causa: El usuario o la contraseña son incorrectos, o el usuario no tiene permisos sobre la base de datos.
Solución: Desde Syspanel (puerto 2106), ve a la base de datos y verifica los permisos. Puedes regenerar la contraseña o crear un nuevo usuario.

Error: "La base de datos ya existe y no está vacía"

Causa: Ya hay tablas de una instalación anterior.
Solución: Elimina las tablas antiguas desde phpMyAdmin o crea una nueva base de datos con otro nombre.

Error: "No se puede escribir el archivo de configuración"

Causa: La carpeta donde está PrestaShop no tiene permisos de escritura.
Solución: Cambia los permisos de la carpeta a 755 o 777 mediante FTP o el administrador de archivos de Syspanel.

Preguntas frecuentes (FAQ)

¿Puedo cambiar la base de datos después de instalar PrestaShop?

Sí, pero es un proceso complejo. Implica exportar los datos, crear una nueva base y modificar el archivo app/config/parameters.php. Si no tienes experiencia, es mejor pedir ayuda a un técnico.

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

Puedes cambiarla desde Syspanel (puerto 2106) en la sección de bases de datos. Luego, actualiza el archivo parameters.php con la nueva contraseña.

¿Es seguro usar "localhost" como servidor de base de datos?

Sí, es estándar y seguro si tu hosting lo soporta. Solo cambia si tu proveedor te da una IP específica.

¿Qué pasa si mi hosting usa un puerto diferente al 3306?

El instalador de PrestaShop te permite especificar el puerto. Pregunta a tu hosting cuál es y escríbelo en el campo correspondiente.

¿Puedo instalar PrestaShop sin crear primero la base de datos?

No. El instalador necesita una base de datos vacía para crear las tablas. Debes crearla antes desde Syspanel o phpMyAdmin.

Consejos finales

Haz una copia de seguridad de tu base de datos regularmente. Puedes hacerlo desde Syspanel (puerto 2106) o con plugins.
Usa contraseñas seguras para la base de datos y el administrador de PrestaShop.
Mantén actualizado tanto PrestaShop como MySQL para evitar vulnerabilidades.

Si has seguido esta guía paso a paso, ahora tu PrestaShop está conectado correctamente a la base de datos. ¡Felicidades! Ya puedes empezar a configurar tus productos y personalizar tu tienda.

[INFO] Recuerda que si usas Syspanel, el acceso es por el puerto 2106 y desde allí puedes gestionar tanto la base de datos como los archivos de tu sitio.

¿Te ha sido útil esta guía? Si tienes más dudas, no dudes en consultar la documentación oficial de PrestaShop o contactar a tu proveedor de hosting.