Configurar settings.inc.php de PrestaShop en Syspanel

¿Tu tienda PrestaShop te da problemas y has oído hablar del archivo settings.inc.php pero no sabes ni por dónde empezar? No te preocupes, has llegado al lugar correcto. Este archivo es, ni más ni menos, el corazón técnico de tu tienda online. Sin él, PrestaShop no puede conectarse a la base de datos y, por tanto, no puede mostrar ni un solo producto.

En esta guía extensa, pensada para usuarios sin experiencia técnica, vamos a desgranar qué es, para qué sirve y cómo configurarlo sin romper nada en el intento. Hablaremos de seguridad, de cómo encontrar el archivo y de qué hacer si te equivocas. Al final, sabrás exactamente qué botones tocar y, lo más importante, cuáles evitar.

Vamos a ello.

¿Qué es exactamente `settings.inc.php`?

Para entenderlo fácilmente, imagina que tu tienda es una casa. El servidor donde vives es el hosting, y la base de datos es el garaje donde guardas todos tus productos, clientes y pedidos.

El archivo settings.inc.php es la llave que conecta la casa con el garaje. Es un archivo de configuración que le dice a PrestaShop: "Oye, la base de datos está en esta dirección, con este usuario y esta contraseña. Conéctate ahí para sacar la información."

Sin esta llave, la puerta está cerrada y tu tienda no funciona. De hecho, si este archivo tiene un error o falta, verás un mensaje de error de conexión a la base de datos en lugar de tu web.

Ubicación del archivo

Este archivo vive en la carpeta config de tu instalación de PrestaShop. La ruta típica es:

/public_html/config/settings.inc.php

Pero ojo, si tienes una instalación más moderna (PrestaShop 1.7 o superior), este archivo puede llamarse parameters.php y estar en /app/config/. Sin embargo, el concepto es el mismo. En esta guía nos centramos en settings.inc.php, que es el clásico para versiones 1.5 y 1.6, aunque el proceso de entenderlo te servirá para cualquier versión.

¿Por qué necesitas configurarlo? (El Syspanel)

La mayoría de las veces, este archivo se configura solo durante la instalación inicial. Pero hay situaciones en las que tendrás que tocarlo manualmente:

Cambiaste de hosting: Te mudaste a un servidor nuevo y las credenciales de la base de datos son diferentes.
Cambiaste la contraseña de la base de datos: Por seguridad, la renovaste y ahora tienes que actualizarla aquí.
Restauraste una copia de seguridad: A veces, al restaurar, los datos de conexión se desactualizan.
Error de "conexión a la base de datos fallida": Este es el síntoma más común de que este archivo tiene datos incorrectos.

¿Y qué tiene que ver el Syspanel en todo esto? Muy fácil. Syspanel es el nombre del panel de control de tu hosting (también conocido como panel de administración del servidor). Si usas un hosting que gestionamos nosotros o uno que tenga este panel, la forma de acceder a la base de datos y a los archivos es a través de él.

[INFO] Para acceder a tu Syspanel, normalmente escribes en tu navegador https://tu-dominio.com:2106. Es importante que recuerdes ese puerto 2106, ya que es la puerta de entrada a todas tus herramientas de gestión.

Una vez dentro del Syspanel, podrás ver tus bases de datos (para crear o modificar usuarios y contraseñas) y también el Administrador de Archivos (para editar el settings.inc.php).

Paso 1: Localizar y abrir el archivo en el Syspanel

Antes de tocar nada, haz una copia de seguridad del archivo original. Esto es crucial. Si algo sale mal, puedes restaurarlo.

Accede a tu Syspanel con tu usuario y contraseña.
Busca la sección "Archivos" o "Administrador de Archivos".
Navega hasta la carpeta donde está tu tienda. Normalmente es public_html o www.
Entra en la carpeta config.
Localiza el archivo settings.inc.php.
Haz clic derecho sobre él y selecciona "Copiar" y luego "Pegar" en la misma carpeta. Se creará una copia llamada settings.inc.php.bak o similar. Eso es tu seguro de vida.

Ahora sí, haz clic derecho sobre el archivo original y selecciona "Editar" o "Edit". Se abrirá un editor de texto en tu navegador.

Paso 2: Entendiendo las líneas clave del archivo

El archivo es un código PHP con variables. No te asustes. Solo nos interesan unas pocas líneas al principio del archivo, las que empiezan con define.

Busca estas líneas:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_base_de_datos');
define('_DB_USER_', 'tu_usuario');
define('_DB_PASSWD_', 'tu_contraseña');
define('_DB_PREFIX_', 'ps_');

Vamos a traducir esto al idioma de andar por casa:

_DB_SERVER_: Es la dirección del servidor de la base de datos. En el 99% de los casos es localhost. Si tu hosting es más complejo, podría ser algo como mysql.tudominio.com. Si no estás seguro, déjalo como localhost; es lo más común.
_DB_NAME_: Aquí va el nombre exacto de tu base de datos. Lo puedes encontrar en tu Syspanel, en la sección de "Bases de Datos" o "MySQL". Es un nombre que suele tener el prefijo de tu usuario de hosting, por ejemplo: usuario123_tienda.
_DB_USER_: Es el usuario que tiene permisos para acceder a esa base de datos. A menudo es el mismo que el nombre de la base de datos, pero no siempre. Debe ser un usuario creado y vinculado a esa base de datos.
_DB_PASSWD_: Es la contraseña de ese usuario de la base de datos. Cuidado con las mayúsculas y minúsculas, y con los caracteres especiales. Aquí es donde la gente suele equivocarse más.
_DB_PREFIX_: Es un prefijo que se añade a las tablas de la base de datos para identificarlas. Por defecto es ps_. No lo cambies a menos que sepas exactamente lo que haces, o tu tienda no encontrará sus tablas y fallará por completo.

Paso 3: Cómo configurar los datos correctamente

Ahora viene la acción. Sigue estos pasos dentro del Syspanel:

Ve a la sección "Bases de Datos" en tu Syspanel. Verás una lista de bases de datos y los usuarios asociados a ellas.
Identifica la base de datos que usa tu tienda. El nombre debe coincidir con lo que ves en el archivo, o si no lo sabes, prueba con la que tenga sentido (la que tenga más tablas).
Comprueba el usuario y la contraseña. Si no la recuerdas, puedes crear una nueva contraseña para ese usuario desde el propio Syspanel. Hazlo y anótala.
Vuelve al editor de archivos donde tienes settings.inc.php abierto.
Reemplaza el contenido de las variables _DB_NAME_, _DB_USER_ y _DB_PASSWD_ con los datos correctos que has visto en el Syspanel.

[WARNING] Al editar, asegúrate de no borrar las comillas simples (' ') que rodean a los valores. Debe quedar así: define('_DB_NAME_', 'mi_base_correcta');. Si borras una comilla, el archivo se romperá.

Guarda los cambios (normalmente con el botón "Guardar" o "Save") y cierra el editor.

Paso 4: Probar la configuración

Ya has editado el archivo. Ahora viene el momento de la verdad.

Abre una pestaña nueva en tu navegador y escribe la URL de tu tienda.
Si todo ha ido bien, verás tu tienda funcionando con normalidad.
Si ves un error de conexión a la base de datos, revisa los pasos anteriores. Lo más probable es que hayas escrito mal la contraseña o el nombre de usuario.

[TIP] Si el error persiste, vuelve a la copia de seguridad que hiciste al principio. Renombra el archivo settings.inc.php.bak a settings.inc.php (borrando el que está mal) y tu tienda volverá al estado anterior (aunque con el error original).

Seguridad: Protege tu `settings.inc.php`

Este archivo contiene las llaves de tu reino. Si alguien malintencionado lo leyera, tendría acceso a tu base de datos y podría robar toda tu información. Por eso, la seguridad es primordial.

Permisos del archivo (CHMOD)

Los permisos determinan quién puede leer, escribir o ejecutar el archivo. Para un archivo de configuración como este, lo recomendable es que sea solo de lectura para el servidor.

[WARNING] Si le das permisos de escritura a todo el mundo (por ejemplo, 777), estás invitando a los hackers a entrar. Nunca hagas eso.

En tu Syspanel, en el Administrador de Archivos, puedes cambiar los permisos. Haz clic derecho sobre settings.inc.php y selecciona "Permisos" o "CHMOD".

El valor recomendado es 644. Esto significa:

El propietario (tú) puede leer y escribir.
Los grupos y otros usuarios solo pueden leer.

Este valor es seguro y suficiente para que PrestaShop funcione.

Acceso denegado por URL

Otra capa de seguridad es evitar que alguien pueda acceder al archivo directamente desde el navegador. Aunque el contenido PHP no se ejecuta, a veces se puede ver el código fuente si el servidor no está bien configurado.

Para evitarlo, puedes añadir una línea de código al inicio del archivo. Ábrelo y, justo después de la primera línea <?php, añade esto:

if (!defined('_PS_VERSION_')) {
    exit;
}

[INFO] Este código es un candado. Le dice al archivo: "Si no estás siendo llamado desde PrestaShop (es decir, si no existe una constante llamada _PS_VERSION_), no hagas nada y sal de aquí." Así, si alguien intenta acceder directamente a settings.inc.php en su navegador, verá una página en blanco en lugar del código fuente.

Preguntas Frecuentes (FAQ)

¿Qué hago si mi tienda da error 500 después de editar el archivo?

Este error suele deberse a un error de sintaxis. Vuelve a abrir el archivo y revisa que todas las líneas terminen con punto y coma (;) y que las comillas estén bien cerradas. Si no lo ves claro, restaura la copia de seguridad.

¿Es lo mismo `settings.inc.php` que `parameters.php`?

No exactamente, pero cumplen la misma función. settings.inc.php se usa en PrestaShop 1.5 y 1.6. parameters.php es el equivalente en PrestaShop 1.7 y 1.8. Si tu tienda es moderna, busca en la carpeta app/config el archivo parameters.php. La lógica es la misma.

¿Puedo cambiar el prefijo de las tablas (`_DB_PREFIX_`) desde aquí?

Técnicamente sí, pero no deberías. El prefijo se define durante la instalación y todas las tablas se crean con él. Si lo cambias aquí, PrestaShop buscará tablas con el nuevo prefijo y no las encontrará, rompiendo tu tienda.

He cambiado la contraseña de la base de datos en el Syspanel, pero la tienda sigue fallando.

Asegúrate de que has guardado los cambios en settings.inc.php después de actualizar la contraseña. A veces, el navegador guarda una versión en caché, así que fuerza la actualización con Ctrl + F5.

¿Necesito reiniciar algo después de guardar?

No. PrestaShop lee este archivo en cada petición. Con guardar los cambios en el Syspanel es suficiente. No hay que reiniciar ningún servicio.

¿Y si no tengo acceso al Syspanel?

Si no tienes acceso al panel de control, deberás usar un cliente FTP como FileZilla para descargar el archivo, editarlo con un editor de texto local (como Notepad++ o Sublime Text) y volver a subirlo. El proceso es el mismo, solo cambia la herramienta.

Conclusión

Configurar el settings.inc.php es una tarea sencilla una vez que entiendes qué es cada cosa. No es magia negra, es simplemente conectar los puntos entre tu tienda y tu base de datos. Con esta guía y la ayuda de tu Syspanel (recuerda, el puerto 2106), podrás resolver los temidos errores de conexión y, de paso, blindar tu tienda contra miradas indiscretas.

Lo más importante es la paciencia y la precaución. Siempre haz una copia de seguridad antes de tocar nada. Y si te pierdes, no dudes en preguntar a tu proveedor de hosting. Ellos están para eso.

Ahora ya sabes cómo funciona la llave de tu tienda. Úsala con sabiduría.

¿Qué es exactamente settings.inc.php?