Configurar settings.inc.php de PrestaShop en Syspanel (Guía)

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

Si alguna vez has intentado cambiar la configuración de tu tienda online desde el panel de administración de PrestaShop y has visto un error, o si necesitas ajustar parámetros avanzados de conexión a la base de datos, tarde o temprano tendrás que mirar el archivo settings.inc.php. Este archivo es, ni más ni menos, el corazón técnico de tu PrestaShop.

Piénsalo como el "interruptor general" de tu tienda. Contiene los datos de conexión a la base de datos MySQL, las claves secretas de seguridad, la URL principal de tu tienda y otras configuraciones críticas. Si este archivo se corrompe, se borra o se configura mal, tu tienda dejará de funcionar por completo.

Por eso, en este artículo te voy a explicar de forma clara y sencilla cómo configurar el archivo settings.inc.php de PrestaShop en Syspanel, el panel de control de hosting que usamos en nuestros servidores. No necesitas ser un experto en programación, solo seguir los pasos con calma y atención.

¿Qué es Syspanel y por qué usarlo para configurar PrestaShop?

Antes de entrar en materia, aclaremos qué es Syspanel. Syspanel es el nombre que recibe nuestro panel de control de hosting (basado en la tecnología de HestiaCP). Es la herramienta que te permite gestionar tus dominios, bases de datos, cuentas de correo y archivos desde un navegador web.

Para acceder a Syspanel, simplemente abre tu navegador y escribe la dirección de tu servidor seguida del puerto 2106. Por ejemplo: https://tudominio.com:2106. Ahí iniciarás sesión con tu usuario y contraseña de hosting.

A diferencia de otros paneles como cPanel, Syspanel tiene una estructura de carpetas ligeramente diferente, pero es igual de potente y mucho más ligero. Lo bueno es que no necesitas usar comandos SSH ni programas complicados para editar el settings.inc.php. Todo se puede hacer desde el administrador de archivos web o, si eres más clásico, desde un cliente FTP.

Localizar el archivo settings.inc.php dentro de Syspanel

El primer paso es encontrar el archivo. Esto parece obvio, pero te sorprendería saber cuánta gente busca en la carpeta equivocada.

Ruta correcta del archivo

En una instalación estándar de PrestaShop, el archivo settings.inc.php se encuentra en la carpeta config. La ruta completa desde la raíz de tu dominio sería:

/public_html/config/settings.inc.php

O si tienes PrestaShop instalado en una subcarpeta (por ejemplo, una tienda en pruebas), la ruta sería algo así:

/public_html/tienda/config/settings.inc.php

[INFO] En Syspanel, la carpeta raíz de tu sitio web suele llamarse public_html, aunque en algunos servidores puede llamarse web o www. Si no estás seguro, revisa la estructura de carpetas en el administrador de archivos.

Cómo acceder al administrador de archivos

Para llegar hasta ahí, sigue estos pasos:

Inicia sesión en Syspanel usando el puerto 2106.
En el menú lateral izquierdo, busca la sección "Archivos" o "Administrador de archivos".
Haz clic en tu dominio (por ejemplo, tudominio.com).
Se abrirá una vista de árbol de carpetas. Navega hasta config.
Busca el archivo settings.inc.php. Si no lo ves, activa la opción de "mostrar archivos ocultos", ya que a veces los paneles los ocultan por defecto.

Hacer una copia de seguridad antes de editar (¡IMPORTANTE!)

Este es el paso que muchos se saltan y luego lo lamentan. Antes de tocar absolutamente nada, haz una copia de seguridad del archivo original.

¿Por qué? Porque un error tipográfico en la contraseña de la base de datos o una coma mal puesta puede dejar tu tienda caída. Y si no tienes una copia, tendrás que restaurar desde un backup completo del hosting, que puede ser más antiguo.

Para hacer la copia:

En el administrador de archivos de Syspanel, haz clic derecho sobre settings.inc.php.
Selecciona "Copiar".
Pégalo en la misma carpeta con un nombre como settings.inc.php.bak o settings.inc.php.copia.
También puedes descargarlo a tu ordenador por si acaso.

[WARNING] Si tu tienda está funcionando, no la toques a lo loco. Un archivo mal editado puede provocar el famoso error "PrestaShop no puede conectarse a la base de datos" o incluso un pantallazo blanco. La copia de seguridad es tu red de seguridad.

Estructura básica del archivo settings.inc.php

Antes de editar, vamos a entender qué hay dentro. Si abres el archivo con el editor de texto de Syspanel (clic derecho → editar), verás algo como esto:

<?php
define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_basededatos');
define('_DB_USER_', 'tu_usuario_db');
define('_DB_PASSWD_', 'tu_contraseña_db');
define('_DB_PREFIX_', 'ps_');
define('_MYSQL_ENGINE_', 'InnoDB');
define('_PS_CACHING_SYSTEM_', 'CacheMemcache');
define('_PS_CACHE_ENABLED_', '0');
define('_COOKIE_KEY_', 'cadena_larga_de_texto');
define('_COOKIE_IV_', 'otra_cadena');
define('_PS_CREATION_DATE_', '2023-05-01');
define('_PS_VERSION_', '1.6.1.24');

No te asustes. Solo nos interesan unas pocas líneas para la mayoría de las configuraciones típicas.

Las líneas clave que debes conocer

_DB_SERVER_: Es el servidor de la base de datos. Normalmente es localhost, pero en algunos hostings compartidos puede ser un nombre como mysql.tudominio.com o una IP.
_DB_NAME_: El nombre de tu base de datos.
_DB_USER_: El usuario de la base de datos.
_DB_PASSWD_: La contraseña de ese usuario.
_DB_PREFIX_: El prefijo de las tablas. Por defecto es ps_, pero si lo cambiaste por seguridad, aquí debe coincidir.
_COOKIE_KEY_ y _COOKIE_IV_: Son claves de cifrado para sesiones. Si las cambias, los usuarios se desconectarán, pero es útil si sospechas que alguien las ha robado.

Cómo editar el settings.inc.php en Syspanel paso a paso

Vamos al lío. Te voy a guiar para editar el archivo de forma segura.

Paso 1: Abre el archivo en el editor

En el administrador de archivos de Syspanel, localiza settings.inc.php y haz clic derecho. Elige "Editar". Se abrirá un editor de texto plano dentro del navegador.

Paso 2: Realiza los cambios necesarios

Los cambios más comunes son:

Cambiar la contraseña de la base de datos

Si has cambiado la contraseña de tu base de datos desde Syspanel (sección "Bases de datos"), debes actualizar la línea:

define('_DB_PASSWD_', 'tu_nueva_contraseña');

Cambiar el servidor de la base de datos

Si tu proveedor te ha dado un servidor MySQL externo, modifica:

define('_DB_SERVER_', 'nuevo_servidor_mysql');

Cambiar el prefijo de las tablas

Esto es poco común, pero si estás migrando una tienda y las tablas tienen otro prefijo, cámbialo aquí.

Paso 3: Guarda los cambios

Una vez hechos los cambios, haz clic en "Guardar" o "Guardar cambios" en la parte superior del editor.

Paso 4: Verifica que la tienda sigue funcionando

Abre tu tienda en una ventana de incógnito (para evitar caché) y comprueba que carga correctamente. Si sale un error, revisa los pasos anteriores.

[TIP] Si te da miedo romper algo, puedes editar una sola línea, guardar y comprobar. Así, si algo falla, sabrás exactamente qué línea ha causado el problema.

Errores comunes al editar settings.inc.php (y cómo solucionarlos)

Aunque sigas los pasos al pie de la letra, pueden pasar cosas. Aquí tienes los errores más típicos y su solución.

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

Esto significa que los datos de conexión no coinciden. Revisa:

Que el nombre de la base de datos, el usuario y la contraseña sean exactos (respetando mayúsculas y minúsculas).
Que el servidor sea el correcto (localhost o el que te hayan dado).
Que la base de datos no haya sido eliminada por accidente.

Error: "Página en blanco" o "Error 500"

Suele indicar un error de sintaxis en el archivo. Por ejemplo, una comilla sin cerrar o un ; olvidado. Restaura desde la copia de seguridad y vuelve a intentarlo con más cuidado.

Error: "Acceso denegado" al editar el archivo

A veces los permisos del archivo son demasiado restrictivos. En Syspanel, puedes cambiar los permisos (CHMOD) haciendo clic derecho sobre el archivo. Ponlo a 644 para que sea legible pero no modificable por otros usuarios.

[WARNING] No pongas nunca permisos 777 (todos pueden escribir). Es un riesgo de seguridad enorme. Con 644 es suficiente para que PrestaShop funcione y tú puedas editarlo.

Consejos SEO y de rendimiento relacionados con settings.inc.php

Sabías que este archivo también puede afectar al rendimiento y al SEO de tu tienda? Sí, aunque parezca mentira.

Activar la caché (con cuidado)

En las versiones antiguas de PrestaShop, puedes activar la caché desde este archivo. Si ves las líneas:

define('_PS_CACHE_ENABLED_', '0');

Puedes cambiarlas a '1' para activar la caché. Esto mejora la velocidad de carga, lo que Google premia en el posicionamiento.

[INFO] En PrestaShop 1.7 y versiones posteriores, la gestión de caché se hace mejor desde el panel de administración (Parámetros avanzados → Rendimiento). No es recomendable tocar esto a mano si no sabes lo que haces.

La URL canónica y el SEO

El archivo settings.inc.php no define la URL, pero sí que un error en la base de datos puede hacer que tu tienda cargue en una URL incorrecta, lo que arruinaría tu SEO. Si cambias de dominio, deberás actualizar también las tablas ps_shop_url y ps_configuration de la base de datos, no solo este archivo.

Claves de cifrado y seguridad

Las claves _COOKIE_KEY_ y _COOKIE_IV_ son fundamentales para la seguridad de las sesiones. Si sospechas que tu tienda ha sido vulnerada, puedes regenerarlas desde este archivo. Eso sí, ten en cuenta que todos los usuarios serán desconectados y tendrán que volver a iniciar sesión.

Preguntas frecuentes (FAQ) sobre settings.inc.php y Syspanel

¿Puedo editar settings.inc.php desde FTP en lugar de Syspanel?

Sí, perfectamente. Puedes usar cualquier cliente FTP (FileZilla, por ejemplo) para descargar el archivo, editarlo en tu ordenador con un editor de texto (como Notepad++ o Sublime Text) y subirlo de nuevo. Solo asegúrate de no usar el Bloc de notas de Windows sin codificación UTF-8, porque puede corromper el archivo.

¿Qué hago si he perdido el archivo settings.inc.php?

Si has borrado el archivo por accidente, tienes dos opciones:

Restaurar una copia de seguridad del hosting desde Syspanel (sección "Backups").
Regenerar el archivo. PrestaShop tiene un instalador que puede recrearlo, pero es más complejo. Lo más rápido es restaurar desde backup.

¿Cada cuánto debo hacer una copia de este archivo?

Siempre que hagas cambios importantes en tu tienda (cambiar de hosting, cambiar contraseñas, migrar de servidor). No es necesario hacerlo a diario, pero es buena práctica tener una copia reciente.

¿Puedo cambiar el prefijo de las tablas desde este archivo?

Sí, pero no es recomendable. Si cambias el prefijo aquí sin cambiar las tablas en la base de datos, tu tienda no funcionará. Si ya cambiaste las tablas, entonces sí, edita la línea _DB_PREFIX_.

¿Syspanel es lo mismo que HestiaCP?

Syspanel es el nombre comercial de nuestro panel, basado en HestiaCP. La interfaz y las funciones son prácticamente las mismas, pero adaptadas a nuestro servicio. Recuerda que el acceso se hace siempre por el puerto 2106.

Conclusión: no le temas al settings.inc.php

Editar el archivo settings.inc.php puede parecer una tarea de expertos, pero con este tutorial y un poco de paciencia, cualquier persona puede hacerlo desde Syspanel. Solo recuerda las reglas de oro:

Siempre haz una copia de seguridad antes de tocar nada.
Cambia una cosa a la vez y comprueba que todo funciona.
Respeta la sintaxis del archivo: comillas, puntos y comas, y nada de espacios extraños.
Si algo falla, restaura la copia y vuelve a intentarlo.

Con esto, podrás arreglar errores de conexión, cambiar contraseñas de bases de datos, mejorar la seguridad de tu tienda y mantener tu PrestaShop sano y optimizado para el SEO.

Espero que este artículo te haya sido de utilidad. Si tienes más dudas, recuerda que nuestro equipo de soporte está para ayudarte. Pero ahora ya sabes cómo hacerlo tú mismo, que es mucho más rápido.

[TIP] Guarda este artículo en tus favoritos. La próxima vez que necesites editar el settings.inc.php de PrestaShop en Syspanel, ya sabrás exactamente qué hacer.