Conectar PrestaShop a MySQL | Configuración Completa 2024

Antes de Empezar: ¿Qué Necesitas Saber?

Conectar PrestaShop a una base de datos MySQL es uno de los pasos más importantes durante la instalación o migración de tu tienda online. Sin una conexión correcta, tu tienda simplemente no funcionará.

No te preocupes si no eres un experto en tecnología. En esta guía te explicaré todo el proceso paso a paso, desde qué es una base de datos hasta cómo configurar los archivos de conexión, resolver errores comunes y optimizar el rendimiento.

Esta guía está pensada para que cualquier persona, aunque no tenga conocimientos avanzados, pueda conectar PrestaShop MySQL sin frustraciones. Vamos a ello.

¿Qué es una Base de Datos y Por Qué PrestaShop la Necesita?

Piensa en una base de datos como el almacén central de tu tienda. Ahí se guardan todos los productos, pedidos, clientes, contraseñas, configuraciones y cualquier otro dato importante.

PrestaShop es un software que necesita un lugar donde guardar toda esa información. Para eso usa MySQL, que es un sistema de gestión de bases de datos muy popular, gratuito y fiable.

La conexión MySQL PrestaShop es el puente que permite que tu tienda se comunique con ese almacén. Si el puente está roto o mal configurado, tu tienda no podrá mostrar productos ni procesar pedidos.

Requisitos Previos para la Conexión

Antes de empezar a configurar nada, asegúrate de tener lo siguiente:

Un panel de control de hosting (cPanel, Plesk, Syspanel, etc.) con acceso a la gestión de bases de datos.
Credenciales de acceso a tu hosting (usuario y contraseña).
El archivo de PrestaShop ya subido a tu servidor (o la posibilidad de subirlo).
Un navegador web para acceder al instalador.

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), recuerda que el acceso al panel se realiza a través del puerto 2106. Por ejemplo: https://tu-dominio.com:2106. Ahí podrás gestionar tus bases de datos MySQL fácilmente.

Paso 1: Crear la Base de Datos MySQL

El primer paso para configurar PrestaShop MySQL es tener una base de datos creada. Si ya tienes una, puedes saltarte este paso. Si no, sigue estas instrucciones:

En cPanel (el más común)

Inicia sesión en tu cPanel.
Busca la sección Bases de Datos y haz clic en Asistente para Bases de Datos MySQL.
Escribe un nombre para tu base de datos (por ejemplo, prestashop_db) y haz clic en Siguiente paso.
A continuación, crea un usuario para esa base de datos. Elige un nombre (por ejemplo, prestashop_user) y una contraseña segura.
Asigna el usuario a la base de datos con TODOS LOS PRIVILEGIOS.
Haz clic en Finalizar.

En Syspanel (HestiaCP)

Accede a tu Syspanel usando el puerto 2106.
Ve a la sección Bases de Datos o Base de datos.
Haz clic en Añadir base de datos.
Rellena los campos:
- Nombre de la base de datos: Elige uno descriptivo.
- Usuario: Se creará automáticamente con el nombre de tu usuario.
- Contraseña: Genera una segura o escribe una tú.
Guarda los cambios. El sistema creará tanto la base de datos como el usuario automáticamente.

[WARNING] Anota estos datos en un lugar seguro: nombre de la base de datos, usuario, contraseña y host. Los necesitarás en los próximos pasos. Si los pierdes, tendrás que resetear la contraseña o crear una nueva base.

Paso 2: Identificar el Host de la Base de Datos

Uno de los errores más comunes al intentar conectar PrestaShop MySQL es usar un host incorrecto. No siempre es localhost.

En la mayoría de los hostings compartidos, el host es localhost.
En otros casos (como algunos servidores dedicados o VPS), el host puede ser algo como mysql.tudominio.com o una IP específica.

¿Cómo saber cuál es tu host?

Revisa la documentación de tu proveedor de hosting.
En cPanel, busca la sección Bases de Datos MySQL. Ahí verás el nombre del servidor (normalmente aparece junto a los nombres de las bases de datos).
En Syspanel, ve a la sección de bases de datos. El host suele ser localhost o el nombre de tu servidor.

[TIP] Si no estás seguro, prueba primero con localhost. Es el valor más común. Si falla, contacta con el soporte de tu hosting y pregunta por el host de MySQL.

Paso 3: Configurar la Conexión Durante la Instalación de PrestaShop

Si estás instalando PrestaShop desde cero, el instalador te pedirá los datos de la base de datos en el paso llamado Configuración de la base de datos. Aquí es donde debes introducir toda la información.

Los campos que verás son:

Motor de base de datos: Selecciona MySQL (o MySQLi si te lo pide).
Dirección del servidor: Aquí va el host (normalmente localhost).
Nombre de la base de datos: El nombre que creaste en el paso 1.
Usuario: El usuario que creaste.
Contraseña: La contraseña del usuario.
Prefijo de las tablas: Por defecto es ps_. Puedes cambiarlo por seguridad, pero si no sabes qué es, déjalo como está.

Una vez rellenes todos los campos, haz clic en Probar la conexión. Si todo está bien, el instalador continuará. Si no, te mostrará un error que tendrás que resolver.

Paso 4: Configurar la Conexión en una Instalación Existente (Archivo parameters.php)

¿Ya tienes PrestaShop instalado pero necesitas cambiar la conexión a la base de datos? Entonces tendrás que editar el archivo de configuración.

Este archivo se llama parameters.php y se encuentra en la carpeta app/config/ de tu instalación de PrestaShop.

Cómo editarlo

Accede a tu servidor mediante FTP o el administrador de archivos de tu hosting.
Navega hasta la carpeta app/config/.
Busca el archivo parameters.php y ábrelo con un editor de texto (como Notepad++ o el editor de tu hosting).
Localiza el bloque que dice database_host, database_name, database_user y database_password.

Qué debes cambiar

database_host: Pon el host de tu base de datos.
database_name: El nombre de tu base de datos.
database_user: El usuario de la base de datos.
database_password: La contraseña del usuario.
database_prefix: El prefijo de las tablas (normalmente ps_).

Ejemplo de cómo se ve:

'database_host' => 'localhost',
'database_name' => 'prestashop_db',
'database_user' => 'prestashop_user',
'database_password' => 'tu_contraseña_segura',
'database_prefix' => 'ps_',

[WARNING] Ten mucho cuidado al editar este archivo. Un error de sintaxis (como una coma mal puesta o una comilla sin cerrar) puede dejar tu tienda completamente inaccesible. Haz una copia de seguridad antes de modificar nada.

Paso 5: Probar la Conexión Manualmente (Opcional)

Si quieres comprobar si tus datos son correctos antes de tocar PrestaShop, puedes hacer una prueba rápida con un archivo PHP.

Crea un archivo llamado test.php con el siguiente contenido:

<?php
$connection = @mysqli_connect('localhost', 'usuario', 'contraseña', 'nombre_base_datos');
if (!$connection) {
    die('Error de conexión: ' . mysqli_connect_error());
}
echo '¡Conexión exitosa!';
mysqli_close($connection);
?>

Sube este archivo a la carpeta raíz de tu tienda (donde está el index.php de PrestaShop).
Accede a https://tu-dominio.com/test.php en tu navegador.
Si ves el mensaje ¡Conexión exitosa!, tus datos son correctos.
IMPORTANTE: Borra este archivo inmediatamente después de la prueba. Dejarlo en el servidor es un riesgo de seguridad muy grave.

[INFO] Este archivo de prueba es solo para diagnóstico. Nunca lo dejes en producción, ya que expondría tus credenciales de la base de datos.

Paso 6: Errores Comunes y Cómo Solucionarlos

Aunque sigas todos los pasos, a veces pueden aparecer errores. Aquí tienes los más frecuentes al conectar PrestaShop MySQL y sus soluciones:

Error: "No se puede conectar a la base de datos"

Causa: Host incorrecto, credenciales mal escritas o servidor de base de datos caído.
Solución: Revisa el host, usuario y contraseña. Prueba con localhost o contacta con tu hosting.

Error: "Acceso denegado para el usuario"

Causa: El usuario no tiene permisos sobre la base de datos.
Solución: Ve a tu panel de control y asegúrate de que el usuario tiene TODOS LOS PRIVILEGIOS sobre la base de datos.

Error: "No se encuentra la base de datos"

Causa: El nombre de la base de datos es incorrecto.
Solución: Verifica que el nombre esté bien escrito. En algunos hostings, el nombre lleva un prefijo con tu usuario (ejemplo: usuario_prestashop_db).

Error: "El prefijo de las tablas ya está en uso"

Causa: Ya existe una instalación con el mismo prefijo.
Solución: Cambia el prefijo a otro valor (por ejemplo, ps2_) o borra las tablas antiguas si no las necesitas.

Error: "La versión de MySQL no es compatible"

Causa: Tu servidor tiene una versión de MySQL demasiado antigua o demasiado nueva.
Solución: Contacta con tu hosting para que actualicen MySQL, o consulta la documentación de PrestaShop para ver qué versiones son compatibles.

Paso 7: Optimizar la Conexión a la Base de Datos

Una vez que ya sabes configurar PrestaShop MySQL, es hora de asegurarte de que la conexión sea rápida y estable. Una mala conexión puede ralentizar tu tienda y afectar a tu posicionamiento SEO.

Consejos para optimizar

Usa un host local si es posible: Si tu base de datos está en el mismo servidor que tu tienda, usa localhost. Esto reduce la latencia.
Activa la caché de MySQL: PrestaShop tiene opciones de caché en el back office. Actívalas para reducir las consultas a la base de datos.
Configura el motor de almacenamiento InnoDB: Es más fiable y soporta transacciones. La mayoría de los hostings ya lo usan por defecto.
Mantén tu base de datos limpia: Elimina tablas o datos que ya no uses. Puedes usar plugins o consultas SQL para optimizarla.
Revisa los logs de errores: Si tu tienda va lenta, revisa los logs de MySQL para ver si hay consultas lentas o errores de conexión.

[TIP] Si tu tienda recibe mucho tráfico, considera usar un servicio de base de datos administrada como Amazon RDS o Google Cloud SQL. Son más rápidos y escalables, pero requieren más conocimientos técnicos.

Preguntas Frecuentes (FAQ)

¿Puedo usar MariaDB en lugar de MySQL?

Sí, PrestaShop es compatible con MariaDB, que es un clon mejorado de MySQL. La configuración es exactamente la misma.

¿Qué hago si olvidé la contraseña de mi base de datos?

Puedes resetearla desde tu panel de control. En cPanel, ve a Bases de datos MySQL, selecciona el usuario y haz clic en Cambiar contraseña. En Syspanel, edita el usuario de la base de datos y genera una nueva contraseña.

¿Puedo cambiar el prefijo de las tablas después de la instalación?

Sí, pero es un proceso delicado. Debes modificar el prefijo en el archivo parameters.php y luego renombrar todas las tablas de la base de datos con una consulta SQL. Es recomendable hacerlo solo si sabes lo que haces.

¿Es seguro usar `localhost` como host?

Sí, siempre que la base de datos esté en el mismo servidor que PrestaShop. Si usas un servicio externo, deberás usar el host que te proporcione ese servicio.

¿Qué hago si veo el error "mysqli_connect(): (HY000/2002)"?

Este error indica que no se puede conectar al servidor MySQL. Revisa el host y el puerto. A veces el puerto no es el 3306 por defecto. Pregunta a tu hosting por el puerto correcto.

Conclusión Final

Configurar PrestaShop MySQL no tiene por qué ser un dolor de cabeza. Con esta guía paso a paso, ya sabes cómo crear una base de datos, configurar la conexión tanto en instalaciones nuevas como existentes, y resolver los errores más comunes.

Recuerda siempre:

Tener a mano tus credenciales.
Hacer copias de seguridad antes de modificar cualquier archivo.
Probar la conexión antes de lanzar tu tienda.

Una buena base datos PrestaShop es la base de un negocio online sólido. Si sigues estos pasos, tu tienda funcionará sin problemas y tus clientes disfrutarán de una experiencia rápida y segura.

[INFO] Si después de todo sigues teniendo problemas, no dudes en contactar con el soporte técnico de tu hosting. Ellos tienen acceso directo a los servidores y pueden ayudarte a diagnosticar el problema de forma más rápida.

Recursos Adicionales

Documentación oficial de PrestaShop: Puedes consultar la guía de instalación en la web oficial de PrestaShop.
Foros de PrestaShop: Hay una gran comunidad donde puedes preguntar dudas y encontrar soluciones.
Guías de tu hosting: Muchos hostings tienen tutoriales específicos para instalar PrestaShop en sus servidores.

Espero que esta guía te haya sido de gran ayuda. ¡Ahora ya sabes conectar PrestaShop MySQL como un profesional! Mucha suerte con tu tienda online.