Configurar settings.inc.php en PrestaShop: Guía para Syspanel

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

Si alguna vez has navegado por los archivos de tu tienda PrestaShop a través del panel de control de tu hosting, es muy probable que hayas visto un archivo llamado settings.inc.php. Aunque su nombre suene técnico, entender su función es clave para que tu tienda funcione correctamente, especialmente si necesitas moverla de servidor, cambiar la base de datos o simplemente asegurarte de que todo esté bien configurado.

El archivo settings.inc.php es, ni más ni menos, el corazón de la configuración técnica de PrestaShop. Contiene los datos de conexión a tu base de datos MySQL, la URL de tu tienda, el prefijo de las tablas y otras constantes críticas. Si este archivo falla o se corrompe, tu tienda mostrará errores de conexión a la base de datos o, directamente, una página en blanco.

En este artículo, te voy a guiar paso a paso para que aprendas a configurarlo, editarlo y solucionar los problemas más comunes. No necesitas ser un experto en programación, solo seguir estas instrucciones al pie de la letra. Además, hablaremos de cómo hacerlo desde el Syspanel, el panel de control que encontrarás en tu hosting, y que en este caso accederás a través del puerto 2106.

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

Antes de empezar a editarlo, necesitas saber dónde está ubicado. En una instalación típica de PrestaShop, el archivo settings.inc.php se encuentra en la carpeta config/ de la raíz de tu tienda.

Por ejemplo, si tu tienda está en public_html/mitienda, la ruta completa sería:

public_html/mitienda/config/settings.inc.php

En ocasiones, dependiendo de la versión de PrestaShop (especialmente en versiones modernas como 1.7 o 8.x), este archivo puede tener un nombre ligeramente diferente, como parameters.php. Sin embargo, el clásico settings.inc.php sigue siendo fundamental en versiones antiguas como PrestaShop 1.6 y anteriores. En este artículo nos centraremos en este archivo, que es el que se usa en el contexto de Syspanel.

¿Qué contiene un archivo settings.inc.php típico?

Para que te hagas una idea, este archivo es un script PHP que define constantes con la función define(). Estas constantes son las que PrestaShop utiliza para conectarse a la base de datos y conocer su entorno.

Estas son las líneas más comunes que encontrarás:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_de_tu_base_de_datos');
define('_DB_USER_', 'usuario_de_tu_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_', 'una_cadena_aleatoria_de_seguridad');
define('_COOKIE_IV_', 'otra_cadena_aleatoria');
define('_PS_CREATION_DATE_', '2023-01-01');

Cada una de estas líneas tiene una función específica:

_DB_SERVER_: La dirección del servidor de base de datos. Normalmente es localhost, pero si usas un hosting externo, puede ser una IP o un dominio.
_DB_NAME_: El nombre exacto de tu base de datos MySQL.
_DB_USER_ y _DB_PASSWD_: Las credenciales de acceso a esa base de datos.
_DB_PREFIX_: El prefijo que se añade a las tablas de PrestaShop (por ejemplo, ps_products). Esto es útil si tienes varias tiendas en la misma base de datos.
_COOKIE_KEY_ y _COOKIE_IV_: Claves de seguridad para cifrar las cookies y datos de sesión de tus clientes. Son cadenas aleatorias que no deberías compartir.

Cómo configurar settings.inc.php desde el Syspanel

El Syspanel es el panel de control que te ofrece tu proveedor de hosting para gestionar tus sitios web. A diferencia de cPanel o Plesk, este es específico y, para acceder a él, deberás hacerlo a través del puerto 2106. Por ejemplo, si tu dominio es mipagina.com, la URL de acceso sería https://mipagina.com:2106.

Dentro del Syspanel, podrás gestionar tus archivos mediante un administrador de archivos, crear bases de datos MySQL, gestionar usuarios y mucho más. Aquí te explico el proceso completo:

Paso 1: Accede a tu Syspanel

Abre tu navegador y escribe la dirección de tu servidor con el puerto 2106. Introduce tus credenciales de acceso (usuario y contraseña) y entra.

Paso 2: Localiza el administrador de archivos

Una vez dentro, busca la opción "Administrador de archivos" o "Gestor de archivos". Suele ser un icono parecido a una carpeta. Haz clic en él.

Paso 3: Navega a la carpeta de tu tienda

En el administrador de archivos, navega hasta la ruta donde tienes instalado PrestaShop. Si es la raíz de tu dominio, probablemente sea public_html o www. Si tu tienda está en una subcarpeta, entra en ella.

Paso 4: Encuentra y edita el archivo

Dentro de la carpeta principal, entra en la carpeta config. Verás el archivo settings.inc.php. Haz clic derecho sobre él y selecciona "Editar" o "Edit". Se abrirá un editor de texto en línea.

Paso 5: Modifica los valores necesarios

Ahora llega el momento de modificar los valores. Los cambios más comunes son:

Cambiar la contraseña de la base de datos: Si has restablecido tu contraseña en MySQL, deberás actualizar la línea _DB_PASSWD_.
Cambiar el nombre de la base de datos: Si has creado una nueva base de datos y has importado tus datos, actualiza _DB_NAME_.
Cambiar el servidor de la base de datos: Si tu hosting te ha dado un servidor MySQL distinto (por ejemplo, mysql.mipagina.com), modifica _DB_SERVER_.

Un ejemplo de cómo quedaría después de la modificación:

define('_DB_SERVER_', 'mysql.midominio.com');
define('_DB_NAME_', 'tienda_datos');
define('_DB_USER_', 'usuario_tienda');
define('_DB_PASSWD_', 'NuevaContraseñaSegura123');

Paso 6: Guarda los cambios

Después de hacer tus modificaciones, guarda el archivo con el botón "Guardar" o "Save". Asegúrate de que no haya errores de sintaxis, como comillas mal cerradas o puntos y comas faltantes.

Paso 7: Comprueba tu tienda

Ahora ve a tu tienda en el navegador y comprueba que funciona. Si todo está bien, verás la página principal sin errores.

Errores comunes y cómo solucionarlos

A veces, una mala configuración de settings.inc.php puede dar lugar a errores desconcertantes. Aquí tienes los más habituales y sus soluciones:

Error: "Link to database cannot be established"

Este es el error más famoso. Significa que PrestaShop no puede conectarse a la base de datos. Las causas más comunes son:

Datos incorrectos: Revisa _DB_SERVER_, _DB_USER_ y _DB_PASSWD_. Un simple error tipográfico en la contraseña puede provocar este fallo.
El servidor MySQL no está disponible: Comprueba en tu Syspanel que el servicio MySQL está activo.
La base de datos no existe: Verifica que el nombre en _DB_NAME_ coincide exactamente con el nombre de la base de datos que creaste en el Syspanel.

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

Este error indica que el prefijo de las tablas es incorrecto o que la base de datos está vacía. Si has importado una copia de seguridad, asegúrate de que el prefijo (_DB_PREFIX_) coincide con el de tu base de datos antigua. Si no, cambia el valor a ps_ o el que uses.

Página en blanco (Error 500)

Esto puede deberse a un error de sintaxis en el archivo. Al editarlo, puedes haber borrado una comilla o una coma sin querer. Vuelve a abrir el archivo y revisa cada línea. Si tienes una copia de seguridad, restáurala.

[WARNING]: Antes de modificar cualquier archivo de configuración, es obligatorio que hagas una copia de seguridad del archivo original. Puedes descargarlo a tu ordenador o copiar su contenido en un bloc de notas. Así, si algo sale mal, podrás restaurarlo fácilmente.

Consejos avanzados para configurar PrestaShop

Además de los valores básicos, hay otros trucos que puedes aplicar en el settings.inc.php para optimizar tu tienda.

Activar o desactivar la caché

Si tu tienda es lenta, puedes activar la caché de PrestaShop modificando estas líneas:

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

Esto mejorará el rendimiento, pero ten cuidado: si no tienes configurado un sistema de caché (como Memcached o Redis) en tu servidor, podría dar errores. Si no estás seguro, déjalo en '0'.

Cambiar el prefijo de la base de datos

Si quieres cambiar el prefijo de las tablas por seguridad (por ejemplo, de ps_ a mi_tienda_), puedes hacerlo aquí. Pero ojo, esto solo funcionará si previamente has renombrado todas las tablas en tu base de datos. No es un cambio trivial.

[INFO]: Si tu tienda es muy grande, cambiar el prefijo puede ser una tarea larga y arriesgada. Te recomiendo que lo hagas solo si tienes experiencia o con la ayuda de un desarrollador.

Asegurar el archivo settings.inc.php

Por razones de seguridad, es fundamental que este archivo no sea accesible desde el navegador. PrestaShop suele incluir una línea para impedirlo, pero por si acaso, puedes añadir al principio del archivo:

if (isset($_GET['file'])) {
    die('Acceso denegado');
}

O simplemente asegurarte de que los permisos del archivo sean 644 (lectura y escritura para el propietario, y solo lectura para el grupo y otros). Puedes cambiar los permisos desde el Syspanel con el botón de "Permisos" o "Chmod".

Preguntas frecuentes (FAQ)

Para finalizar, voy a resolver algunas dudas que suelen tener los usuarios al configurar este archivo.

¿Puedo editar settings.inc.php desde el sitio web de mi hosting o solo desde Syspanel?

Puedes editarlo desde cualquier administrador de archivos de tu hosting. Sin embargo, en este artículo nos hemos centrado en el Syspanel porque es la herramienta que muchos hosts ofrecen. Recuerda que el acceso a este panel es a través del puerto 2106.

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

En versiones modernas de PrestaShop (1.7+), este archivo fue reemplazado por parameters.php, que se encuentra en app/config/. La lógica es la misma, pero los nombres de las constantes cambian ligeramente. Si tu tienda es nueva, busca parameters.php.

¿Necesito reiniciar el servidor después de editar el archivo?

No, no es necesario. Los cambios en PHP se aplican al instante, ya que el archivo se ejecuta en cada petición. Solo tendrás que recargar la página de tu tienda.

¿Cómo puedo saber cuál es el puerto de acceso al Syspanel?

El puerto estándar para el acceso a Syspanel es el 2106. La URL de acceso suele ser https://tu-dominio.com:2106 o https://tu-ip:2106. Si no funciona, consulta la documentación de tu proveedor de hosting.

¿Es seguro compartir el contenido de mi settings.inc.php con soporte técnico?

Nunca compartas las claves de seguridad (_COOKIE_KEY_, _COOKIE_IV_) ni las contraseñas de la base de datos en foros públicos. Si necesitas ayuda, comparte solo la parte que no sea sensible o usa un servicio de intercambio de texto temporal y seguro.

Resumen y recomendaciones finales

Configurar el archivo settings.inc.php es una tarea que, aunque parezca complicada, es bastante sencilla si se siguen los pasos adecuados. Lo más importante es:

Hacer siempre una copia de seguridad antes de editarlo.
Revisar dos veces los datos de conexión a la base de datos.
Usar el Syspanel (puerto 2106) para gestionar los archivos de manera segura.

Si sigues esta guía, podrás resolver la mayoría de los problemas de conexión y configuración de tu PrestaShop sin necesidad de contratar a un técnico. Y recuerda, si algo sale mal, siempre puedes volver a subir la copia de seguridad y empezar de nuevo.

[TIP]: Si no te sientes cómodo editando archivos a mano, puedes usar la herramienta de "Instalación de PrestaShop" en la raíz de tu tienda (por ejemplo, tu-tienda.com/install). En el paso de configuración de la base de datos, podrás introducir los nuevos datos y PrestaShop generará el archivo por ti automáticamente.

Espero que este artículo te haya sido de gran ayuda. Si tienes más dudas, no dudes en contactar con el soporte técnico de tu hosting. ¡Buena suerte con tu tienda!