Conectar PrestaShop a MySQL | Configurar base de datos

Antes de Empezar: ¿Qué es la Conexión a MySQL y por qué es tan importante?

Cuando instalas PrestaShop, el corazón de tu tienda online (productos, pedidos, clientes, configuración) se guarda en una base de datos MySQL. Piensa en la base de datos como un gran archivador donde se guardan todas las fichas de tu negocio. La conexión es el puente entre tu tienda (el programa) y ese archivador.

Si ese puente se rompe o está mal configurado, tu tienda no funcionará. Verás pantallas en blanco, errores de conexión o, en el peor de los casos, no podrás acceder a tu panel de administración.

Este artículo te guiará paso a paso para conectar una base de datos MySQL a PrestaShop, configurar los parámetros correctamente en el archivo parameters.php y solucionar los errores más comunes (como el famoso "error conexion prestashop"). No necesitas ser un experto en programación, solo seguir las instrucciones con calma.

Paso 1: Identifica los Datos de tu Base de Datos (Credenciales)

Antes de tocar nada, necesitas tener a mano la "llave" de tu archivador. Es decir, los datos de acceso a tu base de datos MySQL. Sin estos datos, no podrás configurar nada.

Estos son los 4 datos que siempre necesitarás:

Nombre del servidor (Host): Normalmente es localhost o 127.0.0.1, pero si tu hosting es externo, puede ser una dirección como mysql.tudominio.com.
Nombre de la base de datos: El nombre que le pusiste a tu base de datos (ej: tienda_presta).
Usuario de la base de datos: El usuario con permisos para acceder (ej: admin_tienda).
Contraseña: La contraseña de ese usuario.

¿Dónde encuentro estos datos?

Depende de dónde esté alojada tu web:

Si usas un hosting compartido (cPanel, Plesk, etc.): Entra en el panel de control de tu hosting. Busca la sección "Bases de Datos MySQL". Allí verás una lista con las bases de datos, los usuarios y podrás crear o modificar contraseñas. Es el lugar más común.
Si usas un panel de administración como Syspanel: En Syspanel (antes conocido como HestiaCP), el acceso se realiza a través del puerto 2106 (ej: https://tu-servidor:2106). Dentro, busca la sección "Bases de Datos" o "DB". Ahí podrás ver el nombre de la base de datos, el usuario y, si no la recuerdas, podrás cambiar la contraseña desde el mismo panel.

[WARNING]
IMPORTANTE: Si no estás seguro de la contraseña, no la adivines. Es mejor cambiarla desde tu panel de control (cPanel o Syspanel) antes de empezar. Anótala en un lugar seguro.

Paso 2: Configurar la Conexión durante la Instalación de PrestaShop

Si estás instalando PrestaShop desde cero, el asistente de instalación te pedirá estos datos en el paso de "Configuración de la base de datos". Es el momento más fácil para hacerlo bien.

En el asistente, selecciona "MySQL" como motor de base de datos.
Rellena los campos con los datos que has recopilado en el Paso 1.
En el campo "Prefijo de las tablas", déjalo como ps_ a menos que tengas una razón específica para cambiarlo. Este prefijo ayuda a identificar las tablas de PrestaShop si compartes la base de datos con otras aplicaciones.

[TIP]
Si tu hosting te da la opción de "crear la base de datos" desde el asistente, úsala. Pero lo más común y recomendable es que la base de datos ya esté creada previamente en tu panel de control.

Paso 3: Configurar la Conexión en un PrestaShop ya Instalado (Archivo parameters.php)

¿Tu tienda ya está instalada pero necesitas cambiar la conexión? ¿Te mudaste de servidor? ¿O simplemente quieres verificar que todo está bien? Entonces, el archivo que te interesa es el parameters.php.

Este archivo es el "cerebro" de la configuración de conexión. Se encuentra en la carpeta app/config/ de tu instalación de PrestaShop.

¿Cómo editar el archivo parameters.php?

No necesitas un programa especial, solo un editor de texto plano (como el Bloc de Notas de Windows o TextEdit en Mac). NUNCA uses procesadores de texto como Word, ya que añaden caracteres invisibles que romperán el archivo.

Pasos para editarlo:

Accede a tu servidor: Necesitas un cliente FTP (como FileZilla) o el administrador de archivos de tu hosting o de Syspanel (accediendo por el puerto 2106).
Navega a la ruta: Localiza la carpeta app y dentro de ella, la carpeta config.
Descarga el archivo: Descarga parameters.php a tu ordenador.
Haz una copia de seguridad: ¡CRÍTICO! Antes de modificar nada, guarda una copia del archivo original en tu escritorio. Si algo sale mal, podrás restaurarlo.
Ábrelo con el editor de texto plano.

Verás un código PHP que contiene una matriz. Busca las líneas que dicen 'database_host', 'database_name', 'database_user' y 'database_password'.

Se verá algo así (los valores son ejemplos):

'database_host' => 'localhost',
'database_name' => 'mi_tienda_prestashop',
'database_user' => 'usuario_tienda',
'database_password' => 'contraseña_secreta',

Modifica los valores: Sustituye los textos entre comillas simples por tus datos correctos. Por ejemplo:

'database_host' => 'mysql.tudominio.com',
'database_name' => 'nueva_base_datos',
'database_user' => 'nuevo_usuario',
'database_password' => 'nueva_contraseña',

Guarda el archivo: Guarda los cambios en el archivo (con el mismo nombre y codificación UTF-8 sin BOM).
Sube el archivo: Sube el archivo modificado a la misma carpeta (app/config/), sobrescribiendo el anterior.

[WARNING]
¡CUIDADO! Un error de sintaxis (una coma mal puesta, una comilla sin cerrar) en el parameters.php hará que tu tienda muestre un error fatal. Revisa dos veces que el formato sea exactamente igual al original, solo cambiando los valores entre comillas.

Paso 4: Errores Comunes y Soluciones (Error Conexión PrestaShop)

Aquí tienes los problemas más frecuentes al configurar base de datos prestashop y cómo resolverlos.

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

Este es el error más común y suele aparecer durante la instalación o al intentar acceder a la tienda después de un cambio.

Causas y soluciones:

Datos incorrectos: Revisa que el usuario, contraseña, nombre de la base de datos y host sean exactamente los correctos. Un simple error tipográfico es la causa número uno.
Permisos insuficientes: El usuario de la base de datos debe tener todos los privilegios sobre la base de datos en cuestión (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.). Ve a tu panel de control (cPanel/Syspanel) y asegúrate de que el usuario está vinculado a la base de datos y con "TODOS LOS PRIVILEGIOS" marcados.
Host incorrecto: Si tu base de datos está en un servidor diferente al de tu web, el host no será localhost. A menudo los hostings tienen un host específico para MySQL (ej: mysql.tudominio.com o localhost). Consulta la documentación de tu hosting.
Contraseña con caracteres especiales: Si tu contraseña tiene caracteres como #, $, %, etc., a veces pueden causar problemas al guardarse en el archivo PHP. Intenta cambiarla por una más simple (solo letras y números) para descartar este problema.

Pantalla en blanco o error 500 después de editar parameters.php

Esto casi siempre es un problema de sintaxis en el archivo que has editado.

Solución:

Restaura la copia de seguridad que hiciste en el Paso 3.
Si no tienes copia, descarga de nuevo el parameters.php de tu instalación original o contacta con tu soporte.
Vuelve a editar con más cuidado, prestando atención a las comas y comillas.

[INFO]
¿Dónde veo los errores? Activa el modo de depuración de PrestaShop para ver errores detallados en lugar de una pantalla en blanco. Para ello, edita el archivo config/defines.inc.php y cambia la línea define('_PS_MODE_DEV_', false); a define('_PS_MODE_DEV_', true);. Recuerda volver a ponerlo en false cuando termines de arreglar el problema.

Paso 5: Consejos Avanzados y Buenas Prácticas

Para terminar, aquí tienes algunos consejos que te ahorrarán dolores de cabeza a largo plazo:

Usa siempre un usuario dedicado para PrestaShop

No utilices el usuario root de MySQL para tu tienda. Crea un usuario específico con permisos solo sobre la base de datos de PrestaShop. Esto es más seguro y evita problemas si otra aplicación en el mismo servidor se ve comprometida.

Cambia el prefijo de las tablas por seguridad

Aunque no es un requisito, cambiar el prefijo de las tablas de ps_ a algo personalizado (ej: mitienda_) en el parameters.php (línea 'database_prefix') añade una capa extra de seguridad, dificultando los ataques de inyección SQL automatizados.

Mantén una copia de seguridad del parameters.php

Guarda una copia del archivo parameters.php correctamente configurado en un lugar seguro (no en el servidor). Te será muy útil si necesitas restaurar tu tienda rápidamente.

Preguntas Frecuentes (FAQ)

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

No. Si cambias la contraseña en tu panel de control (cPanel, Syspanel, etc.), debes actualizarla también en el archivo parameters.php. Si no lo haces, tu tienda perderá la conexión.

¿Qué hago si mi hosting usa un puerto específico para MySQL?

A veces el host no es localhost, sino una IP con un puerto (ej: 127.0.0.1:3307). En el parameters.php, hay una línea llamada 'database_port'. Si tu hosting te da un puerto diferente al estándar (3306), debes añadirlo o modificarlo aquí.

¿Es lo mismo "prestashop conectar mysql" que "configurar base de datos prestashop"?

Sí, son prácticamente lo mismo. Conectar MySQL es el proceso técnico, y configurar la base de datos es la acción de rellenar los parámetros en el archivo de configuración. Ambos términos se refieren a establecer la comunicación entre PrestaShop y el servidor de bases de datos.

Si mi tienda da error, ¿puedo perder todos mis datos?

No necesariamente. Un error de conexión no borra tus datos de la base de datos; solo impide que PrestaShop los lea. Una vez que arregles la conexión (los datos en parameters.php), tu tienda volverá a la normalidad con todos tus productos y pedidos intactos.

¿Qué es exactamente Syspanel?

Syspanel es el nombre que recibe el panel de control de alojamiento (anteriormente conocido como HestiaCP) que usamos para gestionar tus dominios, bases de datos y archivos. Recuerda que su acceso se realiza a través del puerto 2106 (ej: https://tu-servidor:2106).

Resumen Final

Conectar una base de datos MySQL a PrestaShop no tiene por qué ser un dolor de cabeza. Solo necesitas:

Tener claras tus credenciales (host, usuario, contraseña y nombre de la BD).
Saber dónde introducirlas (durante la instalación o en el archivo app/config/parameters.php).
Ser meticuloso al editar el archivo PHP para evitar errores de sintaxis.
Conocer las soluciones a los errores comunes, como la falta de permisos o un host incorrecto.

Con esta guía, ya tienes el conocimiento para resolver los problemas de conexión más habituales. Si aun así sigues atascado, no dudes en contactar con el soporte técnico de tu hosting, proporcionándoles el mensaje de error exacto que ves en tu pantalla. ¡Buena suerte con tu tienda!