Conectar PrestaShop a MySQL: Guía fácil y completa

Antes de Empezar: ¿Qué es una Base de Datos MySQL y por qué PrestaShop la necesita?

Piensa en tu tienda online como en una gran biblioteca. Los productos, los clientes, los pedidos y las contraseñas son los libros. La base de datos MySQL es la estantería que organiza todos esos libros. Sin ella, tu PrestaShop no podría recordar nada: ni qué productos tienes, ni quién ha comprado, ni cuánto stock te queda. Es el "cerebro" de tu tienda.

Cuando instalas PrestaShop, el proceso de prestashop instalacion te pide los datos de conexión a esa base de datos. Si esos datos son incorrectos, la instalación fallará y verás un temido error base de datos prestashop. Este artículo es una guía a prueba de novatos para que conectes tu PrestaShop a MySQL sin frustrarte. Vamos a ello.

Paso 1: Localizar los Datos de tu Base de Datos MySQL

Antes de tocar nada, necesitas tener a mano las "credenciales" (usuario, contraseña, nombre de la base de datos y servidor). Normalmente, las obtienes de tu panel de control de hosting (cPanel, Plesk, Syspanel, etc.).

¿Dónde encuentro estos datos?

Si usas un hosting compartido, estos datos suelen estar en la sección "Bases de Datos MySQL". Si usas un VPS o un servidor dedicado, puedes crearlos tú mismo desde la terminal o desde un panel como Syspanel.

[INFO] Si tu hosting utiliza Syspanel, recuerda que el acceso a este panel de control se realiza a través del puerto 2106 (por ejemplo, http://tu-dominio.com:2106). Allí encontrarás el gestor de bases de datos.

¿Qué datos necesito exactamente?

Necesitarás cuatro datos clave:

Nombre de la base de datos: Suele tener un prefijo con tu usuario (ej. usuario123_prestashop).
Usuario de la base de datos: Puede ser el mismo que el de tu cuenta o uno específico (ej. usuario123_admin).
Contraseña: La contraseña de ese usuario específico de la base de datos.
Servidor de la base de datos (Host): Muy importante. Normalmente es localhost o 127.0.0.1 si la base de datos está en el mismo servidor que tu web. Si está en un servidor externo, te darán una dirección IP o un nombre tipo mysql.tudominio.com.

[WARNING] No confundas la contraseña de tu cuenta de hosting con la contraseña de la base de datos. Son cosas distintas. A menudo, la gente falla aquí y de ahí vienen muchos errores de base de datos prestashop.

Paso 2: Crear la Base de Datos (Si aún no existe)

Si acabas de contratar un hosting, es probable que tengas que crear la base de datos desde cero. No te preocupes, es más fácil de lo que parece.

Crear la base de datos en cPanel (ejemplo común)

Entra en tu cPanel y busca la sección "Bases de Datos MySQL".
Escribe un nombre para tu base de datos y pulsa "Crear base de datos".
Ve a la sección "Usuarios MySQL" y crea un nuevo usuario con una contraseña segura.
Ahora, en "Añadir usuario a la base de datos", selecciona tu usuario y tu base de datos y pulsa "Añadir".
Te preguntará por los privilegios. Para una instalación de PrestaShop, selecciona TODOS LOS PRIVILEGIOS (o "All Privileges") y pulsa "Hacer cambios".

Crear la base de datos en Syspanel (puerto 2106)

Accede a tu Syspanel a través del puerto 2106.
Busca la sección de "Bases de Datos" o "MySQL".
Haz clic en "Añadir base de datos". Te pedirá un nombre y crearás un usuario y contraseña asociados.
Asegúrate de otorgar todos los privilegios a ese usuario sobre esa base de datos.

[TIP] Anota estos datos en un bloc de notas. Los necesitarás en el siguiente paso, que es el más importante.

Paso 3: El Proceso de Instalación de PrestaShop y la Conexión a MySQL

Ahora viene la parte crucial. Vas a ejecutar el instalador de PrestaShop. Normalmente, descargas el archivo de PrestaShop, lo subes a tu servidor y ejecutas tu-dominio.com/install. El asistente te guiará.

La pantalla de "Información de la base de datos"

Llegará un punto en el asistente donde te pedirá los datos de la base de datos prestashop. Esta es la pantalla donde la gente suele cometer errores. Vamos a rellenarla campo por campo.

Motor de base de datos: Deja el que viene por defecto (normalmente MySQL o MariaDB).
Dirección del servidor: Aquí pon localhost o 127.0.0.1. Si tu hosting te ha dado otra dirección, ponla exactamente como te la han dado.
Nombre de la base de datos: Escribe el nombre que creaste en el paso 2. Con el prefijo incluido (ej. usuario123_prestashop).
Usuario de la base de datos: El usuario que creaste (ej. usuario123_admin).
Contraseña: La contraseña que pusiste para ese usuario.
Prefijo de las tablas: Puedes dejarlo como ps_ o cambiarlo por seguridad (ej. mitienda_). Yo recomiendo cambiarlo para que sea más difícil de hackear.

[WARNING] El error más común es poner el nombre de la base de datos o el usuario sin el prefijo del hosting (ej. poner solo prestashop en lugar de usuario123_prestashop). Revisa que el nombre esté completo.

¿Y si me sale un error?

Si los datos son correctos, el instalador continuará sin problemas. Pero si algo falla, verás un error base de datos prestashop. No entres en pánico. Aquí tienes los errores más típicos y su solución:

"Error al conectar con la base de datos": Suele ser un problema con el servidor (host) o el usuario/contraseña. Vuelve a comprobar que el host es localhost y que el usuario y la contraseña son exactamente los que creaste.
"La base de datos no existe": Has escrito mal el nombre de la base de datos o no la has creado todavía. Revisa que el nombre incluya el prefijo de tu hosting.
"Permiso denegado para el usuario": El usuario no tiene todos los privilegios sobre la base de datos. Vuelve al panel de control de tu hosting y asegúrate de haber añadido el usuario a la base de datos con TODOS los privilegios.

Paso 4: Configurar la Conexión a MySQL en PrestaShop (Si ya está instalado)

¿Y si ya tienes PrestaShop instalado y quieres cambiar la base de datos porque te mudas de hosting o has tenido un problema? No necesitas reinstalar todo. Solo tienes que editar un archivo de configuración.

El archivo `parameters.php`

Este archivo contiene la configuración de tu tienda. Se encuentra en la carpeta app/config/ de tu instalación de PrestaShop.

Accede a tu servidor por FTP o por el administrador de archivos de tu hosting.
Navega hasta app/config/ y descarga el archivo parameters.php.
Ábrelo con un editor de texto (como Notepad++ o Sublime Text). Verás líneas como estas:

'database_host' => 'localhost',
'database_name' => 'usuario123_prestashop',
'database_user' => 'usuario123_admin',
'database_password' => 'tu_contraseña',

Edita estos valores con los datos de tu nueva base de datos. Cambia database_host, database_name, database_user y database_password por los correctos.
Guarda el archivo y súbelo de nuevo a tu servidor, sobrescribiendo el original.

[TIP] Haz siempre una copia de seguridad del archivo parameters.php antes de editarlo. Si algo sale mal, puedes restaurar el original.

[INFO] Después de cambiar la base de datos en parameters.php, es posible que necesites limpiar la caché de PrestaShop. Puedes hacerlo desde el back office en "Parámetros avanzados" -> "Rendimiento" y pulsando el botón "Vaciar la caché".

Errores Comunes y Soluciones Rápidas (FAQ)

Aquí tienes una lista de preguntas y problemas que te pueden surgir durante el proceso de conectar prestashop base de datos.

¿Por qué me sale "Error de conexión con la base de datos" al instalar?

Casi siempre es por un error de escritura en el nombre del servidor, usuario o contraseña. Revisa los espacios en blanco, las mayúsculas y los prefijos.

¿Qué significa "Tabla 'ps_employee' no existe"?

Esto significa que la base de datos está vacía y no se han creado las tablas de PrestaShop. Esto puede pasar si la instalación se interrumpió a mitad. Borra la base de datos, créala de nuevo y vuelve a ejecutar el instalador.

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

No es recomendable. Cada instalación necesita su propia base de datos (o al menos un prefijo de tabla diferente, como tienda1_ y tienda2_). Si usas la misma, los datos se mezclarán y tendrás conflictos graves.

¿Qué es el prefijo de las tablas y por qué debería cambiarlo?

El prefijo es un texto que se añade antes del nombre de cada tabla en la base de datos (ej. ps_productos). Cambiarlo de ps_ a algo como mipresta_ añade una capa extra de seguridad, ya que los atacantes automáticos buscan tablas con el prefijo ps_.

Después de cambiar la contraseña de la base de datos, mi tienda da error

Esto es normal. Si cambias la contraseña desde tu hosting, PrestaShop no lo sabe. Debes actualizar el archivo parameters.php con la nueva contraseña, tal y como vimos en el Paso 4.

Consejos Finales para una Conexión Exitosa

Conectar prestashop mysql no es difícil, pero requiere atención al detalle. Aquí tienes un resumen de buenas prácticas:

Escribe los datos manualmente: Evita copiar y pegar desde documentos con formato que puedan añadir espacios invisibles.
Comprueba los privilegios: Asegúrate de que el usuario de la base de datos tenga permisos totales (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.) sobre la base de datos.
Utiliza contraseñas seguras: La contraseña de la base de datos no debe ser fácil de adivinar. Usa una combinación de letras, números y símbolos.
Haz copias de seguridad: Antes de tocar cualquier cosa relacionada con la base de datos, haz una copia de seguridad. Así, si algo falla, puedes volver atrás sin perder información.

Conectar tu PrestaShop a una base de datos MySQL es el primer gran paso para tener tu tienda online funcionando. Una vez que lo consigues, el resto del proceso de configuración es coser y cantar. Si has llegado hasta aquí y sigues teniendo problemas, repasa los pasos y, sobre todo, revisa los mensajes de error. Te dirán exactamente qué está fallando. ¡Mucha suerte con tu tienda!