Configurar conexión a base de datos en PrestaShop con Plesk
Configurar la conexión a la base de datos en PrestaShop es un paso fundamental para que tu tienda online funcione correctamente. Si usas Plesk como panel de control de tu hosting, este proceso es muy sencillo. En esta guía te explicaremos paso a paso cómo hacerlo, desde la creación de la base de datos en Plesk hasta la edición del archivo parameters.php de PrestaShop. Todo explicado de forma clara y para que lo puedas seguir aunque no tengas experiencia técnica.
¿Qué necesitas saber antes de empezar?
Antes de lanzarte a configurar la PrestaShop Plesk database, es importante que tengas claros algunos conceptos básicos. No te preocupes, son muy simples.
¿Qué es una base de datos?
Imagina que tu tienda PrestaShop es un gran almacén. La base de datos es el sistema de estanterías y archivadores donde guardas toda la información: productos, clientes, pedidos, precios, etc. Sin una base de datos, tu tienda no podría recordar nada.
¿Qué es Plesk?
Plesk es un panel de control que usan muchos proveedores de hosting para que puedas administrar tu sitio web de forma visual y sencilla. Desde Plesk puedes crear bases de datos, gestionar archivos, correos electrónicos y mucho más.
¿Qué es el archivo parameters.php?
Es el archivo de configuración de PrestaShop. Dentro de él se guardan los datos de conexión a tu base de datos: el nombre de la base, el usuario, la contraseña y el servidor. Si este archivo no está bien configurado, tu tienda no podrá conectarse a la base de datos y verás errores.
Paso 1: Crear la base de datos en Plesk
Lo primero que debes hacer es crear una base de datos vacía en Plesk. Sigue estos pasos:
- Inicia sesión en Plesk. Normalmente accedes a través de una URL como
https://tudominio.com:8443o la que te haya proporcionado tu hosting. - Ve a la sección "Bases de datos". En el menú principal, busca la opción que dice "Bases de datos" o "Databases". Puede estar dentro de "Sitios web y dominios".
- Haz clic en "Añadir base de datos". Se abrirá un formulario.
- Rellena los campos:
- Nombre de la base de datos: Elige un nombre descriptivo, por ejemplo
miprestashop_db. - Tipo de base de datos: Selecciona MySQL (es el más común y el que usa PrestaShop).
- Usuario de la base de datos: Crea un usuario nuevo, por ejemplo
miprestashop_user. - Contraseña: Genera una contraseña segura. Puedes usar el generador que trae Plesk. Guarda esta contraseña en un lugar seguro, la necesitarás más adelante.
- Nombre de la base de datos: Elige un nombre descriptivo, por ejemplo
- Haz clic en "Aceptar". Plesk creará la base de datos y el usuario automáticamente.
[TIP] Anota en un bloc de notas el nombre de la base de datos, el usuario y la contraseña. Los vas a necesitar en los pasos siguientes.
Paso 2: Localizar el archivo parameters.php de PrestaShop
El archivo parameters.php se encuentra dentro de la carpeta de instalación de PrestaShop, normalmente en la ruta app/config/parameters.php. Si tu PrestaShop está instalado en la raíz de tu dominio, la ruta completa sería algo como /var/www/vhosts/tudominio.com/httpdocs/app/config/parameters.php.
Para acceder a él desde Plesk:
- Ve a "Administrador de archivos" en Plesk. Está en la sección "Sitios web y dominios".
- Navega hasta la carpeta
app/configde tu instalación de PrestaShop. - Busca el archivo
parameters.php. Si no lo ves, asegúrate de que tienes activada la opción "Mostrar archivos ocultos" en el administrador de archivos. - Descarga una copia de seguridad de este archivo antes de editarlo. Así, si algo sale mal, puedes restaurarlo.
[WARNING] Nunca edites el archivo
parameters.phpdirectamente desde el editor de Plesk sin hacer una copia de seguridad. Un error puede dejar tu tienda inaccesible.
Paso 3: Editar el archivo parameters.php para conectar la base de datos
Ahora viene la parte clave: configurar base de datos PrestaShop en el archivo parameters.php. Abre el archivo con un editor de texto (puedes usar el editor integrado de Plesk o descargarlo y editarlo en tu ordenador).
El archivo parameters.php tiene una estructura similar a esta (simplificada):
<?php
return array(
'parameters' => array(
'database_host' => 'localhost',
'database_port' => '',
'database_name' => 'nombre_base_datos',
'database_user' => 'usuario_base_datos',
'database_password' => 'contraseña_base_datos',
'database_prefix' => 'ps_',
// ... otros parámetros
),
);
Debes modificar las siguientes líneas con los datos que creaste en Plesk:
'database_host': Normalmente es'localhost'si tu base de datos está en el mismo servidor que tu web. Si tu hosting te ha dado un servidor específico (por ejemplo,mysql.tudominio.com), cámbialo.'database_name': Pon el nombre de la base de datos que creaste, por ejemplo'miprestashop_db'.'database_user': Pon el nombre del usuario, por ejemplo'miprestashop_user'.'database_password': Pon la contraseña que elegiste (entre comillas simples).'database_prefix': Déjalo como'ps_'a menos que sepas que necesitas otro prefijo.
[INFO] Si no estás seguro de qué valor poner en
'database_host', consulta con tu proveedor de hosting. En la mayoría de los casos, con'localhost'es suficiente.
Guarda los cambios y sube el archivo si lo editaste localmente.
Paso 4: Verificar la conexión desde Plesk
Una vez que has editado el archivo, es buena idea comprobar que la conexión funciona. Plesk te permite hacer una prueba directamente:
- Ve a la sección "Bases de datos" en Plesk.
- Selecciona la base de datos que creaste (por ejemplo
miprestashop_db). - Haz clic en "Probar conexión" o "Check connection". Plesk intentará conectar con los datos que has puesto en
parameters.php. - Si la conexión es exitosa, verás un mensaje verde. Si no, revisa los datos (nombre, usuario, contraseña) y vuelve a intentarlo.
[TIP] Si la prueba falla, lo más común es que hayas escrito mal la contraseña o el nombre de usuario. Revisa mayúsculas, minúsculas y caracteres especiales.
Paso 5: Probar tu tienda PrestaShop
Después de configurar la conexión, es hora de comprobar que tu tienda funciona correctamente.
- Abre tu navegador y visita la URL de tu tienda (por ejemplo,
https://tudominio.com). - Si todo está bien, verás la página principal de PrestaShop sin errores.
- Prueba a navegar por algunas secciones: productos, categorías, carrito de compra. Asegúrate de que no aparecen mensajes de error relacionados con la base de datos.
Si ves un error como "Error de conexión a la base de datos" o "Unable to connect to database", revisa los pasos anteriores. Lo más probable es que haya un error en parameters.php o que los datos no coincidan.
[WARNING] Si después de varios intentos sigues viendo errores, no dudes en contactar con el soporte técnico de tu hosting. Ellos pueden ayudarte a verificar la configuración de Plesk PrestaShop MySQL.
Solución de problemas comunes (FAQ)
Aquí tienes las preguntas más frecuentes que resuelven dudas sobre la conexión base de datos PrestaShop:
¿Por qué me sale "Error de conexión a la base de datos" al instalar PrestaShop?
Esto suele pasar cuando los datos en parameters.php no coinciden con los de la base de datos creada en Plesk. Revisa que el nombre de la base, el usuario y la contraseña sean exactamente los mismos. También asegúrate de que el servidor de base de datos (database_host) sea correcto.
¿Puedo usar la misma base de datos para dos instalaciones de PrestaShop?
No es recomendable. Cada instalación de PrestaShop debe tener su propia base de datos independiente. Si usas la misma, los datos se mezclarán y causarán errores graves.
¿Qué hago si olvidé la contraseña de la base de datos de Plesk?
Puedes cambiarla desde Plesk. Ve a "Bases de datos", selecciona la base de datos, haz clic en "Cambiar contraseña" y establece una nueva. Luego, actualiza el archivo parameters.php con la nueva contraseña.
¿Es necesario reiniciar algo después de modificar parameters.php?
No, los cambios se aplican al instante. Solo tienes que recargar la página de tu tienda.
¿Puedo usar herramientas como phpMyAdmin para gestionar la base de datos?
Sí, desde Plesk puedes acceder a phpMyAdmin para gestionar tu Plesk PrestaShop MySQL base de datos. Es útil para hacer copias de seguridad o reparar tablas.
Consejos adicionales para mantener tu base de datos segura
- Usa contraseñas seguras: Combina letras mayúsculas, minúsculas, números y símbolos.
- Haz copias de seguridad periódicas: Desde Plesk puedes programar backups automáticos de la base de datos.
- No compartas los datos de acceso: El archivo
parameters.phpcontiene información sensible. No lo subas a repositorios públicos ni lo compartas por email sin cifrar. - Actualiza PrestaShop regularmente: Las versiones nuevas corrigen vulnerabilidades que podrían afectar tu base de datos.
[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el proceso es similar pero accedes por el puerto 2106. En ese caso, busca la sección de bases de datos dentro de Syspanel y sigue los mismos pasos.
Conclusión
Configurar la PrestaShop Plesk database es un proceso sencillo si sigues los pasos adecuados. Recuerda que la clave está en tener los datos correctos en el archivo parameters.php y que la base de datos esté creada en Plesk. Con esta guía, has aprendido a:
- Crear una base de datos y un usuario en Plesk.
- Localizar y editar el archivo
parameters.php. - Verificar la conexión desde Plesk.
- Solucionar los errores más comunes.
Ahora tu tienda PrestaShop ya tiene la conexión a la base de datos correctamente configurada. Si tienes alguna duda, revisa los consejos de esta guía o consulta con tu proveedor de hosting. ¡Buena suerte con tu tienda online!
