Conectar PrestaShop a MySQL Existente | Guía Configuración

Antes de Empezar: ¿Qué Necesitas Saber?

Conectar PrestaShop a una base de datos MySQL existente es un paso fundamental, ya sea que estés migrando tu tienda desde otro servidor, reinstalando la plataforma o simplemente quieras centralizar tus datos en una base ya creada.

Este proceso puede sonar técnico, pero te aseguro que con esta guía paso a paso, podrás hacerlo sin problemas, incluso si nunca has tocado un panel de control como cPanel o Plesk.

Primero, vamos a desglosar los conceptos clave:

PrestaShop: Es el sistema de gestión de contenido (CMS) que da vida a tu tienda online.
Base de datos MySQL: Es el "almacén" donde se guardan todos los datos de tu tienda: productos, clientes, pedidos, configuraciones, etc.
cPanel / Plesk: Son los paneles de control que te permiten administrar tu servidor de hosting. Son las "oficinas" donde gestionas archivos, correos, y por supuesto, bases de datos.

Cuando hablamos de conectar PrestaShop a una base de datos MySQL existente, nos referimos a decirle a PrestaShop: "Oye, tus datos están en este servidor, en esta base de datos, con este usuario y esta contraseña, úsalos".

Fase 1: Preparando el Terreno (Antes de Tocar Nada)

Antes de lanzarnos a la piscina, es crucial preparar todo. Esto evitará dolores de cabeza y pérdidas de tiempo.

1.1. Haz una Copia de Seguridad (¡Sí o Sí!)

[WARNING] Este es el paso más importante de todo el tutorial. Si algo sale mal, una copia de seguridad te salvará el día. Nunca, jamás, trabajes sobre una base de datos sin tener una copia de seguridad reciente.

Desde cPanel: Busca la herramienta "Backup" o "Copias de Seguridad". Puedes descargar una copia completa de tu cuenta o, al menos, de la base de datos específica.
Desde Plesk: Ve a "Administrador de Archivos" o a la sección de "Bases de Datos". Plesk suele tener una opción de "Exportar Dump" o "Descargar Copia de Seguridad".

1.2. Identifica tus Credenciales de la Base de Datos Existente

Este es el "código de acceso" a tu almacén. Necesitarás cuatro datos:

Nombre de la base de datos: Ejemplo: tuusuario_mitienda.
Usuario de la base de datos: Ejemplo: tuusuario_admin.
Contraseña del usuario: La contraseña que se asignó a ese usuario.
Host de la base de datos: Normalmente es localhost, pero en algunos hosting gestionados puede ser un servidor remoto como mysql.tudominio.com.

¿Dónde encuentro esto?

En cPanel: Ve a la sección "Bases de Datos MySQL". Ahí verás una lista con todas tus bases de datos y sus usuarios. Si no recuerdas la contraseña, la puedes cambiar desde ahí (¡con cuidado!).
En Plesk: Ve a la sección "Bases de Datos". Verás una lista de bases, y al hacer clic en una, podrás ver el usuario asociado y la dirección del servidor.

1.3. Verifica que la Base de Datos Esté Vacía (o Prepara una Nueva)

Si tu objetivo es configurar PrestaShop por primera vez y usar una base de datos existente, esta debe estar completamente vacía (sin tablas). Si tiene tablas de otra instalación, PrestaShop podría fallar o mezclar datos.

[INFO] Si la base de datos que quieres usar ya tiene datos de una instalación anterior de PrestaShop, puedes intentar una "migración". Sin embargo, para este tutorial, asumiremos que la base está vacía o que vas a crear una nueva desde cero.

Fase 2: Conectando PrestaShop a MySQL en cPanel

cPanel es uno de los paneles más comunes. Vamos a ver dos escenarios: instalar PrestaShop desde cero y conectarlo a una base existente, o editar una instalación ya existente.

2.1. Escenario A: Instalación Nueva de PrestaShop (Asistente de Instalación)

Este es el método más fácil. El propio instalador de PrestaShop te guiará.

Crea la Base de Datos y el Usuario (si no los tienes):
- En cPanel, busca "Bases de Datos MySQL".
- Crea una nueva base de datos (ej: tuusuario_tienda).
- Crea un nuevo usuario (ej: tuusuario_presta) y asígnale una contraseña segura.
- Importante: Añade ese usuario a la base de datos y otórgale TODOS LOS PRIVILEGIOS. Sin esto, PrestaShop no podrá crear sus tablas.
Sube los Archivos de PrestaShop a tu Servidor:
- Descarga el paquete de instalación de PrestaShop desde su web oficial.
- Descomprímelo en tu computadora.
- Usa el "Administrador de Archivos" de cPanel o un cliente FTP (como FileZilla) para subir el contenido a la carpeta public_html (o a una subcarpeta si quieres instalarla en un subdominio).
Ejecuta el Instalador:
- Abre tu navegador y ve a www.tudominio.com (o la ruta donde subiste los archivos).
- El asistente de instalación comenzará. Sigue los pasos hasta llegar a la sección de "Configuración de la base de datos".
Rellena los Datos de Conexión:
- Motor de base de datos: Deja MySQL (o MySQLi si te lo pide).
- Dirección del servidor: localhost (a menos que tu hosting te indique otra cosa).
- Nombre de la base de datos: tuusuario_tienda (la que creaste).
- Usuario de la base de datos: tuusuario_presta.
- Contraseña: La contraseña que le pusiste al usuario.
- Prefijo de las tablas: ps_ (puedes dejarlo por defecto).
¡Listo! El instalador continuará y creará todas las tablas necesarias. Si los datos son correctos, la instalación finalizará con éxito.

2.2. Escenario B: Instalación Existente (Editando `parameters.php`)

Imagina que ya tienes PrestaShop instalado, pero por alguna razón necesitas cambiar la base de datos a la que se conecta (por ejemplo, has movido tu tienda a un nuevo servidor). En este caso, tendrás que editar un archivo de configuración.

Localiza el Archivo parameters.php:
- Este archivo se encuentra en la carpeta app/config/ de tu instalación de PrestaShop.
- Usa el "Administrador de Archivos" de cPanel o FTP para navegar hasta ahí.
Edita el Archivo:
- Haz clic derecho sobre el archivo y selecciona "Editar" (o descárgalo, edítalo con un editor de texto como Notepad++ y vuelve a subirlo).
- Busca el bloque que dice 'parameters' => array ( y dentro de él, la sección 'database' => array (.
- Verás algo similar a esto:
```
'database_host' => 'localhost',
'database_name' => 'tu_base_antigua',
'database_user' => 'tu_usuario_antiguo',
'database_password' => 'tu_contraseña_antigua',
'database_prefix' => 'ps_',
```
- Reemplaza los valores de database_host, database_name, database_user y database_password con los datos de tu nueva base de datos existente.
Guarda los Cambios:
- Guarda el archivo y, si lo habías descargado, vuelve a subirlo a la misma ubicación (app/config/parameters.php), sobrescribiendo el anterior.
Limpia la Caché:
- Es posible que PrestaShop tenga una caché que recuerde la configuración antigua. Para forzar la actualización, borra el contenido de la carpeta var/cache/ (o app/cache/ en versiones más antiguas). Puedes hacerlo desde el Administrador de Archivos.

[TIP] Antes de editar parameters.php, descarga una copia del archivo original a tu computadora. Así, si algo falla, podrás restaurarlo fácilmente.

Fase 3: Conectando PrestaShop a MySQL en Plesk

Plesk tiene una interfaz un poco diferente, pero el proceso es igual de sencillo.

3.1. Escenario A: Instalación Nueva (Asistente de Instalación)

Crea la Base de Datos y el Usuario:
- En el panel de Plesk, ve a la sección "Bases de Datos".
- Haz clic en "Agregar Base de Datos".
- Introduce un nombre para la base de datos.
- Crea un nuevo usuario y una contraseña para esa base de datos. Plesk te permite hacerlo en el mismo paso.
- Asegúrate de que el tipo de base de datos sea MySQL y de que el usuario tenga todos los privilegios (normalmente se conceden por defecto).
Sube los Archivos de PrestaShop:
- Al igual que en cPanel, sube los archivos de la instalación de PrestaShop a la carpeta raíz de tu dominio (httpdocs en Plesk).
Ejecuta el Instalador:
- Ve a tu dominio en el navegador y sigue los pasos del asistente hasta llegar a la configuración de la base de datos.
Rellena los Datos:
- Dirección del servidor: localhost (a menos que Plesk te indique lo contrario).
- Nombre de la base de datos: El nombre que le diste en Plesk.
- Usuario: El usuario que creaste en Plesk.
- Contraseña: La contraseña que definiste.

3.2. Escenario B: Instalación Existente (Editando `parameters.php`)

El proceso es idéntico al de cPanel. Debes localizar el archivo app/config/parameters.php en tu instalación de PrestaShop.

Desde el Administrador de Archivos de Plesk: Navega hasta httpdocs/app/config/.
Edita el archivo: Haz clic en el icono de edición (lápiz) y modifica los valores de la sección 'database' => array ( con los datos de tu nueva base de datos.
Guarda y limpia la caché: Guarda los cambios y borra el contenido de la carpeta var/cache/ para asegurarte de que PrestaShop cargue la nueva configuración.

Fase 4: Solución de Problemas Comunes (FAQ)

Aquí tienes las dudas más frecuentes que nos llegan al soporte. Espero que te ayuden a resolver cualquier contratiempo.

4.1. "Error de conexión a la base de datos" o "No se puede conectar al servidor de base de datos"

Causa más común: Credenciales incorrectas. Revisa que el nombre de la base, el usuario y la contraseña estén escritos exactamente igual, respetando mayúsculas y minúsculas.
Verifica el host: ¿Estás usando localhost? Algunos hosting usan un host remoto. Revisa la información de tu cuenta de hosting.
¿Existe el usuario?: Asegúrate de que el usuario que estás usando está asociado a la base de datos en cuestión y que tiene todos los privilegios.

4.2. "Tabla no encontrada" o "Error en la consulta SQL"

Base de datos no vacía: Si estás instalando desde cero, la base de datos debe estar vacía. Si tiene tablas antiguas, PrestaShop intentará usar las existentes y fallará. Solución: Borra todas las tablas de la base de datos (¡con cuidado!) o crea una nueva base de datos vacía.
Prefijo incorrecto: Si la base de datos tiene tablas con un prefijo diferente a ps_, deberás indicarlo en el campo "Prefijo de las tablas" durante la instalación, o editarlo en parameters.php.

4.3. "Acceso denegado para el usuario"

Contraseña incorrecta: Este es el error más típico. Vuelve a generar una nueva contraseña para el usuario de la base de datos desde tu panel de control (cPanel o Plesk) y actualízala en parameters.php.

4.4. Después de editar `parameters.php`, la tienda sigue mostrando la base de datos antigua

Caché persistente: Borra la carpeta var/cache/ por completo. A veces hay que borrar tanto los archivos como las carpetas que hay dentro. Si no funciona, intenta desactivar la caché temporalmente desde el archivo app/config/parameters.php (busca 'cache_enabled' => true y cámbialo a false).

4.5. Mi hosting usa "Syspanel" en lugar de cPanel o Plesk

[INFO] Si tu hosting utiliza Syspanel (anteriormente conocido como HestiaCP), el proceso es muy similar. Deberías acceder a tu panel a través del puerto 2106 (por ejemplo, https://tudominio.com:2106). Dentro de Syspanel, busca la sección "Bases de Datos" y podrás crear la base y el usuario. Los pasos para conectar PrestaShop (tanto por instalador como editando parameters.php) son exactamente los mismos que hemos descrito.

Conclusión y Buenas Prácticas

Conectar PrestaShop a una base de datos MySQL existente es un proceso que, una vez que le coges el truco, se hace en minutos. La clave está en tener a mano las credenciales correctas y entender la estructura de archivos de PrestaShop.

Resumen de buenas prácticas:

Siempre realiza copias de seguridad antes de modificar cualquier archivo de configuración o base de datos.
Anota tus credenciales en un lugar seguro (un gestor de contraseñas es ideal).
No compartas tus credenciales de la base de datos con nadie.
Usa contraseñas seguras y cámbialas periódicamente.
Si tienes dudas sobre los privilegios de un usuario, en cPanel o Plesk siempre puedes verificar y modificar los permisos asociados a cada base de datos.

Espero que esta guía te haya sido de gran ayuda. Si te surge cualquier otra duda, no dudes en contactar con nuestro equipo de soporte. ¡Estamos aquí para ayudarte a que tu tienda online funcione a la perfección!