PrestaShop: Configurar la conexión a la base de datos desde cero

¿Te ha pasado que al intentar entrar a tu tienda PrestaShop ves un mensaje de error sobre la base de datos y el corazón se te para? Es uno de los sustos más comunes en el mundo del hosting. Pero tranquilo, respira, que esto tiene solución y no necesitas ser un gurú de la programación para arreglarlo.

En este artículo vamos a desgranar, paso a paso y desde cero, cómo configurar la conexión a la base de datos en PrestaShop. Hablaremos de archivos de configuración, errores típicos y trucos para que tu tienda vuelva a la vida en cuestión de minutos. Así que, si estás listo, vamos a ponernos el mono de trabajo.

¿Qué es eso de la "conexión a la base de datos"?

Antes de meternos en faena, vamos a ponernos en situación. Imagina que tu tienda PrestaShop es una biblioteca enorme. Los libros son tus productos, los clientes, los pedidos, las contraseñas... Todo eso son datos. Pues bien, la base de datos (normalmente MySQL PrestaShop o MariaDB) es el almacén donde se guardan todos esos datos.

La "conexión" es el puente que une tu tienda (el escaparate que ve el mundo) con ese almacén. Si el puente se rompe, tu tienda no puede mostrar los productos ni procesar los pedidos. Por eso, cuando falla la conexión, PrestaShop se queda en blanco o muestra un mensaje de error. Es el famoso "Error de conexión a la base de datos" o similar.

El archivo clave: parameters.php

El corazón de esta conexión es un archivo llamado parameters.php. Piénsalo como la llave maestra que abre la puerta del almacén. Este archivo contiene las credenciales (usuario, contraseña, nombre de la base de datos y servidor) que tu PrestaShop necesita para entrar a su propio almacén.

¿Dónde está? Normalmente lo encontrarás en la raíz de tu instalación, dentro de la carpeta app/config/.

¿Qué información contiene?

Este archivo guarda una estructura de datos (un array, en lenguaje técnico) con los siguientes campos clave:

• database_host: La dirección del servidor donde vive tu base de datos. Suele ser localhost si todo está en el mismo servidor, o una IP/dominio si es un servidor externo.
• database_name: El nombre exacto de tu base de datos. Es único para tu tienda.
• database_user: El usuario que tiene permisos para acceder a esa base de datos.
• database_password: La contraseña de ese usuario.
• database_prefix: Un prefijo que se añade a las tablas de PrestaShop (por ejemplo, ps_). Es importante mantenerlo tal cual.

Guía paso a paso: Configurar la conexión desde cero

Vamos a ello. Aquí tienes el proceso completo, desde que abres el archivo hasta que guardas los cambios.

Paso 1: Localizar y abrir el archivo parameters.php

Primero, accede a tu hosting mediante FTP o desde el administrador de archivos de tu panel de control (cPanel, Syspanel, etc.). Recuerda que si usas Syspanel, el acceso se realiza a través del puerto 2106.

Una vez dentro, navega hasta la carpeta de tu tienda. Busca la ruta app/config/ y dentro de ella, el archivo parameters.php. Ábrelo con un editor de texto plano (como el Bloc de notas o un editor de código). Verás algo parecido a esto:

<?php
return array (
  'parameters' => array (
    'database_host' => 'localhost',
    'database_port' => '',
    'database_name' => 'miusuario_mitienda',
    'database_user' => 'miusuario_admin',
    'database_password' => 'mi_contraseña_secreta',
    'database_prefix' => 'ps_',
    // ... otros parámetros ...
  ),
);

Paso 2: Verificar los datos de tu base de datos

Ahora necesitas los datos correctos. ¿Dónde los encuentras? En el panel de control de tu hosting.

• Si usas cPanel: Busca la sección "Bases de Datos MySQL". Ahí verás el nombre de la base de datos, el usuario y podrás cambiar la contraseña.
• Si usas Syspanel: Accede a través del puerto 2106 y busca la sección de bases de datos. El proceso es similar: encontrarás el nombre de la BD, el usuario y la opción de gestionar la contraseña.

[WARNING] Es muy común que el nombre de la base de datos y el usuario tengan un prefijo con el nombre de tu cuenta de hosting (por ejemplo, usuario_bd). Asegúrate de copiar el nombre completo, tal y como aparece en tu panel.

Paso 3: Editar los campos del archivo

Con los datos correctos delante, edita los campos en parameters.php:

1. database_host: Si tu base de datos está en el mismo servidor que tu web, deja localhost. Si es un servidor externo (por ejemplo, una base de datos en la nube), pon la IP o el dominio que te hayan facilitado.
2. database_name: Sustituye por el nombre completo de tu base de datos.
3. database_user: Sustituye por el usuario completo.
4. database_password: Escribe la contraseña actual. Ojo: si la cambiaste en tu panel, usa la nueva. Si no, la que tenías antes.

[TIP] No toques el database_prefix a menos que sepas exactamente lo que haces. Si lo cambias, PrestaShop no encontrará sus tablas y te dará un error.

Paso 4: Guardar los cambios y probar

Guarda el archivo parameters.php y súbelo de vuelta a tu servidor si lo estabas editando en local. Ahora, intenta acceder a tu tienda.

Si todo ha ido bien, verás tu tienda funcionando con normalidad. Si no, pasa al siguiente apartado, porque vamos a solucionar los errores más comunes.

Errores PrestaShop más comunes y cómo solucionarlos

Aquí tienes una lista de los problemas más típicos y su solución:

1. "Error de conexión a la base de datos" o "Link to database cannot be established"

Este es el error genérico. Suele significar que los datos de conexión son incorrectos. Repasa el paso 3 y asegúrate de que has copiado bien el nombre de la BD, el usuario y la contraseña.

[WARNING] A veces, las contraseñas contienen caracteres especiales (como $, #, %) que en el archivo PHP deben ir escapados con una barra invertida (\). Por ejemplo, si tu contraseña es mi#clave, en el archivo debe aparecer como mi\#clave. Si no sabes hacerlo, cámbiala desde tu panel de control a una más simple, sin caracteres raros.

2. "Access denied for user 'usuario'@'localhost'"

Este error es más específico. Indica que el usuario existe, pero la contraseña no es correcta o que el usuario no tiene permisos para acceder a esa base de datos concreta.

Solución:

1. Ve a tu panel de control (cPanel o Syspanel por el puerto 2106).
2. Busca la sección de bases de datos.
3. Asegúrate de que el usuario está vinculado a la base de datos correcta.
4. Cambia la contraseña del usuario y actualiza el archivo parameters.php con la nueva contraseña.

3. "Unknown database 'nombre_bd'"

Este error significa que PrestaShop no encuentra la base de datos que le has indicado. Es como si intentaras abrir una puerta que no existe.

Solución:

1. Verifica el nombre exacto de la base de datos en tu panel de control.
2. Comprueba que has escrito el nombre completo, incluyendo el prefijo de tu cuenta de hosting.
3. Si la base de datos no existe, tendrás que crearla desde tu panel y luego importar una copia de seguridad de tu tienda.

4. El error de "Tabla no encontrada" (Table 'ps_...' doesn't exist)

Esto suele pasar cuando el prefijo de la base de datos no coincide con el que tiene PrestaShop en el archivo parameters.php.

Solución:

1. Si tienes una copia de seguridad de la base de datos, revisa el prefijo de las tablas (por ejemplo, ps_product, ps_orders).
2. Actualiza el campo database_prefix en parameters.php para que coincida exactamente.

5. Error 500 o pantalla blanca

A veces, un error en la conexión puede provocar un error 500. Esto puede deberse a un error de sintaxis en el archivo parameters.php (por ejemplo, una coma mal puesta).

Solución:

1. Revisa que el archivo no tenga caracteres extraños o comillas rotas.
2. Si has editado el archivo con un editor de texto que añade formato (como Word), puede que haya introducido caracteres invisibles. Usa un editor de código plano.
3. Activa el modo de depuración de PrestaShop (si puedes acceder al admin) para ver el error exacto.

¿Qué hago si no tengo acceso al archivo parameters.php?

Si no puedes acceder por FTP o el administrador de archivos, hay una alternativa: el instalador de PrestaShop.

1. Descarga una copia limpia de PrestaShop de la misma versión que tu tienda.
2. Sube los archivos del instalador a la raíz de tu web (sin sobrescribir tu carpeta actual, solo el instalador).
3. Ejecuta el instalador en tu navegador (por ejemplo, tudominio.com/install).
4. El instalador detectará que ya hay una instalación y te ofrecerá la opción de "Reparar la base de datos" o "Actualizar". Sigue los pasos y te pedirá los datos de conexión. Al finalizar, regenerará el archivo parameters.php correctamente.

[INFO] Este método es un poco más avanzado, pero muy útil si no puedes editar archivos manualmente. Eso sí, asegúrate de hacer una copia de seguridad de tu base de datos y archivos antes de intentarlo.

Consejos finales para evitar futuros dolores de cabeza

• Haz copias de seguridad periódicas: Tanto de los archivos como de la base de datos. Así, si algo falla, puedes restaurar rápidamente.
• Anota tus credenciales: Guarda en un lugar seguro (y fuera de línea) el nombre de la BD, el usuario y la contraseña.
• Cuidado al cambiar de hosting: Cuando migres de servidor, asegúrate de actualizar los datos de conexión en el parameters.php con los nuevos datos.
• Si usas Syspanel, recuerda que el acceso es por el puerto 2106 y que la gestión de bases de datos es muy similar a cPanel, pero con su propia interfaz.

Configurar la conexión a la base de datos en PrestaShop puede parecer una tarea de expertos, pero con un poco de calma y siguiendo estos pasos, es algo que puedes hacer tú mismo. La clave está en entender qué hace cada campo y en verificar que los datos son correctos.

Espero que esta guía te haya sido de ayuda. Si te ha pasado algo similar y lo has solucionado de otra forma, o si te surge alguna duda, no dudes en escribirla en los comentarios. ¡Estamos aquí para ayudarte a que tu tienda siga funcionando!