PrestaShop: Configurar Conexión a Base de Datos | Guía

¿Qué es parameters.php y por qué es tan importante en PrestaShop?

Si alguna vez has movido tu tienda PrestaShop de un servidor a otro, o has intentado cambiar la contraseña de tu base de datos, te habrás encontrado con un archivo llamado parameters.php. Este archivo es, ni más ni menos, el "cerebro" que conecta tu tienda con su base de datos. Sin él, PrestaShop no puede funcionar, porque es el encargado de decirle a la aplicación dónde están tus productos, pedidos, clientes y todas las configuraciones.

Piensa en parameters.php como la llave de tu casa. Si la llave no encaja perfectamente en la cerradura (en este caso, si los datos de conexión son incorrectos), no podrás entrar. Lo mismo ocurre con tu tienda: si los datos de conexión a la base de datos están mal, verás un error de conexión o una página en blanco.

En este artículo te voy a explicar, paso a paso y sin tecnicismos innecesarios, cómo configurar la conexión a base de datos en PrestaShop editando el archivo parameters.php. También te daré trucos, advertencias y respuestas a las preguntas más frecuentes. Al final, serás capaz de hacerlo tú mismo sin miedo a romper nada (aunque siempre con precaución).

¿Dónde se encuentra el archivo parameters.php?

Lo primero es localizar el archivo. Normalmente, parameters.php se encuentra en la carpeta config de tu instalación de PrestaShop. La ruta típica sería algo así:

/tu_dominio.com/config/parameters.php

Si estás usando un panel de control como cPanel, Syspanel (recuerda, el acceso a Syspanel es por el puerto 2106) o un cliente FTP como FileZilla, podrás navegar hasta esa carpeta y encontrar el archivo.

[TIP] Antes de tocar nada, haz una copia de seguridad del archivo original. Puedes descargarlo a tu ordenador o renombrarlo como parameters_backup.php. Así, si algo sale mal, puedes restaurarlo fácilmente.

Estructura básica del archivo parameters.php

Cuando abras el archivo con un editor de texto (como el Bloc de notas, Sublime Text o Visual Studio Code), verás un código PHP que contiene un array con varias claves. No te asustes si no entiendes todo el código; solo nos interesan unas pocas líneas, concretamente las que empiezan por database_.

Aquí tienes un ejemplo de cómo se ve la parte relevante:

'database_host' => 'localhost',
'database_port' => '3306',
'database_name' => 'mi_tienda',
'database_user' => 'usuario_bd',
'database_password' => 'mi_contraseña_secreta',
'database_prefix' => 'ps_',

Vamos a desglosar cada uno de estos campos para que sepas qué significa cada uno y cómo rellenarlo correctamente.

Campos clave de la conexión MySQL en PrestaShop

database_host (El servidor de la base de datos)

Este campo indica la dirección del servidor donde está alojada tu base de datos. En la mayoría de los casos, si tu tienda y tu base de datos están en el mismo servidor, el valor será localhost o 127.0.0.1.

Sin embargo, si estás usando un servicio de base de datos externo (como Amazon RDS o un servidor dedicado separado), aquí tendrás que poner la IP o el nombre de host que te haya proporcionado tu proveedor.

[INFO] En Syspanel, cuando creas una base de datos, normalmente te aparece el host como localhost. Si tienes dudas, revisa la sección de bases de datos de tu panel.

database_port (El puerto de conexión)

El puerto por defecto para MySQL es el 3306. En la gran mayoría de los casos, no tendrás que cambiar este valor. Solo si tu proveedor de hosting te indica un puerto diferente (algo poco común) deberías modificarlo.

database_name (El nombre de la base de datos)

Este es el nombre exacto de tu base de datos. Si usas un panel como cPanel o Syspanel, normalmente tendrá un prefijo con tu nombre de usuario (por ejemplo, usuario_mi_tienda). Asegúrate de copiarlo exactamente igual, respetando mayúsculas y minúsculas.

database_user (El usuario de la base de datos)

Es el usuario que tiene permisos para acceder a la base de datos. A menudo coincide con el nombre de la base de datos o con tu usuario de hosting. Debe tener privilegios de lectura, escritura y modificación (SELECT, INSERT, UPDATE, DELETE, etc.).

database_password (La contraseña del usuario)

Aquí va la contraseña asociada al usuario de la base de datos. Es importante que sea exactamente la misma que configuraste al crear la base de datos. Si la has olvidado, tendrás que cambiarla desde el panel de control de tu hosting.

database_prefix (El prefijo de las tablas)

Este campo indica el prefijo que tienen las tablas de tu base de datos. Por defecto, PrestaShop usa ps_. Si has heredado una tienda de otra persona o la has migrado, puede que el prefijo sea diferente (como prestashop_ o shop_). Este dato es crucial: si lo pones mal, PrestaShop no encontrará sus tablas y verás un error.

Cómo editar parameters.php paso a paso

Ahora que ya sabes qué significa cada campo, vamos a la parte práctica. Sigue estos pasos con calma:

Paso 1: Accede a tu servidor

Puedes hacerlo mediante un cliente FTP (como FileZilla), el administrador de archivos de tu panel de hosting o, si tienes acceso, por SSH. En Syspanel, por ejemplo, puedes usar el administrador de archivos integrado o conectarte por FTP usando las credenciales que te proporciona el panel.

Paso 2: Localiza y descarga el archivo

Navega hasta la carpeta config y busca el archivo parameters.php. Descárgalo a tu ordenador para editarlo con tranquilidad.

Paso 3: Haz una copia de seguridad

Antes de editarlo, copia el archivo original en otra ubicación (por ejemplo, parameters_original.php). Esto es fundamental por si cometes algún error.

Paso 4: Edita el archivo

Abre el archivo con un editor de texto que no añada formato (nada de Word o Pages). Recomiendo Sublime Text, Visual Studio Code o incluso el Bloc de notas.

Busca las líneas que empiezan por 'database_ y modifica los valores según tus datos. Por ejemplo:

'database_host' => 'localhost',
'database_port' => '3306',
'database_name' => 'miprestashop_bd',
'database_user' => 'miprestashop_admin',
'database_password' => 'ClaveSuperSegura123!',
'database_prefix' => 'ps_',

Paso 5: Guarda y sube el archivo

Guarda los cambios y sube el archivo modificado a la misma ubicación (reemplazando el original). Si usas FTP, asegúrate de que la transferencia sea en modo ASCII (texto) y no binario.

Paso 6: Verifica la conexión

Ahora, intenta acceder a tu tienda. Si todo está correcto, verás tu web sin problemas. Si hay algún error, no te preocupes: en la siguiente sección te explico los errores más comunes y cómo solucionarlos.

Errores comunes al configurar la conexión MySQL en PrestaShop

Error: "Link to database cannot be established"

Este es el error más típico. Suele aparecer cuando los datos de conexión son incorrectos. Revisa, en este orden:

El host: ¿Está bien escrito? ¿Es localhost o un servidor externo?
El puerto: ¿Es el 3306? ¿Tu hosting usa otro?
El nombre de la base de datos: ¿Existe realmente? ¿Tiene el prefijo correcto?
El usuario y la contraseña: ¿Son correctos? ¿El usuario tiene permisos?

[WARNING] Si has cambiado la contraseña de la base de datos desde el panel de hosting, asegúrate de actualizarla también en parameters.php. Es un olvido muy común.

Error: "Table 'ps_XXX' doesn't exist"

Este error indica que el prefijo de las tablas no coincide con el que realmente usa tu base de datos. Puedes comprobarlo entrando en la base de datos (con phpMyAdmin, por ejemplo) y mirando cómo se llaman las tablas. Si se llaman mi_prefijo_productos, entonces el valor en database_prefix debe ser mi_prefijo_.

Error: Página en blanco tras editar el archivo

Esto suele ocurrir por un error de sintaxis en el archivo PHP. Quizás has borrado una coma, una comilla o un punto y coma sin querer. Revisa el archivo línea por línea o, mejor aún, restaura la copia de seguridad y vuelve a intentarlo con más calma.

Error: "Access denied for user"

Este error significa que el usuario de la base de datos no tiene permisos para conectarse desde ese host. En algunos paneles, debes especificar que el usuario puede conectarse desde localhost o desde % (cualquier host). Revisa la configuración de tu base de datos en el panel de control.

Consejos avanzados para no romper nada

Usa siempre un editor de texto plano

No uses procesadores de texto como Word, ya que pueden añadir caracteres invisibles que rompan el archivo PHP. Un editor de código es lo ideal.

Ten cuidado con las comillas

El archivo parameters.php usa comillas simples para los valores. Si tu contraseña contiene una comilla simple (como pa'la), tendrás que escaparla con una barra invertida (pa\'la). Si no lo haces, el archivo dará error.

No dejes espacios en blanco al principio o final del archivo

El archivo debe empezar con <?php y no debe haber espacios o líneas en blanco antes de esa etiqueta. Si los hay, PrestaShop mostrará un error de "headers already sent".

Cambia la contraseña desde el panel, no directamente en la base de datos

Si necesitas cambiar la contraseña de la base de datos, hazlo siempre desde el panel de control (cPanel, Syspanel, etc.) y luego actualiza parameters.php. Cambiarla directamente en phpMyAdmin puede causar conflictos.

Preguntas frecuentes (FAQ)

¿Puedo usar un archivo .env en lugar de parameters.php?

No, PrestaShop está diseñado para usar parameters.php en la carpeta config. No intentes usar archivos .env a menos que sepas muy bien lo que haces, ya que podrías romper la instalación.

¿Qué pasa si borro parameters.php por error?

Si borras el archivo, PrestaShop no funcionará. Deberás crear uno nuevo desde cero o, mejor, restaurar una copia de seguridad. Si no tienes copia, puedes generar uno nuevo mediante el instalador de PrestaShop, pero perderás la configuración actual.

¿Necesito cambiar parameters.php si cambio de hosting?

Sí, casi siempre. Al cambiar de hosting, la base de datos suele tener un nombre, usuario y contraseña diferentes. Deberás actualizar esos datos en el archivo.

¿Puedo editar parameters.php desde el administrador de PrestaShop?

No, el archivo se edita a nivel de servidor. No hay una opción en el panel de administración para modificar estos parámetros (aunque sí puedes cambiar el prefijo de las tablas desde la base de datos, pero eso es más avanzado).

¿Es seguro compartir mi parameters.php con soporte técnico?

Ten mucho cuidado. Este archivo contiene la contraseña de tu base de datos, que es información muy sensible. Solo compártelo con personal de confianza y, si es posible, cambia la contraseña después de que terminen de trabajar.

Conclusión: Ya sabes configurar la conexión a base de datos en PrestaShop

Configurar parameters.php puede parecer intimidante al principio, pero una vez que entiendes qué hace cada campo, es un proceso bastante sencillo. Solo necesitas tener a mano los datos de tu base de datos (host, nombre, usuario y contraseña) y editarlo con un editor de texto plano.

Recuerda siempre hacer una copia de seguridad antes de modificar cualquier archivo importante. Y si algo sale mal, respira hondo, revisa los pasos y no dudes en consultar la documentación oficial o contactar con tu proveedor de hosting.

Ahora que ya sabes cómo hacerlo, puedes migrar tu tienda de servidor, cambiar de hosting o simplemente solucionar un error de conexión sin depender de nadie. ¡Tu tienda PrestaShop y su base de datos estarán en buenas manos (las tuyas)!

Si te ha quedado alguna duda, déjala en los comentarios y estaré encantado de ayudarte. ¡Buena suerte con tu tienda!