Configurar conexión a base de datos en PrestaShop | Guía fácil

¿Tu tienda PrestaShop muestra el temido prestashop base datos error? Respira, no es el fin del mundo. Este es uno de los problemas más comunes al migrar de hosting, cambiar de servidor o al instalar la tienda desde cero. La buena noticia es que la solución suele ser mucho más sencilla de lo que parece: se trata de ajustar correctamente los parámetros de conexión en un archivo de configuración.

En esta guía completa y paso a paso, te voy a enseñar exactamente cómo configurar la conexion base datos prestashop sin necesidad de ser un experto en programación. Vamos a desglosar todo el proceso, desde entender qué archivo debes tocar hasta cómo solucionar los errores más frecuentes. Al final, serás capaz de hacerlo tú mismo en menos de 10 minutos.

¿Qué es el archivo settings.inc.php prestashop?

Para que PrestaShop funcione, necesita "hablar" con tu base de datos MySQL. Ahí es donde se guardan tus productos, clientes, pedidos y contraseñas. Para hacer esa conexión, PrestaShop utiliza un archivo de configuración muy especial llamado settings.inc.php.

Este archivo actúa como un puente entre tu tienda y el servidor de bases de datos. Contiene información crítica como el nombre de la base de datos, el usuario, la contraseña y la dirección del servidor. Si alguno de estos datos es incorrecto, tu tienda no podrá conectarse y verás un error en pantalla.

¿Dónde se encuentra este archivo?

El archivo settings.inc.php se encuentra en la carpeta config de tu instalación de PrestaShop. La ruta exacta suele ser:

/public_html/config/settings.inc.php

Si tu tienda está en un subdirectorio, la ruta cambiará ligeramente. Por ejemplo:

/public_html/mitienda/config/settings.inc.php

Este archivo es el corazón de la conexión. Sin él, PrestaShop no puede funcionar. Por eso es fundamental saber editarlo correctamente.

Parámetros de conexión: Los 4 datos que necesitas

Antes de empezar a editar nada, necesitas tener a mano los datos de acceso a tu base de datos MySQL. Son solo 4 parámetros, pero deben ser exactos. Vamos a verlos:

1. Nombre de la base de datos (database_name)

Es el nombre que le pusiste a tu base de datos cuando la creaste. Normalmente, en los paneles de control como cPanel o Syspanel, el nombre suele llevar un prefijo con el nombre de tu usuario. Por ejemplo: usuario_tienda_db.

2. Usuario de la base de datos (database_user)

Es el usuario que tiene permisos para acceder a esa base de datos. También suele llevar un prefijo. Ejemplo: usuario_tienda_user.

3. Contraseña del usuario (database_password)

La contraseña que asignaste a ese usuario. Es extremadamente importante que no tenga espacios al principio ni al final y que respetes las mayúsculas y minúsculas exactas.

4. Servidor de la base de datos (database_host)

Aquí es donde mucha gente se confunde. Normalmente, en un hosting compartido, este valor es localhost o 127.0.0.1. Sin embargo, si tu base de datos está en un servidor externo (como en algunos planes de hosting gestionado o servidores VPS), la dirección será diferente (por ejemplo, mysql.midominio.com).

[INFO] En la mayoría de los casos con hosting tradicional, el valor correcto es localhost. Si cambiaste de hosting recientemente y no funciona, prueba con 127.0.0.1.

Cómo editar el archivo settings.inc.php paso a paso

Ahora sí, vamos a la acción. Sigue estos pasos al pie de la letra y tendrás tu conexion base datos prestashop funcionando en minutos.

Paso 1: Localiza y descarga el archivo

Accede a tu panel de control de hosting (cPanel, Plesk o Syspanel). Si usas Syspanel, recuerda que el puerto de acceso es el 2106. Una vez dentro, busca el administrador de archivos (File Manager).

Navega hasta la carpeta config de tu instalación de PrestaShop y busca el archivo settings.inc.php. Haz clic derecho sobre él y selecciona Descargar para tener una copia de seguridad en tu ordenador. Este paso es crucial por si algo sale mal.

Paso 2: Edita el archivo con un editor de texto

En el mismo File Manager, haz clic derecho sobre el archivo y selecciona Editar o Edit. Se abrirá un editor de texto. Si te da miedo tocar el código, no te preocupes, solo vamos a modificar 4 líneas.

Paso 3: Modifica los parámetros de conexión

Busca las líneas que comienzan con define('_DB_. Deberías ver algo similar a esto:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_base_de_datos');
define('_DB_USER_', 'tu_usuario');
define('_DB_PASSWD_', 'tu_contraseña');

Ahora, reemplaza los valores entre comillas simples con los datos correctos que obtuviste de tu proveedor de hosting.

En _DB_SERVER_, pon localhost o la dirección del servidor MySQL.
En _DB_NAME_, pon el nombre exacto de tu base de datos.
En _DB_USER_, pon el usuario exacto.
En _DB_PASSWD_, pon la contraseña exacta.

Paso 4: Guarda los cambios

Una vez hayas modificado las 4 líneas, guarda el archivo. En la mayoría de los editores, esto se hace con el botón Guardar cambios o Save Changes.

[WARNING] Asegúrate de no borrar ninguna comilla, punto y coma o paréntesis. Un solo carácter mal colocado romperá la sintaxis del archivo y tu tienda no cargará. Si el editor te lo permite, guarda el archivo en UTF-8 sin BOM.

Paso 5: Prueba tu tienda

Ahora, abre tu tienda en el navegador. Si todo ha ido bien, tu tienda cargará con normalidad. Si todavía ves el prestashop base datos error, no te desesperes. Vamos a ver las soluciones a los problemas más comunes.

Solución de problemas: ¿Por qué sigue fallando?

A veces, aunque los datos sean correctos, el error persiste. Aquí tienes las causas más frecuentes y cómo solucionarlas.

Error 1: El servidor de la base de datos no es `localhost`

En algunos casos, especialmente con hosting que usa servidores MySQL separados, la dirección no es localhost. Si tu proveedor te ha dado una dirección específica (como mysql.tudominio.com), asegúrate de haberla escrito correctamente en _DB_SERVER_.

Prueba a cambiar localhost por 127.0.0.1. A veces, el servidor no resuelve bien el nombre local y necesita la IP directa.

Error 2: Permisos de usuario insuficientes

El usuario de la base de datos debe tener todos los privilegios sobre la base de datos. Si acabas de crear el usuario, es posible que solo tenga permisos parciales. Entra en tu panel de control y verifica que el usuario tiene todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.) sobre la base de datos correcta.

Error 3: El prefijo de las tablas

PrestaShop también guarda un prefijo para las tablas de la base de datos (normalmente ps_). Este parámetro se define en _DB_PREFIX_. Si has importado una base de datos de otro sitio con un prefijo distinto, tendrás que ajustarlo. Asegúrate de que el valor sea exactamente el que usan tus tablas.

Error 4: El archivo tiene permisos incorrectos

El archivo settings.inc.php debe tener permisos de lectura para el servidor web. Normalmente, los permisos correctos son 644. Si el archivo está en 444 (solo lectura) o 600, el servidor podría no leerlo correctamente. Cambia los permisos a 644 desde el File Manager.

[TIP] Si has editado el archivo desde el File Manager y no ves los cambios, intenta limpiar la caché de tu navegador o probar en una ventana de incógnito. A veces, el navegador guarda una versión antigua de la página de error.

Guía rápida: Configurar MySQL en PrestaShop desde Syspanel

Si tu hosting utiliza Syspanel, el proceso para obtener los datos es ligeramente diferente, pero igual de sencillo. Recuerda que el acceso a Syspanel es a través del puerto 2106.

Inicia sesión en Syspanel (ejemplo: https://tudominio.com:2106).
Busca la sección Bases de Datos o MySQL.
Ahí verás listadas todas tus bases de datos. Si no tienes una, créala.
Haz clic en la base de datos que quieres usar. Verás los detalles de conexión, incluyendo el nombre de la base, el usuario y el servidor (que normalmente será localhost).
Usa esos datos para rellenar el archivo settings.inc.php tal y como hemos explicado.

Preguntas frecuentes (FAQ)

¿Puedo cambiar la contraseña de la base de datos sin romper la tienda?

Sí, pero tendrás que actualizar el archivo settings.inc.php inmediatamente después con la nueva contraseña. Si cambias la contraseña en el panel de control y no actualizas el archivo, tu tienda se caerá.

¿Qué hago si no encuentro el archivo settings.inc.php?

Si no existe, puede que tu PrestaShop esté usando una versión más reciente que utiliza un archivo llamado parameters.php en su lugar. En ese caso, el proceso es similar, pero el archivo está en app/config/parameters.php. Los parámetros se llaman database_host, database_name, database_user y database_password.

¿Es seguro editar el archivo manualmente?

Sí, es seguro si sigues las instrucciones. El riesgo principal es equivocarte al escribir los datos. Por eso es tan importante hacer una copia de seguridad antes de empezar. Si algo sale mal, puedes restaurar el archivo original.

¿Por qué veo el error "Error de conexión a la base de datos" al instalar PrestaShop?

Si el error ocurre durante la instalación, significa que los datos que estás introduciendo en el asistente de instalación son incorrectos. Revisa que el usuario tenga permisos para crear tablas y que el servidor sea el correcto.

¿Puedo usar la misma base de datos para dos tiendas PrestaShop?

No es recomendable. Cada instalación de PrestaShop necesita su propia base de datos (o al menos un prefijo de tabla único). Compartir la base de datos entre dos tiendas puede provocar conflictos y pérdida de datos.

Conclusión: Tu tienda lista para despegar

Configurar la conexion base datos prestashop no tiene que ser una pesadilla. Con un poco de paciencia y siguiendo estos pasos, podrás resolver el error de conexión y tener tu tienda online funcionando de nuevo.

Recuerda los puntos clave:

El archivo que debes editar es settings.inc.php (o parameters.php en versiones modernas).
Los 4 datos críticos son: servidor, nombre de la base de datos, usuario y contraseña.
Haz siempre una copia de seguridad antes de editar.
Si usas Syspanel, el acceso es por el puerto 2106.

Espero que esta guía te haya sido de gran ayuda. Si has seguido todos los pasos y aún tienes problemas, es posible que el error esté relacionado con la configuración del servidor o con los permisos de los archivos. En ese caso, no dudes en contactar con el soporte técnico de tu hosting, ya que ellos podrán verificar la configuración del servidor MySQL desde su lado.

¡Ahora sí, a vender!