Conectar PrestaShop a Base de Datos MySQL | Guía Completa

¿Por qué PrestaShop necesita una base de datos MySQL?

PrestaShop es un sistema de gestión de contenidos (CMS) que guarda toda la información de tu tienda en una base de datos MySQL: productos, clientes, pedidos, configuraciones, módulos y contraseñas. Sin una conexión correcta a esta base de datos, tu tienda simplemente no puede funcionar.

Cuando instalas PrestaShop por primera vez, el proceso de instalación te pide los datos de acceso a MySQL. Pero hay situaciones donde necesitas conectar PrestaShop a una base de datos MySQL manualmente:

Si migras tu tienda a un servidor nuevo.
Si cambias de proveedor de hosting.
Si restauras una copia de seguridad.
Si la conexión se rompe y necesitas reconfigurarla.

En este artículo te explico paso a paso cómo hacerlo desde los tres paneles de control más comunes: cPanel, Plesk y DirectAdmin. Además, te enseño a editar el archivo parameters.php de PrestaShop y a resolver los errores de conexión más frecuentes.

Antes de empezar: qué necesitas tener a mano

Para configurar la base de datos de PrestaShop correctamente, necesitas estos datos:

Nombre de la base de datos (ejemplo: miusuario_prestashop).
Usuario de la base de datos (ejemplo: miusuario_admin).
Contraseña del usuario (la que asignaste al crear el usuario).
Host de la base de datos (normalmente localhost, pero en algunos hostings puede ser localhost o una dirección IP como 127.0.0.1).
Prefijo de tablas (por defecto es ps_, pero puede ser diferente si lo cambiaste).

[INFO]
Si no tienes estos datos, puedes crearlos desde el panel de control de tu hosting. Te explico cómo en las siguientes secciones.

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

Si tu hosting usa cPanel

cPanel es el panel más común en hosting compartido. Sigue estos pasos:

Inicia sesión en cPanel con tu usuario y contraseña.
Busca la sección "Bases de Datos" y haz clic en "Asistente de Bases de Datos MySQL" (o "MySQL Database Wizard").
En el primer paso, escribe el nombre de la base de datos y haz clic en "Siguiente".
En el segundo paso, crea un usuario y una contraseña segura. Anota ambos datos.
En el tercer paso, marca la casilla "TODOS LOS PRIVILEGIOS" y haz clic en "Siguiente".
¡Listo! Ya tienes tu base de datos y usuario creados.

[TIP]
El nombre completo de la base de datos y del usuario incluirá tu nombre de usuario de cPanel como prefijo. Por ejemplo, si tu usuario es juan, la base se llamará juan_prestashop. Es normal, así funciona cPanel.

Si tu hosting usa Plesk

Plesk es otro panel muy popular, sobre todo en servidores VPS y dedicados:

Inicia sesión en Plesk.
Ve a la pestaña "Bases de Datos" en el menú de la izquierda.
Haz clic en "Agregar base de datos".
Escribe el nombre de la base (por ejemplo, prestashop_db).
En el apartado "Tipo de base de datos", selecciona "MySQL".
Crea un usuario nuevo marcando la opción "Crear un usuario de base de datos" e introduce la contraseña.
Haz clic en "Aceptar" y listo.

[INFO]
En Plesk, el nombre de la base de datos no suele llevar prefijos adicionales, a diferencia de cPanel. Puedes usar nombres más simples.

Si tu hosting usa DirectAdmin

DirectAdmin es menos común pero igual de sencillo:

Inicia sesión en DirectAdmin.
Busca la sección "MySQL Management" (Gestión de MySQL).
Haz clic en "Create new database".
Introduce el nombre de la base de datos, el usuario y la contraseña.
Marca la casilla de "Asignar todos los privilegios" (o selecciona manualmente los que necesites).
Haz clic en "Create".

[TIP]
En DirectAdmin, el nombre de la base suele llevar el prefijo de tu usuario. Por ejemplo: usuario_prestashop.

Paso 2: Localizar y editar el archivo parameters.php

PrestaShop guarda la configuración de conexión a la base de datos en un archivo llamado parameters.php. Este archivo se encuentra en la carpeta app/config/ de tu instalación de PrestaShop.

¿Cómo acceder al archivo?

Necesitas usar un cliente FTP (como FileZilla) o el Administrador de archivos de tu panel de hosting.

Conéctate a tu servidor mediante FTP o abre el Administrador de archivos desde cPanel/Plesk/DirectAdmin.
Navega hasta la carpeta app/config/.
Busca el archivo parameters.php.
Descárgalo a tu ordenador o ábrelo con el editor de texto integrado.

¿Qué contiene el archivo?

El archivo parameters.php tiene una estructura similar a esta:

<?php return array (
  'parameters' => array (
    'database_host' => 'localhost',
    'database_port' => '',
    'database_name' => 'miusuario_prestashop',
    'database_user' => 'miusuario_admin',
    'database_password' => 'tu_contraseña',
    'database_prefix' => 'ps_',
    'database_engine' => 'InnoDB',
    'secret' => 'cadena_aleatoria',
  ),
);

¿Qué campos debes modificar?

database_host: normalmente localhost. Si tu hosting usa un host remoto, cámbialo por el que te indiquen.
database_port: déjalo vacío o pon 3306 (el puerto por defecto de MySQL).
database_name: el nombre exacto de tu base de datos.
database_user: el usuario de la base de datos.
database_password: la contraseña de ese usuario.
database_prefix: el prefijo de las tablas. Si no lo cambiaste, será ps_.

[WARNING]
No cambies el campo secret. Es una clave de seguridad que PrestaShop usa para cifrar sesiones y contraseñas. Si la modificas, puedes romper la tienda y los usuarios tendrán que iniciar sesión de nuevo.

Guardar los cambios

Una vez hayas editado los campos, guarda el archivo y súbelo de nuevo al servidor (si lo descargaste). Asegúrate de que los permisos del archivo sean 644 (lectura y escritura para el propietario, lectura para el resto).

Paso 3: Verificar que la conexión funciona

Después de editar parameters.php, es hora de comprobar si la conexión es correcta:

Abre tu tienda en el navegador (tu dominio).
Si todo está correcto, verás la página principal de tu tienda.
Si aparece un error, revisa la sección siguiente.

También puedes comprobar la conexión desde el panel de administración:

Accede a /admin (o la URL de tu panel de administración).
Si la conexión es válida, podrás iniciar sesión sin problemas.

[TIP]
Si acabas de migrar la tienda, es recomendable limpiar la caché de PrestaShop. Puedes hacerlo borrando el contenido de la carpeta var/cache/ (o cache/ en versiones antiguas) mediante FTP.

Errores comunes al conectar PrestaShop con MySQL

Aunque sigas los pasos al pie de la letra, pueden aparecer errores. Aquí tienes los más frecuentes y sus soluciones:

Error: "Link to database cannot be established"

Este es el error más típico. Aparece cuando PrestaShop no puede conectarse a MySQL. Las causas más comunes son:

Datos incorrectos en parameters.php: revisa el nombre de la base, el usuario y la contraseña.
El usuario no tiene permisos: asegúrate de que el usuario tiene todos los privilegios sobre la base de datos.
El host no es localhost: algunos hostings usan un servidor MySQL separado. Consulta el panel de control para ver el host correcto.

[WARNING]
Si usas cPanel, el host suele ser localhost, pero en algunos casos es 127.0.0.1. Prueba ambos si tienes dudas.

Error: "Table 'ps_shop' doesn't exist"

Este error indica que la base de datos está vacía o que el prefijo de tablas no coincide. Soluciones:

Restaura una copia de seguridad de tu base de datos.
Comprueba el prefijo: si tus tablas se llaman ps_product, el prefijo es ps_. Si usan otro prefijo, cámbialo en parameters.php.

Error: "Access denied for user"

Este error significa que el usuario no tiene permisos o la contraseña es incorrecta. Soluciones:

Verifica la contraseña: asegúrate de que es exactamente la misma que creaste.
Revisa los privilegios: en cPanel, ve a "Bases de datos MySQL" y comprueba que el usuario tiene todos los privilegios sobre la base.
Crea un nuevo usuario y asígnale todos los privilegios.

Error: "Unknown database"

Este error aparece cuando el nombre de la base de datos no existe o está mal escrito. Soluciones:

Revisa el nombre exacto en tu panel de control.
Asegúrate de que la base de datos existe y no fue eliminada.

Consejos extra para evitar problemas

Haz una copia de seguridad antes de tocar nada

Siempre que vayas a modificar parameters.php o la base de datos, haz una copia de seguridad tanto de los archivos como de la base de datos. Así, si algo sale mal, puedes restaurar todo en minutos.

Usa contraseñas seguras

La contraseña de la base de datos debe ser fuerte y única. No uses la misma que la de tu correo o tu panel de control. Un buen generador de contraseñas te ayudará.

Mantén PrestaShop actualizado

Las versiones antiguas de PrestaShop pueden tener problemas de compatibilidad con versiones recientes de MySQL. Mantén tu instalación actualizada para evitar errores.

Preguntas frecuentes (FAQ)

¿Qué hago si no tengo acceso al archivo parameters.php?

Si no puedes acceder por FTP, usa el Administrador de archivos de tu panel de control. Todos los paneles (cPanel, Plesk, DirectAdmin) lo incluyen.

¿Puedo cambiar el prefijo de las tablas después de instalar?

Sí, pero no es recomendable si no sabes lo que haces. El prefijo afecta a todas las tablas de la base de datos. Si lo cambias manualmente, tendrás que renombrar todas las tablas, lo cual es arriesgado.

¿Qué es el puerto de MySQL?

El puerto por defecto de MySQL es el 3306. En la mayoría de los casos, no necesitas especificarlo. Si tu hosting usa un puerto diferente, te lo indicarán en la documentación.

¿Puedo usar una base de datos remota?

Sí, pero requiere configuración adicional. Debes asegurarte de que el servidor MySQL permite conexiones remotas y que el host está bien configurado en parameters.php.

¿Qué hago si mi hosting usa Syspanel?

[INFO]
Si tu proveedor de hosting usa Syspanel (antes conocido como HestiaCP), el acceso al panel se realiza a través del puerto 2106 (por ejemplo, https://tu-dominio.com:2106). El proceso para crear la base de datos es muy similar al de Plesk: busca la sección "Bases de Datos" o "MySQL" en el menú lateral.

Resumen final

Conectar PrestaShop a una base de datos MySQL no es complicado si sigues estos pasos:

Crea la base de datos y el usuario desde cPanel, Plesk, DirectAdmin o Syspanel.
Edita el archivo parameters.php con los datos correctos.
Verifica la conexión abriendo tu tienda.
Resuelve los errores comunes revisando permisos, contraseñas y prefijos.

Recuerda que la clave está en tener los datos exactos y en no tocar campos de seguridad como secret. Con paciencia y siguiendo esta guía, tu tienda volverá a funcionar en poco tiempo.

[TIP]
Si después de todo sigues teniendo problemas, contacta con tu proveedor de hosting. Ellos pueden verificar si el servidor MySQL está funcionando correctamente y ayudarte con la configuración.