Configurar settings.inc.php en Plesk para PrestaShop

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

El archivo settings.inc.php es, sin lugar a dudas, el corazón técnico de tu tienda PrestaShop. Se trata de un archivo de configuración que almacena información crítica para que tu tienda funcione correctamente, como los datos de acceso a la base de datos, la URL de tu tienda, la clave secreta de cifrado y el prefijo de las tablas en la base de datos. Sin este archivo, PrestaShop es incapaz de conectarse a su base de datos y, por tanto, tu tienda no cargará.

Piensa en settings.inc.php como el "cerebro" que le dice a PrestaShop dónde encontrar sus datos y cómo conectarse a ellos. Si este archivo se corrompe, se elimina o tiene errores, verás mensajes de error como "Error de conexión con la base de datos" o una pantalla en blanco. Por eso, saber cómo configurarlo y solucionar problemas relacionados es una habilidad esencial para cualquier administrador de una tienda online.

Este archivo se encuentra en la raíz de tu instalación de PrestaShop, generalmente en la carpeta config. La ruta completa suele ser public_html/config/settings.inc.php si instalaste PrestaShop en la raíz de tu dominio, o public_html/tu-tienda/config/settings.inc.php si lo instalaste en una subcarpeta. En un entorno de hosting como Plesk, el acceso a este archivo se realiza a través del Administrador de archivos, que te permite editarlo de forma segura desde el panel de control.

¿Por qué necesito configurar settings.inc.php en Plesk?

Configurar este archivo es necesario en varias situaciones comunes. La más habitual es cuando trasladas tu tienda a un nuevo servidor o cambias de proveedor de hosting. Al mover tu tienda, la base de datos y sus credenciales cambian, y el archivo settings.inc.php debe actualizarse con los nuevos datos para que la conexión funcione. Otra situación frecuente es cuando cambias la contraseña de tu base de datos desde Plesk, ya que el archivo seguirá intentando conectarse con la contraseña antigua.

También puede ser necesario configurarlo si estás configurando una tienda desde cero en un servidor Plesk y deseas asegurarte de que la conexión a la base de datos se realiza correctamente. Incluso si tu tienda funciona bien, es útil saber cómo acceder y editar este archivo para realizar tareas de mantenimiento o resolver errores de base de datos. El error "settings.inc.php prestashop" es una de las búsquedas más frecuentes en foros de soporte, y la mayoría de las veces la solución pasa por revisar y corregir este archivo.

Antes de empezar: requisitos previos y precauciones

Antes de lanzarte a editar el archivo, necesitas tener a mano una serie de datos y tomar algunas precauciones importantes para no dañar tu tienda.

Datos que necesitas recopilar

Para configurar settings.inc.php correctamente, necesitarás los siguientes datos de tu base de datos MySQL:

Nombre de la base de datos: Lo puedes encontrar en Plesk, en la sección "Bases de datos". Suele tener un prefijo como usuario_nombrebd.
Nombre de usuario de la base de datos: También en la sección "Bases de datos" de Plesk. A menudo es el mismo que el nombre de usuario del sistema.
Contraseña de la base de datos: La que estableciste al crear la base de datos.
Prefijo de las tablas: Este es un valor que se define durante la instalación de PrestaShop. Por defecto suele ser ps_, pero puede ser personalizado. Si no lo recuerdas, puedes revisar la base de datos en Plesk (usando phpMyAdmin) y mirar el nombre de una tabla. Por ejemplo, si ves una tabla llamada ps_orders, el prefijo es ps_.
Servidor de la base de datos: Normalmente es localhost, pero en algunos servidores puede ser una dirección IP o un nombre de host específico. En Plesk, casi siempre es localhost, pero es bueno verificarlo.

Realiza una copia de seguridad

Este es el paso más importante. Nunca edites settings.inc.php sin tener una copia de seguridad. Si cometes un error, tu tienda dejará de funcionar y una copia de seguridad te permitirá restaurar el archivo original rápidamente. Puedes hacer una copia de seguridad de todo el sitio, pero como mínimo, descarga el archivo settings.inc.php a tu ordenador. En Plesk, puedes hacerlo desde el Administrador de archivos seleccionando el archivo y haciendo clic en "Descargar".

[WARNING]
No edites el archivo directamente en el editor de texto en línea de Plesk sin antes descargar una copia de seguridad. Un simple error tipográfico, como una comilla mal puesta, puede provocar un error fatal en tu tienda.

Paso a paso: Cómo acceder y editar settings.inc.php en Plesk

Ahora que tienes los datos y la copia de seguridad, vamos a ver el proceso de edición. Es más sencillo de lo que parece.

Paso 1: Accede al Administrador de archivos en Plesk

Inicia sesión en tu panel de control de Plesk. En el menú lateral izquierdo, busca la sección "Sitios web y dominios" y haz clic en ella. A continuación, verás una lista de tus dominios. Busca el dominio donde está instalada tu tienda PrestaShop y haz clic en el icono de "Administrador de archivos" (suele ser un icono de carpeta con una lupa o una flecha). Esto abrirá una interfaz similar a un explorador de archivos.

Paso 2: Navega hasta la carpeta de configuración

Dentro del Administrador de archivos, navega hasta la carpeta donde está instalado PrestaShop. Si tu tienda está en la raíz del dominio, verás una carpeta llamada config. Si está en una subcarpeta, como tienda, primero entra en esa carpeta y luego busca la carpeta config. Recuerda que la ruta completa suele ser public_html/config/settings.inc.php o public_html/tu-tienda/config/settings.inc.php.

Paso 3: Abre el archivo en el editor

Una vez dentro de la carpeta config, busca el archivo settings.inc.php. Haz clic derecho sobre él y selecciona la opción "Editar en el editor de texto". Plesk abrirá el archivo en un editor de código en línea, mostrando el contenido del archivo en texto plano. Verás una serie de líneas de código PHP, con definiciones de constantes que empiezan con define('...', '...');.

Paso 4: Edita las líneas clave

El archivo contiene varias líneas que debes revisar y modificar. Las más importantes son las siguientes:

define('_DB_SERVER_', 'localhost');: Esta línea define el servidor de la base de datos. Normalmente es localhost. Cámbiala solo si tu proveedor de hosting te ha indicado otro valor.
define('_DB_NAME_', 'nombre_base_datos');: Aquí debes poner el nombre exacto de tu base de datos. Por ejemplo: define('_DB_NAME_', 'mi_usuario_mi_tienda');.
define('_DB_USER_', 'usuario_base_datos');: El nombre de usuario de la base de datos. Ejemplo: define('_DB_USER_', 'mi_usuario');.
define('_DB_PASSWD_', 'tu_contraseña');: La contraseña de la base de datos. Es muy importante que esté entre comillas simples.
define('_DB_PREFIX_', 'ps_');: El prefijo de las tablas. Si no lo sabes, déjalo como está y verifica si tu tienda funciona. Si la tienda no funciona y ves un error de base de datos, este valor podría ser incorrecto.

[TIP]
Al editar las líneas, asegúrate de que cada valor esté entre comillas simples y que no haya espacios adicionales. Por ejemplo, define('_DB_NAME_', 'mi_base_datos'); es correcto, pero define('_DB_NAME_', ' mi_base_datos '); no lo es.

Paso 5: Guarda los cambios

Una vez que hayas editado las líneas necesarias, haz clic en el botón "Guardar" en la parte superior del editor. Plesk guardará los cambios en el archivo. Después de guardar, es recomendable que limpies la caché de PrestaShop. Puedes hacerlo desde el panel de administración de tu tienda, en "Parámetros avanzados" > "Rendimiento" y haciendo clic en "Vaciar la caché". Si no puedes acceder al panel de administración, simplemente borra el contenido de la carpeta var/cache en la raíz de tu instalación de PrestaShop (o cache en versiones antiguas).

Solución de problemas comunes: el error de base de datos

Si después de configurar el archivo sigues viendo errores, no te preocupes. Es un proceso de prueba y error. Aquí tienes los problemas más comunes y sus soluciones.

Error 1: "Error de conexión con la base de datos" o "PrestaShop could not connect to the database"

Este es el error más común y suele deberse a datos incorrectos en las líneas _DB_SERVER_, _DB_NAME_, _DB_USER_ o _DB_PASSWD_. Revisa que los hayas copiado correctamente desde Plesk. A veces, los nombres de usuario y base de datos tienen un prefijo con el nombre de tu cuenta de hosting, así que asegúrate de haber copiado el nombre completo.

Error 2: "Tabla no encontrada" o "Table 'ps_orders' doesn't exist"

Este error indica que el prefijo de las tablas es incorrecto. Revisa el valor de _DB_PREFIX_. Si no lo recuerdas, entra en phpMyAdmin desde Plesk, selecciona tu base de datos y mira el nombre de una tabla. Si las tablas se llaman ps_orders, ps_customers, etc., el prefijo es ps_. Si ves tablas con otro prefijo, como miprefijo_orders, deberás cambiarlo en el archivo.

Error 3: Pantalla en blanco (Error 500)

Una pantalla en blanco generalmente indica un error de sintaxis en el archivo. Esto puede ocurrir si al editar se ha introducido un carácter extra o se ha eliminado una comilla o un punto y coma. Compara el archivo que has editado con la copia de seguridad para detectar diferencias. Si el problema persiste, restaura la copia de seguridad e intenta la edición de nuevo, con más cuidado.

Error 4: "Access denied for user 'usuario'@'localhost'"

Este error significa que el usuario de la base de datos no tiene permisos para acceder a la base de datos. En Plesk, ve a la sección "Bases de datos", selecciona tu base de datos y verifica que el usuario que has puesto en _DB_USER_ esté asociado a esa base de datos y tenga todos los permisos. Si no es así, añade el usuario con permisos completos.

[INFO]
Si estás usando un servidor con Syspanel (antes conocido como HestiaCP), recuerda que el puerto de acceso al panel es el 2106. El proceso de edición del archivo es similar, pero la interfaz puede variar ligeramente. Asegúrate de buscar el Administrador de archivos o el editor de archivos en tu Syspanel.

Consejos avanzados para evitar problemas futuros

Configurar settings.inc.php es una tarea puntual, pero hay algunos consejos que te ayudarán a evitar problemas en el futuro.

Mantén un registro de tus credenciales

Guarda en un lugar seguro el nombre de tu base de datos, el usuario y la contraseña. Esto te será útil no solo para configurar PrestaShop, sino para cualquier otra aplicación que necesite acceso a la base de datos. Un gestor de contraseñas es una excelente opción.

No compartas el archivo ni lo hagas público

El archivo settings.inc.php contiene información sensible, como la contraseña de tu base de datos. Nunca lo compartas públicamente, ni lo subas a repositorios públicos de GitHub. Asegúrate de que los permisos del archivo sean correctos (normalmente 644 o 640). En Plesk, puedes cambiar los permisos desde el Administrador de archivos, haciendo clic en "Permisos".

Actualiza la contraseña de la base de datos desde Plesk

Si necesitas cambiar la contraseña de la base de datos, hazlo desde Plesk y luego actualiza el archivo settings.inc.php con la nueva contraseña. Nunca cambies la contraseña directamente en el archivo sin cambiarla también en el servidor de base de datos, o la conexión fallará.

Preguntas frecuentes (FAQ)

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

Si borras el archivo, tu tienda dejará de funcionar por completo. PrestaShop no podrá conectarse a la base de datos. Deberías restaurarlo desde una copia de seguridad. Si no tienes copia, tendrás que reinstalar PrestaShop, lo que podría implicar la pérdida de datos. Por eso es tan importante hacer copias de seguridad.

¿Puedo usar el mismo settings.inc.php para dos tiendas?

No, cada instalación de PrestaShop tiene su propia base de datos y su propio prefijo de tablas. Usar el mismo archivo en dos tiendas causará conflictos y errores. Cada tienda debe tener su propio archivo settings.inc.php configurado con sus propios datos.

¿Cómo puedo saber si mi archivo settings.inc.php es correcto?

La forma más sencilla es comprobar si tu tienda carga correctamente. Si no hay errores de base de datos y la tienda funciona con normalidad, el archivo es correcto. También puedes revisar el archivo y verificar que los valores de las constantes coinciden con los datos de tu base de datos en Plesk.

¿Qué hago si no tengo acceso al Administrador de archivos de Plesk?

Si no tienes acceso al Administrador de archivos, puedes conectarte por FTP (File Transfer Protocol) usando un cliente como FileZilla. Las credenciales FTP suelen estar en la sección "Acceso FTP" de Plesk. Una vez conectado, navega a la carpeta config y descarga el archivo settings.inc.php. Edítalo en tu ordenador con un editor de texto plano (como Notepad++ o Sublime Text) y vuelve a subirlo al servidor.

¿Es seguro editar el archivo directamente en el editor de Plesk?

Sí, es seguro siempre que tengas una copia de seguridad y sigas las instrucciones. El editor de Plesk es un editor de texto plano, similar a cualquier otro, por lo que no causará daños por sí mismo. Los problemas suelen venir de errores humanos al editar.

¿Por qué mi tienda muestra un error después de cambiar la contraseña de la base de datos en Plesk?

Porque el archivo settings.inc.php todavía tiene la contraseña antigua. Debes actualizar la línea _DB_PASSWD_ con la nueva contraseña. Es un paso que se olvida fácilmente, pero es la causa más común de errores de conexión después de cambiar la contraseña.

Conclusión: Domina tu settings.inc.php y mantén tu tienda en línea

Configurar el archivo settings.inc.php en Plesk es una tarea fundamental que, aunque puede parecer técnica, es muy manejable si sigues los pasos adecuados. Hemos visto qué es este archivo, por qué es importante, cómo acceder a él y editarlo en Plesk, y cómo solucionar los errores más comunes. Recuerda siempre hacer una copia de seguridad antes de cualquier cambio y verificar los datos de tu base de datos en Plesk.

Dominar este archivo te dará la confianza para realizar tareas de mantenimiento, trasladar tu tienda de servidor o simplemente solucionar problemas de conexión a la base de datos. Con un poco de práctica, podrás resolver estos problemas rápidamente y mantener tu tienda online funcionando sin contratiempos. Si te has encontrado con el error "settings.inc.php prestashop" o "plesk prestashop config", ahora tienes las herramientas y el conocimiento para solucionarlo. ¡Manos a la obra!