Error 'settings.inc.php' en PrestaShop: Solución en Plesk

¿Qué significa el error "PrestaShop no encuentra el archivo settings.inc.php"?

Si estás leyendo esto, es muy probable que hayas visto un mensaje de error similar a este al intentar abrir tu tienda online: "PrestaShop no encuentra el archivo settings.inc.php" o "Cannot find settings.inc.php".

Este es uno de los errores más comunes y, a la vez, más temidos por los usuarios de PrestaShop. Pero no te preocupes, porque en la mayoría de los casos tiene una solución sencilla que puedes aplicar tú mismo sin necesidad de ser un experto en programación.

El archivo settings.inc.php es el corazón de la configuración de tu tienda PrestaShop. Contiene los datos de acceso a la base de datos, la URL de tu tienda, el prefijo de las tablas y otras configuraciones críticas. Sin este archivo, PrestaShop simplemente no puede arrancar.

En este artículo, te explicaré paso a paso y en un lenguaje muy claro cómo solucionar este error específicamente cuando tu tienda está alojada en un panel de control Plesk. Vamos a ello.

¿Por qué se produce este error en Plesk?

Antes de lanzarnos a la solución, es importante entender por qué ocurre este problema. Conocer la causa te ayudará a prevenirlo en el futuro.

Las razones más habituales son:

Actualización fallida de PrestaShop: Durante una actualización, el sistema necesita regenerar o modificar el archivo settings.inc.php. Si el proceso se interrumpe (por ejemplo, por un corte de conexión o un tiempo de espera agotado), el archivo puede quedar dañado o eliminarse.
Cambios en los permisos de archivos: Si los permisos (CHMOD) de la carpeta config son incorrectos, el servidor no puede leer el archivo y muestra este error.
Migración o copia de seguridad incompleta: Tras mover tu tienda a un nuevo servidor o restaurar una copia de seguridad, es posible que el archivo no se haya copiado correctamente.
Borrado accidental: A veces, al limpiar archivos temporales o al usar un cliente FTP, se borra sin querer el archivo.
Problemas con el panel de Plesk: En ocasiones, el sistema de archivos virtuales de Plesk puede tener conflictos con la estructura de directorios de PrestaShop, especialmente si usas el administrador de archivos integrado.

Preparación antes de empezar a solucionar el error

IMPORTANTE: Antes de tocar nada, haz una copia de seguridad completa de tu tienda, tanto de los archivos como de la base de datos. Si algo sale mal, podrás restaurar todo sin perder información.

Desde Plesk, puedes hacer una copia de seguridad fácilmente:

Inicia sesión en tu panel de Plesk.
Ve a la sección "Archivos" o "Administrador de archivos".
Selecciona la carpeta raíz de tu tienda PrestaShop (normalmente httpdocs o public_html).
Comprime la carpeta en un archivo ZIP y descárgalo a tu ordenador.
También exporta la base de datos desde la sección "Bases de datos MySQL" en Plesk.

Con la copia de seguridad lista, ya puedes empezar a trabajar con tranquilidad.

Método 1: Restaurar el archivo desde una copia de seguridad (el más rápido)

Si tienes una copia de seguridad reciente de tu tienda, esta es la solución más sencilla.

Paso 1: Localiza el archivo en tu copia de seguridad

Dentro del archivo ZIP que descargaste, busca la ruta: config/settings.inc.php. Si la encuentras, genial. Si no la encuentras, prueba con el método 2.

Paso 2: Sube el archivo a tu servidor

Accede a Plesk y ve a "Administrador de archivos".
Navega hasta la carpeta config de tu PrestaShop (por ejemplo, httpdocs/config/).
Haz clic en "Subir archivo" y selecciona el archivo settings.inc.php que extrajiste de tu copia de seguridad.
Asegúrate de que el archivo se haya subido correctamente y que el nombre sea exactamente settings.inc.php.

Paso 3: Verifica los permisos

El archivo debe tener permisos de lectura para el servidor. Normalmente, los permisos correctos son 644 (lectura y escritura para el propietario, lectura para el grupo y para otros).

En el Administrador de archivos de Plesk, puedes hacer clic derecho sobre el archivo y seleccionar "Permisos" o "CHMOD" para ajustarlos.

Paso 4: Prueba tu tienda

Abre tu tienda en el navegador. Si el error era solo por la falta de este archivo, tu tienda debería cargar correctamente.

[TIP] Si después de subir el archivo el error persiste, es posible que el archivo esté dañado. Prueba con el siguiente método.

Método 2: Regenerar el archivo settings.inc.php desde cero

Si no tienes una copia de seguridad o el archivo está dañado, puedes crearlo manualmente. Esto es más técnico, pero te lo explicaré de forma sencilla.

Paso 1: Reúne los datos de tu base de datos

Necesitarás los siguientes datos:

Nombre de la base de datos.
Usuario de la base de datos.
Contraseña del usuario.
Dirección del servidor de base de datos (normalmente localhost).

Puedes encontrar estos datos en Plesk:

Ve a la sección "Bases de datos MySQL".
Localiza la base de datos asociada a tu PrestaShop.
Anota el nombre de la base de datos y el usuario. Si no recuerdas la contraseña, puedes cambiarla desde ahí mismo (hazlo con cuidado).

Paso 2: Crea el archivo settings.inc.php

Ahora, crea un archivo de texto en tu ordenador con el siguiente contenido, reemplazando los datos entre corchetes por los tuyos:

<?php

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'TU_NOMBRE_DE_BASE_DE_DATOS');
define('_DB_USER_', 'TU_USUARIO_DE_BASE_DE_DATOS');
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_', 'TU_CLAVE_UNICA');
define('_COOKIE_IV_', 'TU_CLAVE_IV');
define('_PS_CREATION_DATE_', '2023-01-01');
define('_PS_VERSION_', '1.7.8.0');

?>

Explicación de cada campo:

_DB_SERVER_: normalmente es localhost, pero en algunos servidores puede ser una IP o un nombre de host. Revisa los datos de tu base de datos en Plesk.
_DB_NAME_, _DB_USER_, _DB_PASSWD_: los datos de tu base de datos.
_DB_PREFIX_: es el prefijo de las tablas. Si no lo has cambiado, suele ser ps_.
_COOKIE_KEY_ y _COOKIE_IV_: son claves de seguridad. Puedes generar una clave aleatoria en sitios como random.org. Necesitas una cadena de 56 caracteres para _COOKIE_KEY_ y 32 para _COOKIE_IV_.
_PS_VERSION_: la versión de tu PrestaShop. Si no la sabes, puedes poner una versión genérica como 1.7.8.0 e intentar acceder al panel de administración.

[WARNING] Este archivo debe guardarse con codificación UTF-8 y sin BOM. Si no sabes lo que es, simplemente usa el Bloc de notas de Windows y al guardar selecciona "UTF-8" en la codificación.

Paso 3: Sube el archivo a tu servidor

En Plesk, ve al Administrador de archivos.
Navega a la carpeta config de tu PrestaShop.
Sube el archivo que acabas de crear con el nombre settings.inc.php.

Paso 4: Ajusta los permisos

Asegúrate de que el archivo tenga permisos 644.

Paso 5: Prueba tu tienda

Intenta acceder a tu tienda. Si aparece otro error, puede que necesites ajustar los datos de la base de datos o las claves de seguridad.

[TIP] Si no sabes qué versión de PrestaShop tienes, prueba a acceder a tu panel de administración (por ejemplo, tutienda.com/admin123). Si el panel abre, podrás ver la versión en la esquina inferior derecha.

Método 3: Verificar y corregir permisos de la carpeta config

A veces, el error no es que el archivo no exista, sino que el servidor no puede leerlo por permisos incorrectos.

Paso 1: Accede al Administrador de archivos de Plesk

Paso 2: Navega a la carpeta config

Paso 3: Verifica los permisos de la carpeta y del archivo

La carpeta config debe tener permisos 755.
El archivo settings.inc.php debe tener permisos 644.

Si los permisos son diferentes, cámbialos:

Haz clic derecho sobre la carpeta o archivo.
Selecciona "Permisos".
Introduce los valores correctos y guarda.

Paso 4: Prueba de nuevo

[INFO] En Plesk, el usuario del sistema puede ser diferente al de otros paneles como cPanel. Si los permisos no se guardan correctamente, contacta con tu proveedor de hosting para que te ayuden a ajustarlos a nivel de servidor.

Método 4: Solucionar el error después de una migración o cambio de dominio

Si has movido tu tienda a un nuevo servidor o has cambiado de dominio, el problema puede estar en que la URL guardada en la base de datos no coincide con la actual.

Paso 1: Accede a tu base de datos desde Plesk

En Plesk, ve a "Bases de datos MySQL".
Haz clic en "phpMyAdmin" junto a la base de datos de tu tienda.

Paso 2: Busca la tabla de configuración

Localiza la tabla ps_configuration (si tu prefijo es ps_).

Paso 3: Actualiza las URLs

Ejecuta la siguiente consulta SQL, reemplazando tudominionuevo.com por tu dominio actual:

UPDATE ps_configuration SET value = 'http://tudominionuevo.com' WHERE name IN ('PS_SHOP_DOMAIN', 'PS_SHOP_DOMAIN_SSL');

Paso 4: Verifica el archivo settings.inc.php

Asegúrate de que en el archivo settings.inc.php también esté la URL correcta si aparece alguna (aunque normalmente no se define ahí).

Paso 5: Limpia la caché

Desde el Administrador de archivos, elimina los archivos de la carpeta var/cache (en PrestaShop 1.7) o cache (en versiones anteriores). Esto forzará a PrestaShop a regenerar la caché.

Método 5: Si nada funciona: reinstalar PrestaShop conservando los datos

Este es el último recurso. Si ninguno de los métodos anteriores funciona, puedes reinstalar PrestaShop sin perder tus productos, clientes y pedidos.

Paso 1: Haz una copia de seguridad completa (otra vez)

Paso 2: Descarga una copia de PrestaShop

Ve al sitio oficial de PrestaShop y descarga la misma versión que tenías instalada (o la más reciente compatible con tu PHP).

Paso 3: Sube los archivos de PrestaShop

Descomprime el archivo descargado en tu ordenador.
Sube todos los archivos a tu servidor mediante el Administrador de archivos de Plesk, sobrescribiendo los existentes (pero sin borrar la carpeta config ni img).

[WARNING] Este paso es delicado. Asegúrate de no sobrescribir la carpeta config con la nueva, ya que perderías tu configuración personalizada.

Paso 4: Ejecuta el instalador

Accede a tudominio.com/install. Sigue los pasos del instalador y, cuando te pida los datos de la base de datos, introduce los que ya tenías. El instalador debería detectar que ya existen tablas y te preguntará si quieres actualizarlas.

Paso 5: Elimina la carpeta install

Una vez terminada la instalación, borra la carpeta install del servidor por seguridad.

Preguntas frecuentes (FAQ)

¿Qué pasa si no tengo acceso a Plesk?

Si no tienes acceso al panel de control, deberás contactar con tu proveedor de hosting. Ellos podrán restaurar el archivo desde una copia de seguridad o darte acceso temporal.

¿Puedo evitar este error en el futuro?

Sí, te recomiendo:

Hacer copias de seguridad periódicas.
No interrumpir nunca un proceso de actualización.
Usar un cliente FTP (como FileZilla) en lugar del administrador de archivos de Plesk para tareas críticas.
Mantener tu PrestaShop siempre actualizado.

¿Este error afecta a mi posicionamiento SEO?

Sí, mientras tu tienda esté caída, los motores de búsqueda no podrán indexar tus páginas. Esto puede afectar a tu posicionamiento, sobre todo si el error se prolonga varios días. Por eso es importante solucionarlo lo antes posible.

[INFO] Si tu tienda está caída durante mucho tiempo, puedes usar la herramienta Google Search Console para solicitar una reindexación una vez que esté operativa.

Conclusión

El error "settings.inc.php" es uno de los más temidos por los usuarios de PrestaShop, pero como has visto, tiene solución. Ya sea restaurando el archivo desde una copia de seguridad, creándolo manualmente o ajustando los permisos, en la mayoría de los casos podrás recuperar tu tienda sin necesidad de un técnico.

Recuerda siempre trabajar con una copia de seguridad a mano y, si te sientes perdido, no dudes en contactar con tu proveedor de hosting. Ellos tienen acceso a herramientas internas que pueden facilitarte la tarea.

Espero que esta guía te haya sido de gran ayuda. Si tienes alguna duda, déjala en los comentarios y estaré encantado de ayudarte. ¡Tu tienda online volverá a estar en marcha en poco tiempo!