PrestaShop: Cómo cambiar la contraseña de la base de datos sin romper la tienda

Por qué cambiar la contraseña de la base de datos en PrestaShop puede ser un dolor de cabeza

Cambiar la contraseña de la base de datos de tu tienda PrestaShop es una tarea de mantenimiento habitual, ya sea por seguridad, por política de la empresa o porque alguien con acceso se ha ido del equipo. El problema es que, si no se hace correctamente, puedes dejar tu tienda completamente inaccesible, mostrando errores como "Error de conexión a la base de datos" o una pantalla en blanco.

La buena noticia es que, con el procedimiento adecuado, es un cambio que cualquier persona puede realizar en menos de 15 minutos, incluso sin ser un experto en desarrollo. En esta guía te explico, paso a paso y sin tecnicismos, cómo cambiar la contraseña de tu base de datos PrestaShop sin romper nada por el camino.

Vamos a dividir el proceso en dos fases claras: primero, la preparación (que es la parte más importante), y segundo, la ejecución del cambio. Si sigues estos pasos al pie de la letra, tu tienda seguirá funcionando como si nada hubiera pasado.

Antes de tocar nada: la fase de preparación

1. Haz una copia de seguridad completa (sí, es obligatorio)

Parece un consejo obvio, pero la mayoría de los problemas surgen cuando alguien intenta cambiar la contraseña sin hacer una copia de seguridad previa. No te saltes este paso. Necesitas dos copias:

• Copia de los archivos de tu tienda (todo el directorio donde está instalado PrestaShop). Puedes hacerlo desde el administrador de archivos de tu hosting o mediante FTP.
• Copia de la base de datos. Esto es fundamental. Si algo sale mal, podrás restaurar todo a su estado original.

[WARNING] Una copia de seguridad solo de la base de datos NO es suficiente. Si algo falla durante el cambio, necesitarás también los archivos para poder restaurar la configuración original. Haz ambas copias.

2. Localiza el archivo de configuración de PrestaShop

PrestaShop guarda los datos de conexión a la base de datos en un archivo llamado parameters.php. Este archivo se encuentra en la ruta:

/config/parameters.php

Dentro de tu directorio de instalación de PrestaShop (por ejemplo: public_html/config/parameters.php).

Este archivo contiene, entre otras cosas, el nombre de la base de datos, el usuario y la contraseña actual. Es el archivo que tendremos que editar más adelante, así que es importante que sepas dónde está y que tengas permisos para modificarlo.

3. Anota los datos actuales de conexión

Abre el archivo parameters.php con un editor de texto (como el Bloc de notas o Visual Studio Code) y busca las líneas que contienen:

'database_host' => 'localhost',
'database_name' => 'tu_base_de_datos',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña_actual',

Anota estos cuatro valores en un papel o en un documento aparte. Te harán falta para verificar que todo funciona correctamente después del cambio.

[INFO] Es normal que el archivo parameters.php tenga una estructura un poco compleja con más parámetros. No te asustes, solo necesitas localizar esas cuatro líneas clave. No modifiques nada más dentro de este archivo salvo la contraseña.

El proceso de cambio: paso a paso

4. Cambia la contraseña en tu panel de control de hosting

El primer paso es cambiar la contraseña en el lugar donde se gestiona la base de datos. Dependiendo de tu proveedor de hosting, esto se hace desde diferentes paneles. Te explico los dos casos más comunes:

Si usas cPanel (el panel más habitual)

1. Entra en cPanel y busca la sección "Bases de Datos MySQL".
2. Localiza tu base de datos en la lista y haz clic en "Cambiar contraseña" (o similar).
3. Introduce la nueva contraseña. Te recomiendo usar una contraseña larga y compleja (mínimo 12 caracteres, con mayúsculas, minúsculas, números y símbolos).
4. Guarda los cambios.

Si usas Syspanel (anteriormente conocido como HestiaCP)

[TIP] Si tu hosting usa Syspanel, recuerda que el acceso al panel se realiza a través del puerto 2106 (por ejemplo: https://tudominio.com:2106). No uses el puerto 2083, ese es de cPanel.

1. Entra en Syspanel con tu usuario y contraseña.
2. En el menú lateral, busca la sección de "Base de datos" o "Bases de datos".
3. Selecciona la base de datos que usa tu PrestaShop.
4. Busca la opción de "Cambiar contraseña" o "Editar usuario".
5. Introduce la nueva contraseña y confírmala.
6. Guarda los cambios.

5. Actualiza el archivo parameters.php

Ahora viene el paso más delicado: sincronizar la contraseña en el archivo de configuración de PrestaShop. Si no haces esto, tu tienda no podrá conectarse a la base de datos.

1. Abre el archivo parameters.php con tu editor de texto.
2. Localiza la línea que contiene 'database_password' => 'tu_contraseña_actual'.
3. Reemplaza tu_contraseña_actual por la nueva contraseña que acabas de establecer en el panel de hosting.
4. Guarda el archivo y súbelo de nuevo a tu servidor, reemplazando el archivo existente (si lo estás editando desde tu ordenador).

[WARNING] Asegúrate de no dejar espacios extra ni caracteres invisibles alrededor de la contraseña. El archivo debe quedar exactamente así: 'database_password' => 'MiNuevaContraseña123'. Cualquier carácter extra puede romper la conexión.

6. Verifica que todo funciona

Este es el momento de la verdad. Abre tu tienda en una ventana de incógnito (para evitar problemas de caché) y comprueba:

• La página principal carga correctamente sin errores.
• Accede al panel de administración de PrestaShop (/admin o la URL que hayas configurado).
• Haz una prueba de compra en modo catálogo o con un producto de prueba para asegurarte de que el carrito y el proceso de pago funcionan.

Si todo carga sin errores, ¡enhorabuena! Has cambiado la contraseña correctamente.

Qué hacer si algo sale mal

Error: "Error de conexión a la base de datos"

Este es el error más común cuando algo no se ha hecho bien. Si lo ves, no entres en pánico. Sigue estos pasos:

1. Revisa el archivo parameters.php: Abre el archivo y verifica que la contraseña está escrita exactamente igual que la que pusiste en el panel de hosting. Un error tipográfico es la causa más frecuente.
2. Comprueba que el archivo se ha subido correctamente: A veces, al subir el archivo, se corrompe o no se reemplaza el original. Vuelve a subirlo.
3. Restaure la copia de seguridad: Si nada de lo anterior funciona, restaura la copia de seguridad de la base de datos y del archivo parameters.php original. Tu tienda volverá a funcionar con la contraseña antigua.

[INFO] Si tu tienda está en un servidor con caché (como Varnish o Redis), es posible que necesites limpiar la caché después del cambio. Puedes hacerlo desde el panel de administración de PrestaShop en Parámetros avanzados > Rendimiento > Vaciar caché.

Preguntas frecuentes (FAQ)

¿Puedo cambiar la contraseña de la base de datos sin tocar el archivo parameters.php?

No. El archivo parameters.php es el que le dice a PrestaShop cómo conectarse a la base de datos. Si cambias la contraseña en el servidor pero no actualizas este archivo, la tienda dejará de funcionar. Es un paso obligatorio.

¿Cada cuánto tiempo debería cambiar la contraseña de la base de datos?

La recomendación general es cambiarla al menos una vez al año, o inmediatamente después de que alguien con acceso deje de trabajar en tu proyecto. También es buena práctica cambiarla si sospechas que ha podido ser comprometida.

¿Qué pasa si mi tienda usa un sistema de caché como Memcached o Redis?

Si usas caché, después de cambiar la contraseña deberías limpiar la caché tanto a nivel de PrestaShop como a nivel del servidor. Algunos sistemas de caché guardan datos de conexión antiguos y pueden dar errores temporales.

¿Es lo mismo cambiar la contraseña de la base de datos que cambiar la contraseña de administrador de PrestaShop?

No, son cosas completamente diferentes. La contraseña de la base de datos es la que usa PrestaShop para conectarse al servidor MySQL. La contraseña de administrador es la que usas tú para entrar al panel de control de tu tienda. Este artículo trata sobre la primera.

¿Puedo usar la misma contraseña para la base de datos y para el panel de administración?

Técnicamente puedes, pero no es recomendable. Si alguien descubre una de las dos contraseñas, tendría acceso a todo. Usa contraseñas diferentes y robustas para cada cosa.

Consejos finales para mantener tu base de datos PrestaShop segura

Cambiar la contraseña es solo una parte del mantenimiento de la seguridad de tu base de datos PrestaShop. Aquí tienes algunos consejos adicionales:

• Usa un usuario específico para la base de datos: No uses el usuario root de MySQL para tu tienda. Crea un usuario con permisos solo sobre la base de datos de PrestaShop.
• Limita el acceso remoto: Configura tu base de datos para que solo acepte conexiones desde localhost si no necesitas acceso remoto.
• Mantén PrestaShop actualizado: Las versiones antiguas tienen vulnerabilidades conocidas que pueden comprometer tu base de datos.
• Haz copias de seguridad periódicas: No esperes a tener un problema para hacer una copia. Configura copias automáticas diarias o semanales.

Cambiar la contraseña de la base de datos de PrestaShop es un proceso sencillo si se sigue el orden correcto: hacer copia de seguridad, cambiar la contraseña en el servidor, actualizar el archivo de configuración y verificar. Con esta guía, ya no tienes excusa para no hacerlo cuando sea necesario. Recuerda que la seguridad de tu tienda online es la seguridad de tu negocio, y un pequeño mantenimiento preventivo puede ahorrarte grandes dolores de cabeza en el futuro.

Si tienes alguna duda o tu caso es especialmente complejo (por ejemplo, si usas un hosting muy personalizado), siempre puedes contactar con el soporte técnico de tu proveedor de hosting. Ellos conocen su panel y podrán guiarte en el proceso específico para su sistema.