PrestaShop y MySQL: Conexión a Base de Datos Fácil

¿Tu tienda PrestaShop te da el temido error de conexión a la base de datos? ¿O estás intentando migrar tu tienda a un nuevo servidor y no sabes por dónde empezar? No te preocupes, es una de las consultas más habituales en soporte técnico. Conectar PrestaShop a una base de datos MySQL o MariaDB es el corazón de tu tienda online, y aunque suene complejo, es un proceso totalmente manejable si lo desglosamos paso a paso.

En esta guía completa, no solo te enseñaremos a realizar la conexión desde cero, sino que también aprenderás a editar el archivo parameters.php, a solucionar los errores más comunes (como el famoso prestashop mysql error) y a configurar correctamente tu base de datos para que tu tienda vuele.

Vamos a ello. Coge un café, relájate y sigue esta hoja de ruta. Al final, serás capaz de gestionar la conexión de tu PrestaShop como todo un profesional.

¿Qué necesitas antes de empezar?

Antes de ensuciarnos las manos con código y archivos, es crucial tener a mano los datos de acceso a tu base de datos. Sin estos datos, es como intentar abrir una puerta sin llave. Normalmente, tu proveedor de hosting te envía estos datos o los puedes encontrar en el panel de control de tu hosting (como cPanel, Plesk o Syspanel).

Esto es lo que necesitas:

Nombre de la base de datos: Por ejemplo, tutienda_db.
Usuario de la base de datos: Por ejemplo, admin_tienda.
Contraseña del usuario: La clave que asignaste al crear el usuario.
Host de la base de datos: Normalmente es localhost o 127.0.0.1, pero a veces puede ser una IP externa como db.mihosting.com.
Puerto (opcional): Por defecto es el 3306 para MySQL/MariaDB. Solo lo necesitas si tu servidor usa uno diferente.

[!TIP]
¿Dónde encuentro estos datos?
Si tu hosting usa Syspanel, el panel de control de tus servicios, recuerda que el acceso se realiza a través del puerto 2106 (por ejemplo, https://tu-servidor:2106). Dentro, busca la sección de "Bases de Datos" o "MySQL". Allí podrás crear la base de datos, el usuario y ver el host exacto.

Método 1: Conexión durante la instalación de PrestaShop (Desde Cero)

Si estás instalando PrestaShop por primera vez, el proceso de conexión a la base de datos es un asistente gráfico muy intuitivo. Sin embargo, es fácil cometer errores si no sabes qué esperar.

Paso 1: El asistente de instalación

Después de subir los archivos de PrestaShop a tu servidor y ejecutar la instalación, llegarás al paso de "Información de la base de datos". Aquí es donde ocurre la magia.

Paso 2: Rellenando los campos correctamente

Verás un formulario con los siguientes campos. Te explicamos cómo rellenarlo sin fallar:

Motor de base de datos: Selecciona MySQL o MariaDB. PrestaShop es compatible con ambos. Si tu hosting ofrece MariaDB, es una excelente opción por su rendimiento, pero MySQL clásico funciona perfectamente.
Dirección del servidor (Host): Aquí va el dato que mencionamos antes. En el 99% de los casos, es localhost. Si tu base de datos está en otro servidor, escribe la IP o el dominio que te hayan proporcionado.
Nombre de la base de datos: Introduce el nombre exacto que creaste. Si lo escribes mal, verás un error de conexión.
Usuario: El nombre del usuario que tiene permisos sobre esa base de datos.
Contraseña: La contraseña de ese usuario. Ten cuidado con las mayúsculas y minúsculas.
Prefijo de las tablas: Te recomiendo dejarlo como ps_ por defecto. Es útil si más adelante quieres tener dos tiendas en la misma base de datos.

Paso 3: El botón "Comprobar"

Antes de continuar, PrestaShop tiene un botón llamado "Comprobar". Haz clic en él. Si todo está correcto, verás un mensaje de éxito en verde. Si algo falla, te mostrará un error específico que analizaremos más adelante.

[!WARNING]
Error común: "No se puede conectar a la base de datos".
Este error suele deberse a un error tipográfico en el host o en el nombre de la base de datos, o a que el usuario no tiene privilegios sobre esa base. Vuelve a revisar los datos en tu panel de control.

Método 2: Conexión editando el archivo `parameters.php` (Migración o Cambio de Servidor)

Este es el método estrella cuando tu tienda ya está creada y necesitas cambiar de hosting o simplemente moverla de servidor. PrestaShop guarda todos los datos de conexión en un archivo de configuración llamado parameters.php.

¿Dónde se encuentra este archivo?

La ruta es la siguiente: /config/parameters.php. Es decir, dentro de la carpeta config en la raíz de tu instalación de PrestaShop.

Paso 1: Localizar y editar el archivo

Necesitas un editor de texto plano, como el Bloc de Notas de Windows o Sublime Text. NUNCA uses Word o programas de procesamiento de texto, ya que pueden añadir caracteres invisibles que rompan el código.

Paso 2: Entendiendo la estructura del archivo

Dentro del archivo, verás una estructura de código PHP. Lo que nos interesa son las líneas que empiezan por 'database_host', 'database_name', 'database_user' y 'database_password'. Verás algo similar a esto:

'database_host' => 'localhost',
'database_name' => 'mi_tienda_db',
'database_user' => 'mi_usuario',
'database_password' => 'mi_contraseña_secreta',

Paso 3: Realizando los cambios

Ahora solo tienes que cambiar los valores entre comillas simples por los nuevos datos de tu servidor de destino.

'database_host': Cambia 'localhost' por el nuevo host si es necesario.
'database_name': Introduce el nombre exacto de la nueva base de datos.
'database_user': Introduce el nuevo usuario.
'database_password': Introduce la nueva contraseña.

[!TIP]
¿Y el puerto?
Si tu servidor usa un puerto diferente al 3306, verás una línea que dice 'database_port' => '3306'. Cámbialo por el puerto correcto. Si no ves esa línea, puedes añadirla después de 'database_host'.

Paso 4: Guardar y subir

Guarda el archivo con la codificación UTF-8 sin BOM (si tu editor te lo permite) y súbelo a tu servidor, reemplazando el existente en /config/parameters.php.

[!WARNING]
¡Cuidado con los permisos!
Después de subir el archivo, asegúrate de que los permisos sean correctos (normalmente 644). Si no, tu tienda podría dar un error de "archivo no legible".

Solucionando el temido "PrestaShop MySQL Error"

Este es, sin duda, el error más frustrante. Puede aparecer de varias formas: en la instalación, al intentar acceder al back-office, o incluso en la parte frontal de la tienda. Aquí tienes un checklist de soluciones rápidas.

1. El clásico "Error de conexión con la base de datos"

Causa más probable: Datos incorrectos en parameters.php o en el asistente de instalación.

Solución: Revisa meticulosamente el host, el nombre de la base, el usuario y la contraseña. A veces, un simple espacio al final de la contraseña puede causar este error.

2. "El usuario no tiene acceso a la base de datos"

Causa más probable: El usuario de MySQL no tiene todos los privilegios sobre la base de datos que intentas usar.

Solución: Accede a tu panel de control de hosting (recuerda, Syspanel en el puerto 2106) y en la sección de bases de datos, edita los privilegios del usuario. Marca la opción "Todos los privilegios" (o ALL PRIVILEGES). Esto es fundamental.

3. El error de "Host no permitido"

Causa más probable: El host de la base de datos no permite conexiones desde el servidor donde está tu PrestaShop.

Solución: Muchas veces, el host no es localhost sino algo como mysql.tudominio.com. Asegúrate de que en tu panel de control, el usuario de la base de datos tenga permitido conectarse desde el host % (cualquier host) o específicamente desde la IP de tu servidor web.

4. El error de "Tabla no encontrada"

Causa más probable: La base de datos existe, pero está vacía o tiene un prefijo diferente al que PrestaShop espera.

Solución: Si estás migrando, asegúrate de haber importado el .sql de tu tienda anterior. Si la tienda es nueva, revisa que el prefijo de las tablas en parameters.php (normalmente ps_) coincida con el que se usó al crear las tablas.

Preparando la base de datos para PrestaShop (Buenas prácticas)

Conectar no es solo rellenar un formulario. Para que tu prestashop database funcione de manera óptima, sigue estas recomendaciones:

1. Usa MariaDB si puedes

Es un reemplazo directo de MySQL, más rápido y con mejor rendimiento. La mayoría de los hostings modernos lo ofrecen.

2. Crea un usuario dedicado

No uses el usuario root para tu tienda. Crea un usuario específico para PrestaShop con los permisos necesarios. Esto es más seguro.

3. Elige la codificación correcta

Asegúrate de que la base de datos esté configurada con la codificación utf8mb4 y el cotejamiento utf8mb4_general_ci o utf8mb4_unicode_ci. Esto evita problemas con emojis y caracteres especiales en tu tienda.

4. Optimiza las tablas

Después de la instalación o migración, puedes ir a phpMyAdmin (o la herramienta que te ofrezca tu hosting) y hacer clic en "Optimizar tablas". Esto ayuda a mejorar el rendimiento.

FAQ: Preguntas frecuentes sobre la conexión

¿Puedo usar SQLite en lugar de MySQL?

No. PrestaShop está diseñado exclusivamente para funcionar con bases de datos MySQL/MariaDB. No intentes usar otros motores.

¿Qué hago si mi hosting no me da acceso a phpMyAdmin?

Puedes usar herramientas como Adminer o la línea de comandos (SSH) si tienes conocimientos avanzados. Si no, contacta con tu proveedor de hosting; la mayoría lo ofrece.

¿Es lo mismo editar `parameters.php` que `settings.inc.php`?

En versiones antiguas de PrestaShop (1.6 y anteriores), la configuración estaba en config/settings.inc.php. Desde PrestaShop 1.7 en adelante, se usa config/parameters.php. Si tienes una versión antigua, busca el archivo settings.inc.php.

¿Por qué mi tienda da error 500 después de editar `parameters.php`?

Esto casi siempre se debe a un error de sintaxis en el archivo. Revisa que no haya comas de más o comillas sin cerrar. También asegúrate de haber guardado el archivo en UTF-8 sin BOM.

¿Puedo conectar PrestaShop a una base de datos remota en otro servidor?

Sí, es posible. Solo necesitas que el servidor de la base de datos permita conexiones externas (no solo localhost) y que el host en parameters.php sea la IP o dominio del servidor remoto. Ten en cuenta que esto puede aumentar la latencia y ralentizar tu tienda.

Conclusión final

Conectar PrestaShop a una base de datos MySQL/MariaDB es un proceso que, una vez entendido, se convierte en una tarea de rutina. Ya sea a través del asistente de instalación o editando manualmente el archivo parameters.php, la clave está en tener los datos correctos y entender qué espera PrestaShop de cada campo.

Hemos cubierto desde el principio más básico hasta la solución de errores comunes. La próxima vez que veas un prestashop mysql error, ya sabrás exactamente por dónde empezar a mirar. Si has seguido esta guía y aún tienes problemas, no dudes en contactar con el soporte técnico de tu hosting, pero ahora podrás describirles el problema con un nivel de detalle mucho más profesional.

Recuerda: la paciencia y la atención al detalle son tus mejores aliadas. ¡Tu tienda online estará funcionando en un abrir y cerrar de ojos!