Conectar PrestaShop a base de datos en cPanel: Guía paso a paso

Conectar tu tienda PrestaShop a una base de datos en cPanel es uno de los pasos más importantes durante la instalación o migración de tu tienda online. Si no sabes por dónde empezar, no te preocupes. En esta guía te explicaré todo el proceso paso a paso, de forma sencilla y clara, para que puedas conectar PrestaShop a MySQL sin complicaciones. Veremos desde cómo crear la base de datos en cPanel, hasta configurar el archivo de conexión y solucionar los errores más comunes.

¿Qué necesitas para conectar PrestaShop a una base de datos en cPanel?

Antes de empezar, asegúrate de tener a mano los siguientes datos:

Acceso a cPanel: usuario y contraseña de tu hosting.
Nombre de dominio o IP donde instalaste PrestaShop.
Archivos de PrestaShop (si es una instalación nueva) o acceso a los archivos existentes (si es una migración).
Credenciales de la base de datos: usuario, contraseña, nombre de la base y servidor.

Si ya tienes todo esto, ¡vamos allá!

Paso 1: Crear la base de datos en cPanel

El primer paso para realizar la conexión prestashop mysql es tener una base de datos creada y un usuario con permisos. Sigue estos pasos:

Inicia sesión en cPanel con tus credenciales de hosting.
Busca la sección Bases de Datos y haz clic en MySQL Databases (o Bases de datos MySQL).
En el campo Crear nueva base de datos, escribe un nombre descriptivo (por ejemplo, prestashop_db). Haz clic en Crear base de datos.
Ahora, en la misma página, ve a Usuarios MySQL. Crea un nuevo usuario (por ejemplo, presta_user) y establece una contraseña segura. Anótala, la necesitarás más adelante.
Desplázate hasta Añadir usuario a la base de datos. Selecciona el usuario y la base de datos que acabas de crear.
En la pantalla de permisos, marca TODOS LOS PRIVILEGIOS (o simplemente selecciona la opción "All Privileges"). Esto le dará al usuario control total sobre la base de datos, necesario para que PrestaShop funcione correctamente.
Haz clic en Hacer cambios.

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

Paso 2: Obtener la información del servidor de base de datos

cPanel suele gestionar las bases de datos con un servidor interno. Normalmente, el servidor es localhost. Sin embargo, en algunos hostings compartidos puede ser diferente, como mysql.tudominio.com o una IP.

Para confirmarlo:

En cPanel, ve a la sección Bases de datos y busca MySQL Databases.
Justo debajo del nombre de tus bases de datos, verás una línea que dice Servidor: anota ese valor. Lo más común es localhost.

Si tu hosting utiliza un servidor remoto (como en algunos planes de Syspanel), el puerto suele ser el 3306, pero cPanel casi siempre usa localhost con puerto por defecto.

Paso 3: Configurar la conexión en PrestaShop

Ahora que ya tienes la base de datos lista, es momento de conectar PrestaShop a tu base de datos en cPanel. Dependiendo de si estás instalando PrestaShop desde cero o migrando una tienda existente, el proceso varía ligeramente.

Si es una instalación nueva de PrestaShop

Sube los archivos de PrestaShop a tu servidor (normalmente en la carpeta public_html o una subcarpeta).
Abre tu navegador y visita tudominio.com (o tudominio.com/prestashop si lo pusiste en una subcarpeta).
Sigue el asistente de instalación. Cuando llegues a la pantalla de Configuración de la base de datos, ingresa los datos:
- Dirección del servidor: localhost (o el valor que anotaste en el paso 2).
- Nombre de la base de datos: el que creaste (ej. prestashop_db).
- Usuario: el que creaste (ej. presta_user).
- Contraseña: la que estableciste.
- Prefijo de tabla: déjalo como ps_ a menos que tengas razones para cambiarlo.
Haz clic en Siguiente. PrestaShop verificará la conexión y, si todo está bien, continuará con la instalación.

Si estás migrando una tienda PrestaShop existente

En este caso, necesitarás modificar el archivo app/config/parameters.php (en PrestaShop 1.7 y 8.x) o config/settings.inc.php (en PrestaShop 1.6). Sigue estos pasos:

Conéctate a tu hosting vía FTP o desde el administrador de archivos de cPanel.
Navega hasta la carpeta raíz de tu instalación de PrestaShop.
Abre el archivo app/config/parameters.php (o config/settings.inc.php si es 1.6).

Busca las líneas que contienen los datos de la base de datos. Deberías ver algo como:

'database_host' => 'localhost',
'database_name' => 'nombre_antiguo',
'database_user' => 'usuario_antiguo',
'database_password' => 'contraseña_antigua',

Reemplaza esos valores con los de tu nueva base de datos en cPanel:
- 'database_host' → 'localhost'
- 'database_name' → el nombre que creaste (ej. prestashop_db)
- 'database_user' → el usuario que creaste (ej. presta_user)
- 'database_password' → la contraseña que elegiste
Guarda el archivo y súbelo de nuevo al servidor (si lo editaste localmente).

[WARNING]
Si estás migrando, asegúrate de haber exportado e importado correctamente la base de datos antigua a la nueva. De lo contrario, tu tienda no funcionará.

Paso 4: Verificar la conexión y solucionar errores comunes

Una vez configurado, accede a tu tienda. Si ves la página de inicio o el panel de administración, ¡felicidades! La base de datos prestashop está conectada correctamente.

Si en cambio ves un mensaje de error como "No se puede conectar a la base de datos" o "Error de conexión MySQL", revisa estos puntos:

Errores típicos y soluciones

Host incorrecto: Asegúrate de que el servidor es localhost. Si tu hosting usa un servidor remoto, verifica el nombre en cPanel.
Usuario o contraseña erróneos: Vuelve a cPanel y comprueba que el usuario y la contraseña son correctos. Puedes cambiar la contraseña desde MySQL Databases.
Permisos insuficientes: El usuario debe tener todos los privilegios sobre la base de datos. Si no es así, edita los permisos en cPanel.
Puerto incorrecto: Si tu hosting requiere un puerto específico (como 3306), añádelo al host: localhost:3306.
Base de datos no encontrada: Revisa que el nombre de la base de datos esté escrito exactamente como en cPanel (incluyendo mayúsculas y minúsculas).

[INFO]
En algunos hostings, el nombre de la base de datos incluye un prefijo con tu usuario de cPanel (por ejemplo, usuario_prestashop_db). Asegúrate de usar el nombre completo.

Preguntas frecuentes (FAQ) sobre conectar PrestaShop a cPanel

¿Puedo usar la misma base de datos para varias tiendas PrestaShop?

No es recomendable. Cada tienda debe tener su propia base de datos para evitar conflictos. Si usas la misma, los datos se mezclarán y causarán errores. Usa prefijos de tabla diferentes solo si sabes lo que haces.

¿Qué hago si mi hosting usa Syspanel (HestiaCP) en lugar de cPanel?

Si tu panel es Syspanel (basado en HestiaCP), el proceso es similar, pero el acceso se hace a través del puerto 2106 (por ejemplo, tudominio.com:2106). Dentro de Syspanel, busca la sección Bases de datos y crea una nueva. Luego, en la configuración de PrestaShop, usa el servidor que te indique Syspanel (normalmente localhost o una IP interna).

¿Necesito conocimientos avanzados para conectar PrestaShop a MySQL?

No. Esta guía está pensada para usuarios sin experiencia técnica. Solo sigue los pasos al pie de la letra y todo saldrá bien. Si tienes dudas, contacta con el soporte de tu hosting.

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

Sí, pero requiere modificar el archivo de configuración (como explicamos en el paso 3) y asegurarte de que la nueva base de datos tenga la misma estructura y datos que la anterior. Es más sencillo hacerlo durante la instalación.

¿Qué pasa si mi hosting no tiene cPanel?

Muchos hostings usan paneles similares como DirectAdmin, Plesk o Syspanel. El concepto es el mismo: crear una base de datos, un usuario y asignar permisos. Busca la sección de bases de datos en tu panel y sigue los pasos análogos.

Consejos finales para una conexión exitosa

Usa contraseñas seguras para la base de datos. Evita contraseñas como "123456" o "admin".
Haz una copia de seguridad de tu base de datos antes de migrar o modificar configuraciones.
Actualiza PrestaShop a la última versión estable para evitar problemas de compatibilidad.
Revisa los logs de error de tu servidor si algo falla. En cPanel, puedes acceder a ellos desde Errores o Registros de errores.

Con estos pasos, ya sabes cómo conectar PrestaShop a una base de datos en cPanel de forma rápida y segura. Recuerda que la clave está en tener los datos correctos y verificar los permisos. Si todo está bien, tu tienda online estará lista para funcionar en poco tiempo.

[TIP]
Si después de seguir todos los pasos sigues teniendo problemas, contacta con el soporte técnico de tu hosting. Ellos pueden verificar la configuración del servidor y ayudarte a resolver cualquier incidencia.

¡Buena suerte con tu tienda PrestaShop!