Configurar settings.inc.php en PrestaShop | Tutorial

¿Qué es el archivo settings.inc.php de PrestaShop y por qué es tan importante?

El archivo settings.inc.php es, sin lugar a dudas, uno de los archivos más críticos de tu tienda PrestaShop. Este archivo actúa como el "cerebro" de la conexión entre tu tienda online y su base de datos MySQL. Sin él, tu tienda simplemente no podría funcionar, ya que contiene las credenciales necesarias para que el sistema se comunique con el servidor de base de datos.

Cuando instalas PrestaShop por primera vez, el instalador genera automáticamente este archivo con los datos de configuración de tu servidor. Sin embargo, hay situaciones en las que necesitas configurarlo manualmente: al migrar tu tienda a un nuevo hosting, al cambiar las credenciales de tu base de datos, o cuando aparece el temido error de conexión.

En esta guía completa, aprenderás a configurar manualmente el archivo settings.inc.php de PrestaShop, a solucionar errores comunes de conexión y a hacerlo de forma segura, incluso si no eres un experto técnico. Te prometo que al final serás capaz de hacerlo sin miedo.

Ubicación del archivo settings.inc.php en PrestaShop

Antes de empezar a modificar nada, necesitas saber dónde encontrar este archivo. La ruta exacta depende de la versión de PrestaShop que estés utilizando:

En PrestaShop 1.6 y versiones anteriores

El archivo se encuentra en la carpeta raíz de tu instalación:

/config/settings.inc.php

En PrestaShop 1.7 y versiones posteriores

A partir de la versión 1.7, PrestaShop cambió la estructura y el archivo ahora se llama parameters.php:

/app/config/parameters.php

Nota importante: Aunque en versiones modernas el archivo se llama diferente, muchos tutoriales y soporte técnico siguen refiriéndose a él como settings.inc.php. En esta guía, te explicaré cómo configurar ambos, pero me centraré principalmente en el formato clásico que encontrarás en la mayoría de servidores de hosting.

Estructura básica del archivo settings.inc.php

Cuando abras el archivo settings.inc.php con un editor de texto (como Notepad++, Sublime Text o incluso el Bloc de notas), encontrarás algo similar a esto:

<?php
define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_basededatos');
define('_DB_USER_', 'tu_usuario');
define('_DB_PASSWD_', 'tu_contraseña');
define('_DB_PREFIX_', 'ps_');
define('_MYSQL_ENGINE_', 'InnoDB');
define('_PS_CACHING_SYSTEM_', 'CacheMemcache');
define('_PS_CACHE_ENABLED_', '0');
define('_COOKIE_KEY_', 'aquí_un_código_largo_y_aleatorio');
define('_COOKIE_IV_', 'aquí_otro_código');
define('_PS_CREATION_DATE_', '2023-01-15');
define('_RIJNDAEL_KEY_', 'clave_de_encriptación');
define('_RIJNDAEL_IV_', 'vector_de_inicialización');
define('_PS_VERSION_', '1.6.1.24');

Desglose de cada parámetro

Vamos a analizar cada línea para que sepas exactamente qué estás modificando:

Parámetro	Descripción	Ejemplo
`_DB_SERVER_`	Dirección del servidor de base de datos	localhost o mysql.tudominio.com
`_DB_NAME_`	Nombre de la base de datos	tienda_prestashop
`_DB_USER_`	Usuario con acceso a la BD	admin_tienda
`_DB_PASSWD_`	Contraseña del usuario	ContraseñaSegura123
`_DB_PREFIX_`	Prefijo de las tablas	ps_ (por defecto)
`_PS_VERSION_`	Versión de PrestaShop	1.6.1.24

Cómo configurar settings.inc.php manualmente paso a paso

Paso 1: Haz una copia de seguridad

[WARNING] Antes de tocar NADA, haz una copia de seguridad del archivo original. Un error al modificar este archivo puede dejar tu tienda inaccesible.

Accede a tu hosting mediante FTP o al administrador de archivos del panel de control.
Descarga el archivo settings.inc.php a tu ordenador.
Guarda una copia con otro nombre, por ejemplo: settings.inc.php.bak.

Paso 2: Identifica los datos de tu base de datos

Para configurar correctamente el archivo, necesitas tener a mano estos datos:

Servidor MySQL (normalmente localhost en la mayoría de hostings compartidos)
Nombre de la base de datos
Usuario de la base de datos
Contraseña del usuario

Si no tienes estos datos, puedes encontrarlos en:

El panel de control de tu hosting (cPanel, Plesk, etc.)
La información de bienvenida de tu proveedor de hosting
Si usas Syspanel (el panel de control recomendado), accede por el puerto 2106 y busca la sección de bases de datos.

Paso 3: Edita el archivo con cuidado

Abre el archivo con un editor de texto y modifica únicamente las líneas necesarias:

define('_DB_SERVER_', 'localhost');  // Cambia si tu BD está en otro servidor
define('_DB_NAME_', 'mi_tienda');    // Nombre exacto de tu BD
define('_DB_USER_', 'usuario_bd');   // Usuario con permisos
define('_DB_PASSWD_', 'MiClave123'); // Contraseña entre comillas simples

Paso 4: Guarda y sube el archivo

Una vez modificado:

Guarda el archivo con codificación UTF-8 sin BOM (esto es importante).
Sube el archivo a tu servidor mediante FTP, reemplazando el original.
Verifica que los permisos del archivo sean 644 (lectura y escritura para el propietario, lectura para el resto).

Errores comunes de conexión y cómo solucionarlos

Error: "Link to database cannot be established"

Este es, probablemente, el error más común. Aparece cuando PrestaShop no puede conectar con la base de datos. Las causas más frecuentes son:

Credenciales incorrectas: Verifica que el usuario y la contraseña sean exactamente los que configuraste en tu hosting.
Base de datos no existe: Asegúrate de que la base de datos haya sido creada.
Servidor MySQL incorrecto: Algunos hostings usan servidores dedicados como mysql.tudominio.com en lugar de localhost.

[TIP] Si estás usando Syspanel, revisa que el puerto de acceso sea el 2106 y que la base de datos esté activa.

Error: "Table 'ps_shop' doesn't exist"

Este error indica que el prefijo de las tablas no coincide con el que se usó al instalar. Si cambiaste el prefijo durante la instalación (por ejemplo, a shop_), debes actualizarlo en el archivo.

Error: "Access denied for user"

El usuario de la base de datos no tiene permisos suficientes. En tu panel de control de hosting:

Asegúrate de que el usuario esté vinculado a la base de datos.
Verifica que tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.).

Configuración avanzada: optimización y caché

Activar la caché para mejorar el rendimiento

Dentro del archivo, puedes configurar el sistema de caché:

define('_PS_CACHE_ENABLED_', '1');
define('_PS_CACHING_SYSTEM_', 'CacheMemcache');

[INFO] La caché acelera tu tienda, pero activarla sin tener el servidor adecuado puede causar problemas. Si no sabes qué es Memcached, déjalo en 0.

Configurar el motor de almacenamiento MySQL

Puedes elegir entre InnoDB y MyISAM:

define('_MYSQL_ENGINE_', 'InnoDB');

InnoDB es más seguro y recomendado para tiendas, ya que soporta transacciones y bloqueos a nivel de fila.

Cómo configurar PrestaShop manualmente en diferentes escenarios

Escenario 1: Migración a un nuevo hosting

Si estás moviendo tu tienda a otro servidor:

Exporta tu base de datos desde el hosting antiguo (phpMyAdmin o similar).
Crea una nueva base de datos en el hosting nuevo.
Importa el archivo SQL.
Modifica settings.inc.php con los nuevos datos de conexión.
Actualiza también las URLs en la tabla ps_shop_url de la base de datos.

Escenario 2: Cambio de contraseña de la base de datos

Si cambiaste la contraseña de tu BD por seguridad:

Edita el archivo settings.inc.php.
Reemplaza el valor de _DB_PASSWD_ con la nueva contraseña.
Guarda y sube el archivo.

Escenario 3: Restaurar una tienda desde una copia de seguridad

Al restaurar:

Sube todos los archivos de tu copia de seguridad.
Importa la base de datos.
Verifica que settings.inc.php tenga las credenciales correctas para el hosting actual.

Herramientas útiles para editar el archivo

Editores de texto recomendados

Notepad++ (Windows): Gratuito y perfecto para editar archivos PHP.
Sublime Text (Multiplataforma): Muy ligero y con resaltado de sintaxis.
Visual Studio Code (Multiplataforma): Potente y gratuito.

[WARNING] No uses el Bloc de notas de Windows para editar archivos PHP, ya que puede añadir caracteres invisibles que rompan el código.

Conectarse por FTP

Necesitarás un cliente FTP como:

FileZilla (gratuito y muy popular)
Cyberduck (para Mac)
El administrador de archivos de tu hosting (si usas Syspanel, entra por el puerto 2106)

Preguntas frecuentes sobre settings.inc.php PrestaShop

¿Qué pasa si elimino el archivo settings.inc.php?

Tu tienda dejará de funcionar inmediatamente. PrestaShop no podrá conectarse a la base de datos y mostrará un error de conexión.

¿Puedo usar la misma configuración para varias tiendas?

No, cada instalación de PrestaShop necesita su propio archivo con credenciales únicas.

¿Con qué frecuencia debo cambiar las contraseñas en este archivo?

Se recomienda cambiar las contraseñas de la base de datos cada 3-6 meses por seguridad. Cada vez que lo hagas, recuerda actualizar el archivo.

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

Contacta con tu proveedor de hosting.
Si usas Syspanel (puerto 2106), puedes restablecer la contraseña desde el panel.
En cPanel, busca la sección "Bases de datos MySQL" para cambiar la contraseña.

¿El archivo settings.inc.php afecta al SEO de mi tienda?

No directamente, pero si está mal configurado, tu tienda no cargará y eso sí afecta negativamente al SEO. Un error de conexión prolongado puede hacer que Google elimine tu sitio de los resultados de búsqueda.

Consejos de seguridad para tu settings.inc.php

Protege el archivo con permisos adecuados

Configura los permisos del archivo a 644 o incluso 444 después de la configuración. Esto evita que otros usuarios del servidor puedan leer tus credenciales.

No compartas tus credenciales

Nunca publiques capturas de pantalla o compartas el contenido del archivo en foros públicos. Contiene información sensible de tu base de datos.

Utiliza contraseñas fuertes

Asegúrate de que la contraseña de tu base de datos sea compleja, con mayúsculas, minúsculas, números y símbolos.

Solución de problemas avanzados

La tienda sigue sin funcionar después de configurar

Si has seguido todos los pasos y aún tienes problemas:

Verifica los logs de error de tu servidor (en cPanel o Syspanel).
Comprueba que PHP esté configurado correctamente (versión compatible con tu PrestaShop).
Revisa que el archivo no tenga errores de sintaxis (espacios o caracteres extra).
Asegúrate de que el archivo tenga la extensión .php y no .txt o similar.

Error de memoria o rendimiento

Si tu tienda es grande, considera aumentar el límite de memoria en el archivo:

ini_set('memory_limit', '256M');

Compatibilidad con versiones de PHP

PrestaShop 1.6 requiere PHP 5.6-7.1, mientras que PrestaShop 1.7 necesita PHP 7.1+. Verifica que tu hosting tenga la versión correcta.

Conclusión y recomendaciones finales

Configurar el archivo settings.inc.php de PrestaShop puede parecer intimidante al principio, pero con esta guía y un poco de paciencia, podrás hacerlo sin problemas. Recuerda siempre:

Haz copias de seguridad antes de cualquier modificación.
Modifica solo lo necesario y no cambies parámetros que no entiendas.
Verifica los permisos del archivo después de subirlo.
Prueba tu tienda después de cada cambio.

Si necesitas ayuda adicional, tu proveedor de hosting (especialmente si usas Syspanel con acceso por el puerto 2106) suele tener documentación y soporte técnico para resolver dudas específicas.

[TIP] Guarda una copia del archivo configurado en un lugar seguro, como un gestor de contraseñas o almacenamiento en la nube cifrado. Te será muy útil si necesitas restaurar tu tienda en el futuro.

Esta guía cubre los aspectos más importantes para configurar settings.inc.php PrestaShop, solucionar errores de conexión y mantener tu tienda funcionando correctamente. Con práctica, esta tarea se convertirá en algo rutinario y podrás gestionar tu tienda con total confianza.