PrestaShop y MySQL: cómo configurar la conexión a la base de datos

Requisitos previos para conectar PrestaShop a MySQL

Antes de lanzarte a la aventura de instalar o migrar tu tienda online, es fundamental que entiendas qué necesitas tener preparado. Conectar PrestaShop a una base de datos MySQL no es un proceso mágico, sino una serie de pasos lógicos que requieren ciertos datos y herramientas. Si ya tienes experiencia con otras plataformas como WordPress, la mecánica te resultará familiar, pero PrestaShop tiene sus propias particularidades.

Para que la prestashop mysql conexión sea un éxito a la primera, necesitarás lo siguiente:

Acceso a tu panel de control de hosting: Ya sea cPanel, Plesk, o el panel personalizado de tu proveedor. Aquí es donde crearás la base de datos y el usuario.
Credenciales de acceso a MySQL: Esto incluye el nombre de la base de datos, el nombre de usuario y la contraseña. Suelen tener prefijos como usuario_bd o cliente_mitienda.
Los archivos de PrestaShop: Ya sea el paquete de instalación descargado desde la web oficial o los archivos de una instalación existente que quieras migrar a un nuevo servidor.
Un cliente FTP o el administrador de archivos de tu hosting: Para subir los archivos de PrestaShop a tu servidor, si es una instalación desde cero.
Conocimientos básicos de qué es una base de datos: No necesitas ser un DBA (Administrador de Bases de Datos), pero entender que MySQL almacena todos tus productos, pedidos y clientes te ayudará a valorar la importancia de este paso.

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

Piensa en MySQL como el "cerebro" o el "almacén" de tu tienda. Todos los datos de tus productos, precios, clientes, pedidos, contraseñas (cifradas) y configuraciones se guardan en tablas dentro de esta base de datos. Cuando un cliente visita tu tienda, PrestaShop consulta MySQL para mostrarle la información. Si la conexión falla, tu tienda mostrará un error clásico como "Error de conexión a la base de datos" o "Link to database cannot be established".

Por lo tanto, configurar correctamente los parámetros prestashop mysql es el paso más crítico de la instalación. Un error tipográfico en la contraseña o un nombre de base de datos incorrecto hará que la instalación se detenga.

Paso 1: Crear la base de datos MySQL en tu hosting

El primer paso es crear el "espacio vacío" donde PrestaShop guardará toda su información. Este proceso se realiza siempre desde el panel de control de tu proveedor de hosting, no desde PrestaShop.

Usando cPanel (el panel más común)

Accede a tu cPanel con las credenciales que te dio tu hosting.
Busca la sección "Bases de Datos" y haz clic en el ícono "Asistentes para Bases de Datos MySQL" o "Bases de datos MySQL".
Si usas el asistente, sigue los pasos: crea un nombre para la base de datos (ej. miprestashop), luego crea un usuario (ej. admin_tienda) y una contraseña segura. El asistente te pedirá que asignes el usuario a la base de datos.
IMPORTANTE: En el paso de asignar privilegios, elige "TODOS LOS PRIVILEGIOS". PrestaShop necesita crear, leer, modificar y eliminar tablas para funcionar correctamente.
Anota el nombre completo de la base de datos y del usuario. En cPanel, suelen aparecer como tuusuario_miprestashop y tuusuario_admin_tienda. Necesitarás estos nombres exactos más adelante.

Usando Syspanel (HestiaCP)

Si tu hosting utiliza el panel Syspanel (antes conocido como HestiaCP), el proceso es igualmente sencillo, aunque la interfaz es diferente.

Accede a tu Syspanel. Recuerda que el puerto de acceso es el 2106 (ej: https://tu-dominio.com:2106).
En el menú lateral, busca la sección "Bases de Datos" o un ícono de base de datos.
Haz clic en "Añadir Base de Datos".
Se te pedirá un nombre para la base de datos, un nombre de usuario y una contraseña. El panel te generará automáticamente nombres con prefijo (ej: usuario_bd_nombre).
Asegúrate de que el tipo de base de datos sea MySQL y que el usuario tenga todos los privilegios. En Syspanel, esto se concede automáticamente al crearla.
Guarda los datos. El panel te mostrará el host de la base de datos, que normalmente es localhost.

[TIP] Anota todos estos datos en un bloc de notas temporal. Nombres, usuarios y contraseñas. Es muy fácil olvidar una letra o un símbolo, y la prestashop base de datos debe coincidir exactamente.

Paso 2: Subir los archivos de PrestaShop (si es una instalación nueva)

Si ya tienes una tienda funcionando y solo estás cambiando de servidor, este paso se convierte en "exportar e importar" la base de datos antigua, que veremos más adelante. Para una instalación desde cero, sigue esto:

Descarga el paquete ZIP de PrestaShop desde la web oficial.
Descomprímelo en tu ordenador. Verás una carpeta llamada prestashop con muchos archivos dentro.
Abre tu cliente FTP (como FileZilla) o el Administrador de Archivos de tu hosting.
Navega hasta la carpeta public_html (o www). Si quieres que tu tienda esté en la raíz de tu dominio (ej: www.tutienda.com), sube el contenido de la carpeta prestashop directamente a public_html.
Sube todos los archivos. Este proceso puede tardar unos minutos dependiendo de tu conexión.

[WARNING] No subas la carpeta prestashop como tal, sino su contenido. Si subes la carpeta, tu tienda quedará en www.tutienda.com/prestashop, lo cual no es lo que buscas normalmente.

Paso 3: Ejecutar el instalador de PrestaShop y configurar los parámetros MySQL

Este es el paso clave. Una vez que los archivos están en el servidor y la base de datos está creada, es hora de unir ambos mundos.

Abre tu navegador y escribe la URL de tu dominio (ej: www.tutienda.com). El instalador de PrestaShop se ejecutará automáticamente.
Selecciona tu idioma y haz clic en "Siguiente".
Acepta los términos de la licencia.
Llegarás a la pantalla de "Información de la tienda". Aquí eliges el nombre, el sector y los datos de la cuenta de administrador. No te preocupes, esto no es la base de datos.
En el siguiente paso, llegarás a la pantalla clave: "Información del sistema". El instalador verificará que tu servidor cumple los requisitos. Si todo está en verde, haz clic en "Siguiente".
Ahora verás la pantalla de "Configuración de la base de datos". Aquí es donde debes introducir los parámetros prestashop mysql que anotaste antes.

Los campos que verás son:

Motor de base de datos: Deja MySQL o MySQLi.
Dirección del servidor de base de datos: Aquí va el host. Normalmente es localhost, pero a veces tu hosting te dará una dirección como mysql.tudominio.com. Si no estás seguro, usa localhost.
Nombre de la base de datos: El nombre exacto que creaste (ej: tuusuario_miprestashop).
Usuario de la base de datos: El nombre de usuario que creaste (ej: tuusuario_admin_tienda).
Contraseña de la base de datos: La contraseña que elegiste.
Prefijo de las tablas: Este es un campo importante. Por defecto viene ps_. Te recomiendo que lo cambies a algo como shop_ o mistienda_ por seguridad. Esto dificulta que los hackers adivinen los nombres de tus tablas.

Haz clic en "Probar la conexión". Si los datos son correctos, verás un mensaje verde de éxito. Si no, el instalador te indicará el error (usuario incorrecto, contraseña incorrecta, etc.).
Si la conexión es correcta, haz clic en "Siguiente". El instalador importará los datos y creará las tablas. Este proceso puede tardar un par de minutos.
Al finalizar, se te pedirá que elimines la carpeta install por seguridad. Hazlo a través de FTP o del administrador de archivos.

[WARNING] Si ves el error "Link to database cannot be established", revisa que no haya espacios en blanco al copiar y pegar los nombres. Es el error más común. También verifica que el usuario tenga todos los privilegios sobre la base de datos.

Paso 4: Conectar PrestaShop a una base de datos existente (migración)

Si tu objetivo no es instalar desde cero, sino migrar una tienda ya existente a un nuevo servidor, el proceso cambia ligeramente. No ejecutarás el instalador, sino que editarás un archivo de configuración.

Exporta la base de datos antigua: En tu hosting antiguo, usa phpMyAdmin para exportar tu base de datos a un archivo .sql.
Crea una nueva base de datos en tu nuevo hosting (como vimos en el Paso 1) y importa el archivo .sql en ella. Esto copiará todas tus tablas y datos.
Edita el archivo de configuración: PrestaShop guarda los datos de conexión en un archivo llamado parameters.php. Está en la ruta config/parameters.php dentro de la raíz de tu instalación.
Abre este archivo con un editor de texto (como Notepad++ o el editor del hosting). Verás líneas de código PHP con los parámetros. Deberás modificar estas líneas:

'database_host' => 'localhost',
'database_name' => 'tuusuario_nuevabase',
'database_user' => 'tuusuario_nuevousuario',
'database_password' => 'tu_nueva_contraseña',
'database_prefix' => 'ps_',

Cambia los valores por los de tu nueva base de datos. Guarda el archivo y súbelo a tu nuevo servidor (si lo estabas editando localmente).

[INFO] También necesitarás subir todos los archivos de tu tienda (temas, módulos, imágenes) al nuevo servidor. La base de datos contiene los datos, pero los archivos físicos (imágenes de productos, logos, etc.) están en el servidor.

Solución de problemas comunes en la conexión PrestaShop MySQL

Aunque sigas todos los pasos, pueden surgir problemas. Aquí tienes los más frecuentes y cómo resolverlos:

"Link to database cannot be established": Es el error más genérico. Causas posibles: credenciales incorrectas, el servidor de base de datos no es localhost, o el usuario no tiene permisos. Revisa cada campo con lupa.
"Unknown database": El nombre de la base de datos no existe o está mal escrito. Vuelve a tu panel de hosting y cópialo exactamente.
"Access denied for user": El usuario no tiene permisos para acceder a esa base de datos. Ve al panel de hosting y asegúrate de que el usuario esté asignado a la base de datos con TODOS LOS PRIVILEGIOS.
Error de conexión en la migración: Si al mover la tienda, la web funciona pero no carga los productos, es que el prefijo de las tablas en el parameters.php no coincide con el prefijo real de las tablas en tu base de datos importada. Revisa en phpMyAdmin cómo se llaman tus tablas (ej: ps_product o shop_product) y ajusta el parámetro database_prefix.

Preguntas frecuentes (FAQ) sobre conectar PrestaShop a MySQL

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

No es recomendable. Aunque uses prefijos diferentes (ej: ps_ y shop_), compartir la misma base de datos puede causar conflictos de rendimiento y, si algo sale mal, podrías perder datos de ambas tiendas. Es mucho más seguro crear una base de datos independiente para cada tienda.

¿Qué es el puerto de MySQL y necesito configurarlo?

Por defecto, MySQL usa el puerto 3306. En la mayoría de los casos, no necesitas especificarlo porque el instalador o el parameters.php usan el valor por defecto. Sin embargo, si tu hosting usa un puerto diferente, te lo indicarán en la documentación. En el archivo parameters.php, puedes añadir la línea 'database_port' => '3307', si es necesario.

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

Sí, en el 99% de los casos, es lo correcto. Significa que la base de datos está en el mismo servidor que tu web. Solo deberías usar una dirección externa si tu hosting lo especifica claramente (por ejemplo, en un hosting en la nube con servidores separados).

¿Cómo sé si mi hosting soporta MySQL?

Cualquier hosting que se precie incluye soporte para MySQL. Es el estándar de la industria. Si tienes dudas, revisa las especificaciones de tu plan de hosting o contacta con su soporte. Si tu panel es Syspanel, verás la opción de bases de datos MySQL claramente visible en el puerto 2106.

¿Puedo cambiar los parámetros de conexión MySQL después de instalar PrestaShop?

Sí, puedes hacerlo editando el archivo config/parameters.php como se explicó en el Paso 4. Solo asegúrate de que la nueva base de datos tenga la misma estructura (tablas y datos) que la anterior.

Conclusión y buenas prácticas

Conectar PrestaShop a una base de datos MySQL es un proceso que, una vez comprendido, se vuelve rutinario. La clave está en la precisión: nombres exactos, contraseñas correctas y privilegios adecuados.

Para terminar, te dejo una lista de buenas prácticas que te ahorrarán dolores de cabeza:

Realiza copias de seguridad periódicas de tu base de datos. Puedes hacerlo desde phpMyAdmin o automatizarlo con módulos de tu hosting.
Usa contraseñas fuertes para el usuario de la base de datos. No uses "123456" ni el nombre de tu tienda.
Cambia el prefijo de las tablas durante la instalación. Es una capa extra de seguridad que muchos pasan por alto.
No compartas tu base de datos con otras aplicaciones si no es estrictamente necesario.
Si usas Syspanel, recuerda que el acceso es por el puerto 2106 y que la gestión de bases de datos es muy visual e intuitiva.

Con esta guía, ya tienes todo lo necesario para establecer una prestashop mysql conexión sólida y sin errores. Si sigues los pasos al pie de la letra, tu tienda online estará operativa en menos de lo que tardas en tomarte un café. ¡Mucha suerte con tu proyecto!