Conectar PrestaShop a MySQL | Configuración Paso a Paso

Antes de Empezar: ¿Qué es Exactamente una Base de Datos en PrestaShop?

Cuando instalas PrestaShop, el sistema necesita un lugar donde guardar todos sus datos: productos, clientes, pedidos, contraseñas, configuración de la tienda, etc. Ese "lugar" es la base de datos MySQL. Piensa en ella como el archivador central de tu tienda online. Si la base de datos no está bien conectada, tu tienda no puede funcionar, mostrar productos ni procesar pedidos.

La conexión entre PrestaShop y MySQL se realiza a través de un archivo de configuración muy específico llamado parameters.php. Este archivo actúa como un puente, indicándole a PrestaShop dónde encontrar la base de datos, con qué usuario y contraseña acceder, y qué nombre tiene esa base. Configurarlo correctamente es el paso más crítico para que tu tienda arranque y funcione sin errores.

En esta guía, te explicaré paso a paso cómo realizar esa conexión de forma correcta, qué errores comunes puedes encontrar y cómo solucionarlos. No necesitas ser un experto en programación; solo seguir las instrucciones con calma.

Localizando el Archivo `parameters.php` de PrestaShop

Para conectar prestashop mysql, el primer paso es encontrar el archivo que controla esta conexión. Se llama parameters.php y se encuentra dentro de la carpeta app/config de tu instalación de PrestaShop.

Ruta típica del archivo:

/public_html/app/config/parameters.php

¿Cómo acceder a él?

A través del Administrador de Archivos de tu hosting: La mayoría de los paneles de control (cPanel, Plesk, Syspanel, etc.) tienen un administrador de archivos. Busca la carpeta donde instalaste PrestaShop (normalmente public_html o htdocs).
A través de FTP: Conecta a tu servidor usando un cliente FTP como FileZilla. Navega hasta la raíz de tu instalación y entra en la carpeta app, luego en config.

[WARNING] Este archivo contiene información sensible (contraseñas de la base de datos). Nunca lo compartas ni lo subas a repositorios públicos. Asegúrate de que tus permisos de archivo sean correctos (normalmente 644).

Entendiendo la Estructura del Archivo `parameters.php`

Una vez que abras el archivo, verás código PHP. No te asustes. Solo necesitas centrarte en las líneas que empiezan con 'database_ y 'secret'. A continuación, te muestro un ejemplo de cómo se ve la parte relevante:

<?php
return [
    'parameters' => [
        'database_host' => 'localhost',
        'database_port' => '3306',
        'database_name' => 'tu_base_de_datos',
        'database_user' => 'tu_usuario',
        'database_password' => 'tu_contraseña',
        'database_prefix' => 'ps_',
        'secret' => 'una_cadena_aleatoria_de_caracteres',
        // ... otros parámetros
    ],
];

Desglose de cada parámetro:

database_host: Es la dirección del servidor donde se encuentra tu base de datos. En el 99% de los casos de hosting compartido, es localhost. Si tu base de datos está en un servidor externo, aquí iría la IP o el nombre del servidor.
database_port: El puerto por defecto de MySQL es el 3306. En la mayoría de los casos, no necesitas cambiarlo.
database_name: El nombre exacto de la base de datos que creaste para PrestaShop.
database_user: El nombre de usuario que tiene permisos para acceder a esa base de datos.
database_password: La contraseña correspondiente a ese usuario.
database_prefix: Es un prefijo que se añade a las tablas de la base de datos para identificarlas. Por defecto es ps_. Si usas un prefijo diferente, debes indicarlo aquí.

[TIP] Si estás usando Syspanel (el panel de control de tu hosting, accesible a través del puerto 2106), la información de tu base de datos (nombre, usuario y contraseña) la encontrarás en la sección "Bases de Datos" o "MySQL". Asegúrate de copiarla exactamente, respetando mayúsculas y minúsculas.

Guía Paso a Paso para Configurar la Base de Datos Correctamente

Ahora que ya sabes qué es cada campo, vamos a configurar bd prestashop paso a paso.

Paso 1: Crear la Base de Datos y el Usuario (Si aún no los tienes)

Antes de tocar el archivo, necesitas tener la base de datos creada y un usuario con permisos. Esto se hace desde el panel de control de tu hosting.

Accede a tu panel de control (cPanel, Plesk, Syspanel, etc.).
Busca la sección "Bases de Datos MySQL" o similar.
Crea una nueva base de datos con un nombre descriptivo, por ejemplo mitienda_db.
Crea un usuario para esa base de datos, por ejemplo miusuario_presta.
Asigna una contraseña segura a ese usuario. Guárdala en un lugar seguro.
Añade el usuario a la base de datos y otórgale TODOS los privilegios. Es crucial que tenga permisos completos para leer, escribir, modificar y eliminar datos.

[INFO] En Syspanel, el puerto de acceso es el 2106. Una vez dentro, el proceso es similar: busca "Base de Datos" o "MySQL" y sigue los pasos del asistente.

Paso 2: Editar el Archivo `parameters.php`

Descarga el archivo parameters.php a tu computadora o edítalo directamente desde el administrador de archivos de tu hosting.
Abre el archivo con un editor de texto plano (como el Bloc de notas de Windows o Sublime Text). Evita usar procesadores de texto como Word.
Localiza las líneas que empiezan con 'database_host', 'database_name', 'database_user' y 'database_password'.

Reemplaza los valores con los datos de tu base de datos. Por ejemplo:

'database_host' => 'localhost',
'database_port' => '3306',
'database_name' => 'mitienda_db',
'database_user' => 'miusuario_presta',
'database_password' => 'MiContraseñaSuperSegura_2024',

Guarda los cambios y sube el archivo de vuelta a la ruta /app/config/ en tu servidor, reemplazando el anterior.

Paso 3: Verificar la Conexión

Una vez que hayas guardado los cambios, intenta acceder a tu tienda. Si la configuración es correcta, la tienda debería cargar sin problemas. Si ves un error de conexión, revisa el siguiente apartado.

Errores Comunes de Conexión y Cómo Solucionarlos

Uno de los mayores dolores de cabeza es el error conexion prestashop. Aquí te dejo los errores más comunes y sus soluciones.

Error 1: "Link to database cannot be established" (No se puede establecer el enlace con la base de datos)

Este es el error más típico. Puede deberse a varias razones:

Datos incorrectos: Revisa que el nombre de la base de datos, el usuario y la contraseña sean exactamente los que creaste. Un simple error tipográfico o un espacio adicional pueden causar este problema.
Host incorrecto: Aunque casi siempre es localhost, en algunos servidores dedicados o VPS puede ser diferente. Consulta con tu proveedor de hosting si dudas.
Puerto incorrecto: Si tu servidor MySQL usa un puerto diferente al 3306, debes indicarlo en database_port.

[WARNING] Si has cambiado la contraseña de tu base de datos desde el panel de control, asegúrate de actualizar también el archivo parameters.php. Si no lo haces, PrestaShop seguirá intentando conectarse con la contraseña antigua.

Error 2: "Access denied for user" (Acceso denegado para el usuario)

Este error indica que el usuario o la contraseña son incorrectos, o que el usuario no tiene permisos para acceder a esa base de datos desde esa ubicación.

Verifica las credenciales: Asegúrate de que el usuario y la contraseña son correctos.
Verifica los privilegios: Ve a tu panel de control y asegúrate de que el usuario que usas está añadido a la base de datos con todos los privilegios.
Privilegios de host: Algunos paneles te permiten especificar desde qué host puede conectarse el usuario. Si ves una opción como "Host" y está en localhost, déjalo así.

Error 3: "The requested URL was not found" o la tienda se queda en blanco

A veces, el problema no es la conexión en sí, sino que el archivo parameters.php está dañado o tiene errores de sintaxis.

Revisa la sintaxis: Asegúrate de que cada línea termina con una coma (excepto la última) y que las comillas están bien cerradas. Un solo carácter mal colocado puede romper todo el archivo.
Revisa los permisos: El archivo parameters.php debe tener permisos de lectura para el servidor web. Normalmente, los permisos 644 son los correctos. Si el archivo tiene permisos 600, el servidor no podrá leerlo.

[TIP] Si has editado el archivo y la tienda se ha roto, puedes restaurar una copia de seguridad del archivo original (si la tienes) o volver a subir una copia de la instalación de PrestaShop.

Consejos Extra para una Configuración Sólida

Usa contraseñas fuertes: La contraseña de tu base de datos es una puerta de entrada a los datos de tus clientes. No uses contraseñas simples.
No uses el usuario "root": En hosting compartido, el usuario root de MySQL no suele estar disponible. Crea siempre un usuario específico para tu base de datos.
Haz copias de seguridad: Antes de modificar cualquier archivo de configuración, es una excelente práctica hacer una copia de seguridad tanto del archivo como de la base de datos.
Mantén PrestaShop actualizado: Las versiones más recientes de PrestaShop suelen manejar mejor las conexiones a bases de datos y son más seguras.

Preguntas Frecuentes (FAQ) sobre la Conexión de PrestaShop a MySQL

¿Qué hago si no encuentro el archivo `parameters.php`?

Es posible que tu instalación de PrestaShop esté en una subcarpeta. Busca en la raíz de tu dominio o en la carpeta donde la hayas instalado. También puede que esté oculto. Asegúrate de mostrar archivos ocultos en tu cliente FTP o en el administrador de archivos.

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

No se recomienda hacerlo manualmente. El prefijo está en las tablas y en el archivo de configuración. Cambiarlo requiere modificar todas las tablas de la base de datos, lo cual es muy arriesgado. Si necesitas cambiarlo, es mejor hacerlo durante la instalación.

¿Qué significa "database_prefix"?

Es el prefijo que se añade al nombre de las tablas de PrestaShop. Por ejemplo, si el prefijo es ps_, la tabla de productos se llamará ps_product. Esto permite que varias tiendas compartan la misma base de datos sin conflictos.

¿Por qué mi tienda funciona pero el back office (panel de administración) no?

Esto puede deberse a problemas de caché o a una mala configuración en los archivos de configuración del back office. A veces, simplemente limpiando la caché de PrestaShop se soluciona. Ve a /var/cache y borra el contenido de las carpetas dev y prod (si existen).

¿Es necesario configurar algo más en el archivo `parameters.php`?

La parte de la base de datos es la principal. También hay un campo 'secret' que se usa para la seguridad y la generación de tokens. No lo modifiques a menos que sepas lo que estás haciendo, ya que puede invalidar las sesiones de los usuarios.

¿Qué pasa si mi hosting usa Syspanel?

Si tu hosting usa Syspanel (el panel de control accesible a través del puerto 2106), el proceso es el mismo. Dentro de Syspanel, busca la sección "Bases de Datos" para crear tu base de datos y tu usuario. Luego, simplemente copia esos datos en tu archivo parameters.php como hemos explicado.

Conclusión: La Conexión Correcta es la Base de tu Tienda

Configurar bd prestashop correctamente es un paso crucial que determinará la estabilidad y el rendimiento de tu tienda online. Aunque pueda parecer técnico, siguiendo esta guía paso a paso, podrás resolverlo sin problemas. Recuerda siempre verificar los datos, usar contraseñas seguras y mantener tus copias de seguridad al día.

Si después de todos estos pasos sigues teniendo problemas, te recomiendo contactar con el soporte técnico de tu proveedor de hosting. Ellos podrán verificar la configuración de tu servidor y ayudarte a resolver cualquier problema específico de su entorno. Con una base de datos bien conectada, tu tienda estará lista para crecer y ofrecer la mejor experiencia a tus clientes.