Solucionar errores de settings.inc.php en PrestaShop | Guía

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

Si alguna vez has visto un error en tu tienda online que menciona settings.inc.php, no estás solo. Este pequeño archivo es el corazón de la configuración de tu PrestaShop. Aunque no lo veas a simple vista, guarda datos esenciales como la conexión a la base de datos, las claves secretas de seguridad y la URL de tu tienda.

Piensa en settings.inc.php como el "cerebro" que le dice a tu tienda cómo conectarse con su base de datos, dónde está alojada y cómo cifrar la información sensible. Sin él, tu PrestaShop simplemente no funcionaría.

En este artículo, te explicaré paso a paso cómo configurarlo correctamente y, sobre todo, cómo solucionar los errores más comunes que aparecen con este archivo. No necesitas ser un experto en programación, solo seguir estas instrucciones con calma.

¿Dónde se encuentra el archivo settings.inc.php?

Antes de tocar nada, es importante que sepas dónde está este archivo. Por defecto, lo encontrarás en la carpeta raíz de tu instalación de PrestaShop:

/config/settings.inc.php

Por ejemplo, si tu tienda está en www.mitienda.com, la ruta completa sería algo así:

/public_html/config/settings.inc.php

[WARNING] Nunca edites este archivo directamente desde el panel de administración de tu hosting si no sabes lo que haces. Un error de sintaxis puede dejar tu tienda completamente inaccesible. Siempre haz una copia de seguridad antes de modificar nada.

Estructura básica del archivo settings.inc.php

Cuando abras el archivo con un editor de texto (como Notepad++ o el editor de archivos de tu hosting), verás algo similar a esto:

<?php
define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_base_datos');
define('_DB_USER_', 'usuario_bd');
define('_DB_PASSWD_', 'contraseña_bd');
define('_DB_PREFIX_', 'ps_');
define('_MYSQL_ENGINE_', 'InnoDB');
define('_PS_CACHING_SYSTEM_', 'CacheMemcache');
define('_PS_CACHE_ENABLED_', '0');
define('_COOKIE_KEY_', 'cadena_larga_aleatoria');
define('_COOKIE_IV_', 'otra_cadena');
define('_PS_CREATION_DATE_', '2024-01-01');
define('_PS_VERSION_', '1.6.1.24');
define('_RIJNDAEL_KEY_', 'clave_para_cifrado');
define('_RIJNDAEL_IV_', 'vector_inicializacion');
?>

Cada línea define una constante que PrestaShop usará en todo momento. Vamos a desglosarlas:

_DB_SERVER_: La dirección del servidor de base de datos. Normalmente es localhost, pero en algunos hostings puede ser un nombre como mysql.midominio.com.
_DB_NAME_: El nombre de tu base de datos.
_DB_USER_: El usuario con permisos para acceder a esa base de datos.
_DB_PASSWD_: La contraseña de ese usuario.
_DB_PREFIX_: El prefijo de las tablas. Por defecto es ps_, pero a veces se cambia por seguridad.
_COOKIE_KEY_ y _COOKIE_IV_: Claves para cifrar las cookies de sesión.
_RIJNDAEL_KEY_ y _RIJNDAEL_IV_: Claves de cifrado para datos sensibles.

[INFO] Si no sabes cuáles son tus datos de base de datos, puedes encontrarlos en el panel de control de tu hosting. Si usas Syspanel (el panel de control que tienes en el puerto 2106), busca la sección "Bases de datos" o "MySQL".

Errores comunes con settings.inc.php y cómo solucionarlos

Ahora vamos a lo importante: los errores. Aquí tienes los más habituales y su solución.

1. Error "Cannot connect to database" o "Error de conexión con la base de datos"

Este es, sin duda, el error más temido. Aparece cuando PrestaShop no puede conectarse a la base de datos. Las causas suelen ser:

Datos incorrectos: El nombre de la base, el usuario o la contraseña no son correctos.
Servidor de base de datos caído: El servidor MySQL está apagado o no responde.
Cambio de hosting: Si has movido tu tienda a otro servidor, es posible que los datos no se hayan actualizado.

Solución paso a paso:

Accede a tu servidor mediante FTP o al administrador de archivos de tu hosting.
Abre el archivo config/settings.inc.php.
Comprueba que _DB_SERVER_, _DB_NAME_, _DB_USER_ y _DB_PASSWD_ coinciden con los datos de tu base de datos actual.
Si no estás seguro, entra en Syspanel (puerto 2106) y revisa la sección de bases de datos. Allí verás el nombre exacto y el usuario.
Si has cambiado de hosting, es muy probable que el servidor de base de datos no sea localhost. Revisa la información que te dio tu nuevo proveedor.

[TIP] Después de editar el archivo, guarda los cambios y prueba a cargar tu tienda. Si el error persiste, verifica que el servidor MySQL esté activo desde tu panel de control.

2. Error de permisos de archivo (500 Internal Server Error)

A veces, al intentar acceder a tu tienda, ves un error 500. Esto suele deberse a que los permisos del archivo settings.inc.php son demasiado permisivos o demasiado restrictivos.

Solución:

Los permisos correctos para este archivo son 644 (lectura y escritura para el propietario, solo lectura para el resto).
Si el archivo tiene permisos 666 o 777, cambia a 644.
Si tiene permisos 444 (solo lectura), cambia a 644 para poder editarlo.

Puedes cambiar los permisos desde el administrador de archivos de tu hosting o usando un cliente FTP como FileZilla. Haz clic derecho sobre el archivo y selecciona "Permisos de archivo".

[WARNING] No subas los permisos a 777 de forma permanente. Es un riesgo de seguridad grave. Úsalo solo temporalmente para editar y luego vuelve a 644.

3. Error "The requested URL / was not found on this server"

Este error aparece cuando PrestaShop no puede encontrar la tienda porque la URL configurada en settings.inc.php no coincide con la real.

Solución:

Abre el archivo settings.inc.php.
Busca la constante _PS_BASE_URL_ (si existe). En versiones antiguas, puede que no esté, pero en PrestaShop 1.6 y superiores suele aparecer.
Comprueba que la URL sea exactamente la de tu tienda, sin barras al final. Por ejemplo: http://www.mitienda.com (sin el / final).
Si tu tienda usa SSL, asegúrate de que la URL comience con https://.

[INFO] Si no encuentras _PS_BASE_URL_, es porque tu versión de PrestaShop usa la tabla ps_configuration de la base de datos. En ese caso, tendrás que entrar en la base de datos con phpMyAdmin y buscar el valor PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL.

4. Error de "clave de cifrado inválida"

Este error es menos común pero muy frustrante. Aparece cuando las claves _COOKIE_KEY_, _COOKIE_IV_, _RIJNDAEL_KEY_ o _RIJNDAEL_IV_ son incorrectas o están vacías.

Solución:

La forma más rápida es regenerar estas claves. Puedes hacerlo de dos maneras:

Opción A: Copia las claves de una instalación limpia de la misma versión de PrestaShop.
Opción B: Usa un generador de claves aleatorias (como el que ofrece el propio PrestaShop en su documentación técnica).

[WARNING] Si cambias estas claves, los usuarios que tengan sesiones iniciadas serán desconectados, y los datos cifrados con las claves antiguas (como contraseñas de clientes) podrían dejar de funcionar. Es una medida de último recurso.

5. Error al mover la tienda a otro servidor

Si has migrado tu tienda a un nuevo hosting, es muy probable que aparezcan errores porque settings.inc.php sigue apuntando a los datos antiguos.

Solución:

Haz una copia de seguridad completa de tu tienda y base de datos.
Sube todos los archivos al nuevo servidor.
Importa la base de datos en el nuevo servidor.
Edita settings.inc.php con los nuevos datos de conexión (servidor, usuario, contraseña, nombre de la base).
Si la URL ha cambiado, actualiza también _PS_BASE_URL_ o los valores en la base de datos.

[TIP] Después de mover la tienda, es recomendable desactivar la caché. Abre config/settings.inc.php y cambia _PS_CACHE_ENABLED_ a '0'. Esto evitará errores extraños mientras terminas de ajustar todo.

Cómo editar settings.inc.php de forma segura

Antes de que te lances a editar, aquí tienes un método seguro que te ahorrará muchos dolores de cabeza:

Haz una copia de seguridad: Descarga el archivo original a tu ordenador.
Usa un editor de texto plano: Nada de Word o editores que añadan formato. Usa Notepad++, Sublime Text o el editor del propio hosting.
Edita solo lo necesario: No cambies líneas que no entiendas. Céntrate en los datos de conexión y URL.
Guarda con codificación UTF-8 sin BOM: Esto es crucial. Si guardas con BOM, PrestaShop puede dar error.
Sube el archivo y prueba tu tienda en un navegador en modo incógnito (para evitar caché).

Preguntas frecuentes (FAQ)

¿Puedo borrar el archivo settings.inc.php?

No, nunca. Si lo eliminas, tu tienda dejará de funcionar por completo. PrestaShop lo necesita para arrancar.

¿Por qué mi hosting me pide permisos 777 para editarlo?

Algunos hostings requieren permisos de escritura temporalmente para que el instalador o los módulos puedan modificar el archivo. Pero nunca lo dejes en 777 después de editar. Vuelve a 644 siempre.

¿Qué pasa si mi PrestaShop es la versión 1.7 o 8?

En PrestaShop 1.7 y versiones posteriores, el archivo settings.inc.php fue reemplazado por parameters.php y parameters.yml, que se encuentran en la carpeta app/config/. Sin embargo, los conceptos son los mismos: conexión a base de datos, claves de cifrado y URL.

Si tu tienda es 1.7 o superior, busca app/config/parameters.php y edita los valores database_host, database_name, database_user, database_password y secret.

[INFO] En Syspanel (puerto 2106), también puedes gestionar las bases de datos y ver los datos de conexión necesarios para ambos tipos de archivo.

¿Cómo sé si mi archivo tiene la sintaxis correcta?

Una forma rápida es abrir el archivo en un editor que resalte la sintaxis PHP. Si ves errores de color o paréntesis sin cerrar, hay un problema. También puedes usar herramientas online de validación de PHP, pero ten cuidado de no subir el archivo con datos sensibles a sitios desconocidos.

Conclusión

El archivo settings.inc.php es el guardián de la configuración de tu PrestaShop. Aunque puede parecer intimidante, con un poco de paciencia y siguiendo estos pasos podrás resolver los errores más comunes sin necesidad de contratar a un desarrollador.

Recuerda siempre:

Haz copias de seguridad antes de tocar nada.
Usa los datos correctos de tu base de datos (disponibles en Syspanel, puerto 2106).
Mantén los permisos en 644.
Prueba después de cada cambio.

Si aun así sigues teniendo problemas, no dudes en contactar con el soporte de tu hosting. Ellos podrán verificar si el problema está en el servidor o en la configuración del archivo.

Espero que este artículo te haya sido de ayuda. ¡Tu tienda online volverá a funcionar en poco tiempo!