Conectar PrestaShop a Base de Datos | Guía de Configuración

Introducción: ¿Por qué es importante conectar PrestaShop a tu base de datos?

Si estás leyendo esto, es muy probable que estés en medio de la instalación de tu tienda online o que hayas tenido que migrar tu PrestaShop a un nuevo servidor. En cualquier caso, te has topado con el paso más crítico de todo el proceso: conectar PrestaShop a una base de datos MySQL. Sin esta conexión, tu tienda no puede funcionar, ya que es el "cerebro" donde se almacenan todos tus productos, pedidos, clientes y configuraciones.

Puede sonar a algo muy técnico, pero te prometo que es más sencillo de lo que parece. En esta guía extensa y paso a paso, vamos a desglosar exactamente cómo hacerlo tanto si usas DirectAdmin como si usas cPanel, los dos paneles de control de hosting más comunes del mercado. Al final, también te enseñaré a editar el famoso archivo parameters.php de PrestaShop, que es el que guarda la "llave" de acceso a tu base de datos.

Vamos a ello. Respira hondo, coge un café y sigue estos pasos. Al terminar, tendrás tu tienda conectada y funcionando.

Antes de empezar: ¿Qué necesitas tener a mano?

Para conectar PrestaShop a MySQL, necesitarás cuatro datos fundamentales. Es como tener las llaves de tu casa; sin ellas, no puedes entrar. Estos son:

Nombre de la base de datos (ej: tienda_prestashop).
Nombre de usuario de la base de datos (ej: usuario_tienda).
Contraseña del usuario de la base de datos.
Nombre del servidor de la base de datos (ej: localhost o mysql.tudominio.com).

Si ya has creado la base de datos, genial. Si no, en las siguientes secciones te explico cómo crearla tanto en DirectAdmin como en cPanel. Es importante que estos datos los tengas escritos en un bloc de notas antes de continuar, ya que los necesitarás repetidamente.

[INFO] En la mayoría de los casos, el servidor de la base de datos es localhost. Sin embargo, en algunos hostings gestionados o con muchos recursos, puede ser un servidor externo como mysql.tudominio.com. Si no estás seguro, consulta el correo de bienvenida de tu hosting o el panel de control.

Conectando PrestaShop a una base de datos en cPanel

cPanel es uno de los paneles más populares y visuales. Si tu hosting lo usa, los pasos son muy intuitivos. Vamos a dividirlo en dos fases: crear la base de datos y luego conectar PrestaShop.

Fase 1: Crear la base de datos y el usuario en cPanel

Inicia sesión en cPanel: Accede a tudominio.com/cpanel con tus credenciales de administrador.
Busca la sección "Bases de Datos": Dentro del panel, busca un icono que diga "Bases de datos MySQL" o "Asistente para bases de datos MySQL". Te recomiendo usar el asistente, ya que te guía paso a paso.
Crea la base de datos: En el asistente, el primer paso es escribir un nombre para tu base de datos. cPanel añadirá automáticamente un prefijo con tu nombre de usuario (ej: usuario_prestashop). Anota el nombre completo, porque lo usarás más tarde.
Crea un usuario: En el segundo paso, te pedirá un nombre de usuario y una contraseña. Usa una contraseña segura (mezcla de mayúsculas, minúsculas, números y símbolos). cPanel también añadirá el prefijo (ej: usuario_admin_tienda).
Asigna privilegios: El asistente te preguntará qué privilegios quieres darle a este usuario. Marca la casilla "TODOS LOS PRIVILEGIOS". Esto es esencial para que PrestaShop pueda crear y modificar tablas sin problemas.
¡Listo! El asistente creará la base de datos y el usuario, y los vinculará. Ahora tienes tus datos: nombre de BD, usuario y contraseña.

Fase 2: Usar los datos en el instalador de PrestaShop

Ahora que ya tienes la base de datos creada, el siguiente paso es conectar PrestaShop. Puedes hacerlo de dos maneras: durante la instalación inicial o cuando ya tienes PrestaShop instalado y solo cambias la conexión.

Si estás instalando PrestaShop desde cero:

Sube los archivos de PrestaShop a tu servidor (normalmente en public_html).
Ve a tudominio.com en tu navegador. Se abrirá el asistente de instalación.
Sigue los pasos hasta llegar a la sección de "Base de datos".
Aquí es donde debes introducir los datos que creamos en cPanel:
- Dirección del servidor de base de datos: localhost.
- Nombre de la base de datos: El nombre completo que anotaste (ej: usuario_prestashop).
- Usuario de la base de datos: El usuario completo (ej: usuario_admin_tienda).
- Contraseña: La contraseña que elegiste.
- Prefijo de las tablas: Te recomiendo cambiarlo de ps_ a algo como shop_ o prestashop_. Es una medida de seguridad básica.
Haz clic en "Comprobar conexión" o "Siguiente". Si todo está bien, verás un mensaje de éxito y podrás continuar con la instalación.

Si ya tienes PrestaShop y cambias de servidor o base de datos:

Aquí es donde entra en juego el archivo parameters.php. Este archivo es el guardián de la configuración de conexión. Lo encontramos en la carpeta app/config/ de tu instalación de PrestaShop.

Accede a tu hosting por FTP (FileZilla, por ejemplo) o a través del administrador de archivos de cPanel.
Navega hasta la carpeta app/config/.
Busca el archivo parameters.php. Es posible que también exista un archivo llamado parameters.php.bak (copia de seguridad). No lo toques.
Descarga el archivo a tu ordenador y ábrelo con un editor de texto plano (como el Bloc de Notas de Windows o Visual Studio Code).
Verás un código PHP con una estructura similar a esta:

<?php
return array (
  'parameters' => array (
    'database_host' => 'localhost',
    'database_port' => '',
    'database_name' => 'usuario_prestashop',
    'database_user' => 'usuario_admin_tienda',
    'database_password' => 'TuContraseñaSegura',
    'database_prefix' => 'ps_',
    // ... otros parámetros
  ),
);

Edita los valores database_host, database_name, database_user y database_password con los datos nuevos que creaste en cPanel.
Guarda el archivo y súbelo de vuelta a la carpeta app/config/, sobrescribiendo el existente.
Borra el archivo var/cache (o el contenido de la carpeta cache en versiones antiguas) para que PrestaShop no use la configuración antigua.

[TIP] Antes de editar el parameters.php, siempre haz una copia de seguridad del original. Si algo sale mal, puedes restaurarlo y tu tienda volverá a funcionar como antes.

Conectando PrestaShop a una base de datos en DirectAdmin

DirectAdmin es otro panel muy robusto, aunque su interfaz es un poco más "cruda" que cPanel. Pero no te preocupes, el proceso es igual de sencillo.

Fase 1: Crear la base de datos y el usuario en DirectAdmin

Inicia sesión en DirectAdmin: Normalmente accedes a tudominio.com:2222 (o el puerto que te haya indicado tu proveedor).
Busca la sección "Administración de MySQL": Dentro del menú principal, busca un icono o enlace llamado "Administración de MySQL" o "MySQL Management".
Crea la base de datos: Verás un formulario en la parte superior. Introduce el nombre que quieras para tu base de datos (ej: tienda_prestashop). DirectAdmin no suele añadir prefijos tan agresivos como cPanel, pero a veces añade el nombre de usuario. Anota el nombre final.
Crea el usuario: En el mismo formulario, introduce el nombre de usuario y la contraseña. Asegúrate de que sea segura.
Asigna la base de datos al usuario: Después de crear ambos, busca la sección de "Agregar Base de Datos al Usuario" o similar. Selecciona la base de datos que acabas de crear, el usuario y marca la casilla "ALL PRIVILEGES" (todos los privilegios). Haz clic en "Agregar".
¡Listo! Ya tienes la base de datos y el usuario vinculados.

Fase 2: Usar los datos en el instalador o en el archivo parameters.php

El proceso de conexión es exactamente el mismo que con cPanel. La única diferencia es que, en DirectAdmin, a veces el database_host puede no ser localhost. Si tu hosting usa un servidor MySQL externo, el panel te lo indicará. Si no, usa localhost.

Instalación desde cero: Sigue los pasos 1 a 5 de la sección de cPanel para el instalador, pero introduce los datos que creaste en DirectAdmin.
Cambio de base de datos: Sigue los pasos 1 a 8 de la sección de cPanel para editar el archivo parameters.php. El procedimiento es idéntico.

[WARNING] En DirectAdmin, es muy común que el nombre del servidor de base de datos no sea localhost, sino algo como localhost o el nombre de tu servidor (ej: server1.mihosting.com). Si pones localhost y no funciona, revisa el correo de bienvenida de tu hosting o los detalles en tu panel de DirectAdmin. A veces, en la sección de "Administración de MySQL" te muestra el host exacto.

Syspanel (antes conocido como HestiaCP): Una alternativa

Aunque no es el objetivo principal de este artículo, es posible que tu hosting use un panel llamado Syspanel (antes conocido como HestiaCP). Si es tu caso, el proceso es muy similar, pero con una pequeña particularidad.

[INFO] Si tu panel de control es Syspanel, recuerda que el acceso se realiza a través del puerto 2106 (ej: tudominio.com:2106). Es un detalle importante si no encuentras la URL de acceso.

En Syspanel, la creación de bases de datos suele estar en la sección de "Bases de Datos" o "Base de datos MySQL" en el menú lateral. El proceso de creación de base de datos, usuario y asignación de privilegios es idéntico al de los otros paneles. La conexión de PrestaShop se hace de la misma manera, usando localhost como host en la mayoría de los casos.

Solución de problemas comunes al conectar PrestaShop a MySQL

A veces, incluso siguiendo todos los pasos al pie de la letra, pueden surgir problemas. Aquí tienes una lista de los más comunes y cómo solucionarlos:

Error: "Link to database cannot be established"

Este es el error más genérico y frustrante. Significa que PrestaShop no puede conectarse al servidor MySQL. Las causas suelen ser:

Datos incorrectos: Revisa que el nombre de la base de datos, el usuario y la contraseña sean exactamente los que creaste. A veces, al copiar y pegar, se cuela un espacio en blanco.
Servidor de base de datos incorrecto: Si tu hosting usa un servidor MySQL externo, localhost no funcionará. Prueba con el nombre del servidor que aparece en tu panel de control.
Privilegios insuficientes: Asegúrate de que el usuario de la base de datos tenga TODOS LOS PRIVILEGIOS sobre esa base de datos. Si solo tiene privilegios de "SELECT" o "INSERT", PrestaShop no podrá crear las tablas necesarias durante la instalación.

Error: "Cannot connect to the database. The database server is not available"

Este error suele indicar que el servidor MySQL está caído o que el host es inalcanzable. Verifica si tu hosting está teniendo problemas técnicos. También puede ser un problema de firewall o de que el puerto MySQL (normalmente el 3306) esté bloqueado.

Error: "Access denied for user 'usuario'@'localhost'"

Este error es más específico y significa que el usuario existe pero la contraseña es incorrecta, o que el usuario no tiene permisos para conectarse desde el host localhost. Revisa la contraseña y los privilegios. En cPanel, a veces hay que "volver a generar" la contraseña del usuario de la base de datos.

Problemas con el archivo parameters.php

Permisos de archivo: Asegúrate de que el archivo parameters.php tenga permisos de lectura para el servidor web (normalmente 644). Si es de solo lectura (444), PrestaShop no podrá leerlo.
Caché: Después de editar el parameters.php, borra la carpeta var/cache (o cache en versiones antiguas). Si no lo haces, PrestaShop seguirá usando la configuración antigua y no verás los cambios.

Preguntas frecuentes (FAQ) sobre conectar PrestaShop y MySQL

¿Qué es el prefijo de las tablas en PrestaShop?

El prefijo es un texto que se añade al principio de cada tabla de la base de datos. Por defecto es ps_. Cambiarlo a algo como shop_ es una medida de seguridad básica para que los atacantes no adivinen el nombre de tus tablas fácilmente.

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

Técnicamente, sí, pero es muy mala idea. Si usas la misma base de datos con el mismo prefijo, una instalación sobrescribirá los datos de la otra. Si usas prefijos diferentes (ej: tienda1_ y tienda2_), podrían coexistir, pero es arriesgado y puede causar conflictos. Es mejor usar una base de datos separada para cada tienda.

¿Qué hago si no recuerdo la contraseña de mi base de datos?

No hay forma de recuperarla, pero sí de cambiarla. Tanto en cPanel como en DirectAdmin, puedes ir a la sección de "Bases de datos MySQL" y cambiar la contraseña del usuario. Después de cambiarla, tendrás que actualizar el archivo parameters.php con la nueva contraseña.

¿Por qué me pide el "database_host" y no es "localhost"?

En algunos hostings, por seguridad o por arquitectura, el servidor de base de datos no está en la misma máquina que el servidor web. En ese caso, el panel de control te dará un host específico. Si no lo encuentras, contacta con el soporte de tu hosting.

¿Es seguro editar el archivo parameters.php a mano?

Sí, es seguro si sabes lo que estás haciendo. Siempre haz una copia de seguridad antes de editar cualquier archivo de configuración. Un error de sintaxis (una comilla mal puesta, por ejemplo) puede romper tu tienda. Por eso, usa un editor de texto plano y no procesadores de texto como Word.

¿Necesito conocimientos avanzados de MySQL para hacer esto?

No. Conectar PrestaShop a una base de datos es un proceso administrativo básico. No necesitas escribir ni una sola línea de código SQL. Solo necesitas saber crear una base de datos y un usuario, y luego copiar esos datos en el instalador o en el parameters.php.

Conclusión: Tu tienda ya tiene cerebro

Conectar PrestaShop a una base de datos es un paso fundamental, pero no tiene por qué ser un dolor de cabeza. Tanto en cPanel como en DirectAdmin, el proceso se reduce a crear una base de datos, un usuario con todos los privilegios, y luego introducir esos datos en el instalador o en el archivo parameters.php.

Espero que esta guía te haya sido de gran ayuda. Recuerda que la clave está en la paciencia y en verificar que cada dato que introduces sea exactamente el que has creado. Si has llegado hasta aquí,