Configurar settings.inc.php en PrestaShop (DirectAdmin) - Guía rápida

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

Piensa en el archivo settings.inc.php como el cerebro de la configuración técnica de tu tienda PrestaShop. Sin él, tu tienda no puede conectarse a la base de datos, no sabe en qué idioma debe mostrarse ni puede generar las URLs de manera correcta. Es el puente entre el código de PrestaShop y tu servidor.

Cada vez que instalas PrestaShop, este archivo se genera automáticamente en la carpeta config/. Pero hay situaciones donde necesitas editarlo a mano: al mover tu tienda a un nuevo hosting, al cambiar la contraseña de la base de datos, o cuando un error te impide acceder al panel de administración.

En este artículo te voy a enseñar, paso a paso y sin tecnicismos complicados, cómo configurar settings.inc.php en un servidor con panel DirectAdmin. Aunque el proceso suena intimidante, verás que es más sencillo de lo que parece.

Antes de empezar: ¿Qué necesitas tener a mano?

Para configurar el archivo settings.inc.php correctamente, necesitas tener estos datos listos:

Nombre de la base de datos (usualmente algo como usuario_bdprestashop)
Usuario de la base de datos (puede ser igual al nombre o diferente)
Contraseña de la base de datos
Host de la base de datos (normalmente localhost o 127.0.0.1)
Prefijo de las tablas (por defecto es ps_, pero puede ser distinto si lo personalizaste)
Ruta completa donde está instalado PrestaShop (por ejemplo, public_html/mitienda/)

Si no tienes estos datos, no te preocupes: ahora te enseño a encontrarlos en DirectAdmin.

Paso 1: Acceder al panel de DirectAdmin

Lo primero es conectarte a DirectAdmin. Este panel de control es el que te permite gestionar archivos, bases de datos y dominios de tu hosting.

Abre tu navegador y escribe https://tu-dominio.com:2222 o la URL que te haya dado tu proveedor.
Introduce tu usuario y contraseña de hosting.
Una vez dentro, verás el panel principal con todas las opciones.

[INFO] Si tu hosting usa el panel alternativo "Syspanel" (antes conocido como HestiaCP), el acceso se realiza a través del puerto 2106. Por ejemplo: https://tu-dominio.com:2106. El proceso de configuración del archivo es el mismo, solo cambia la interfaz.

Paso 2: Localizar el archivo settings.inc.php

Una vez dentro de DirectAdmin, sigue estos pasos:

Busca el icono "Administrador de Archivos" (File Manager). Suele estar en la sección "Archivos" o "Herramientas".
Haz clic en él. Se abrirá una ventana con los archivos de tu cuenta.
Navega hasta la carpeta donde tienes instalado PrestaShop. Normalmente es public_html/ o public_html/tu-tienda/.
Dentro de esa carpeta, entra en la subcarpeta llamada config/.
Ahí verás el archivo settings.inc.php. Haz clic derecho sobre él y selecciona "Editar" o el icono de lápiz.

[WARNING] No descargues el archivo y lo subas de nuevo a menos que sepas exactamente lo que haces. Editar directamente desde el panel es más seguro porque evitas errores de codificación o de permisos.

Paso 3: Entender las líneas clave del archivo

El archivo settings.inc.php contiene varias líneas con información sensible. Estas son las que nos interesan:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_de_tu_base');
define('_DB_USER_', 'usuario_de_tu_base');
define('_DB_PASSWD_', 'contraseña_secreta');
define('_DB_PREFIX_', 'ps_');
define('_PS_CACHING_SYSTEM_', 'CacheMemcache');
define('_PS_CACHE_ENABLED_', '0');
define('_THEME_NAME_', 'classic');
define('_COOKIE_KEY_', 'cadena_aleatoria_de_caracteres');
define('_COOKIE_IV_', 'otra_cadena_aleatoria');
define('_PS_CREATION_DATE_', '2024-01-15');
define('_RIJNDAEL_KEY_', 'clave_de_encriptacion');
define('_RIJNDAEL_IV_', 'vector_de_encriptacion');

Desglosando cada línea

_DB_SERVER_: La dirección del servidor de base de datos. En el 99% de los casos con DirectAdmin será localhost. Solo cámbialo si tu hosting usa servidores de base de datos remotos.
_DB_NAME_: El nombre exacto de tu base de datos. Es el que creaste en DirectAdmin.
_DB_USER_: El usuario que tiene permisos sobre esa base de datos.
_DB_PASSWD_: La contraseña de ese usuario.
_DB_PREFIX_: El prefijo de las tablas. Si no sabes cuál es, déjalo como ps_ a menos que lo hayas cambiado tú.
_COOKIE_KEY_ y _COOKIE_IV_: Son claves de seguridad para las sesiones. Si las cambias, todos los usuarios serán desconectados. No las modifiques a menos que sea absolutamente necesario.
_RIJNDAEL_KEY_ y _RIJNDAEL_IV_: Claves de encriptación de PrestaShop. Tampoco las toques.

Paso 4: Cómo crear una base de datos en DirectAdmin (si no la tienes)

Si estás configurando PrestaShop desde cero o moviendo tu tienda, necesitas asegurarte de que la base de datos exista. Así se crea:

En el panel de DirectAdmin, busca el icono "MySQL Management" o "Bases de Datos MySQL".
Haz clic en "Crear nueva base de datos".
Escribe un nombre (por ejemplo, mitienda_bd).
Crea un usuario y una contraseña para esa base de datos.
Asigna el usuario a la base de datos con todos los privilegios.

Anota estos datos: los necesitarás para el archivo settings.inc.php.

Paso 5: Editar el archivo con los datos correctos

Ahora viene la parte principal. Vamos a editar las líneas que corresponden a la conexión con la base de datos:

Encuentra la línea define('_DB_SERVER_', 'localhost');. Si tu base de datos está en el mismo servidor, déjalo igual.
Cambia define('_DB_NAME_', 'nombre_de_tu_base'); por tu nombre real. Por ejemplo: define('_DB_NAME_', 'mitienda_bd');
Cambia define('_DB_USER_', 'usuario_de_tu_base'); por tu usuario real.
Cambia define('_DB_PASSWD_', 'contraseña_secreta'); por la contraseña que configuraste.
Si tu prefijo es diferente, ajústalo en _DB_PREFIX_. Por ejemplo, si lo cambiaste a shop_, escribe 'shop_'.

[TIP] Al editar, asegúrate de no dejar espacios en blanco entre las comillas y los valores. Un espacio extra puede causar errores de conexión difíciles de detectar.

Paso 6: Guardar los cambios y verificar permisos

Después de editar, haz clic en "Guardar" o "Save". DirectAdmin te preguntará si quieres mantener los permisos del archivo. Acepta y continúa.

Los permisos del archivo settings.inc.php deben ser 644 (lectura y escritura para el propietario, lectura para el grupo y el resto). DirectAdmin normalmente los mantiene correctos, pero puedes verificar:

Haz clic derecho sobre el archivo en File Manager.
Selecciona "Permisos" o "Change Permissions".
Asegúrate de que marque 644 o rw-r--r--.

[WARNING] No uses permisos 777 (escritura para todos). Es un riesgo de seguridad grave. Si tu hosting lo pide para instalar, cámbialo a 644 después de terminar.

Paso 7: Probar la configuración

Ya has guardado los cambios. Ahora vamos a comprobar que todo funciona:

Abre tu navegador y visita la URL de tu tienda: https://tu-dominio.com.
Si la página carga sin errores, ¡felicidades! La configuración es correcta.
Si ves un mensaje de error de conexión a la base de datos, repasa los pasos anteriores.

Errores comunes y cómo solucionarlos

Error 1: "Link to database cannot be established"

Este es el error más común. Significa que PrestaShop no puede conectarse a tu base de datos. Las causas suelen ser:

Contraseña incorrecta: Revisa que no haya caracteres especiales que se estén escapando mal.
Usuario o base de datos mal escritos: Asegúrate de que coinciden exactamente con lo que ves en DirectAdmin.
Host incorrecto: Si tu hosting usa un host remoto, no uses localhost. Verifica en el correo de bienvenida de tu proveedor.

Error 2: "Table 'ps_xxx' doesn't exist"

Este error significa que el prefijo es incorrecto. Si tu base de datos usa un prefijo distinto (por ejemplo, shop_), cambia _DB_PREFIX_ en consecuencia. Puedes ver los nombres de las tablas desde DirectAdmin en la sección de bases de datos o con phpMyAdmin.

Error 3: Página en blanco después de editar

Si ves una página en blanco, puede ser un error de sintaxis en el archivo. Vuelve a abrir settings.inc.php y asegúrate de que cada línea termina con ; y que no has borrado ninguna comilla o paréntesis.

¿Qué pasa si no puedo acceder al panel de administración?

A veces el problema es que no puedes entrar al back-office de PrestaShop (/admin). Esto suele pasar si el archivo tiene datos incorrectos. Puedes forzar la recuperación:

Renombra el archivo settings.inc.php a settings.inc.php.bak desde File Manager.
Accede a https://tu-dominio.com/install (si aún tienes la carpeta install).
El instalador te pedirá los datos de la base de datos. Introdúcelos.
Al finalizar, se generará un nuevo settings.inc.php.

[WARNING] Esta opción solo funciona si la base de datos existe y tiene las tablas de PrestaShop. Si la base de datos está vacía, el proceso de instalación creará una tienda nueva y podrías perder tus productos.

Consejos de seguridad extra

No compartas este archivo: Contiene claves de encriptación y datos de acceso. Es información sensible.
Haz una copia de seguridad: Antes de editar, descarga una copia del archivo original. Así puedes restaurarlo si algo falla.
Actualiza tus claves después de una brecha: Si sospechas que alguien más ha visto el archivo, cambia _COOKIE_KEY_, _COOKIE_IV_, _RIJNDAEL_KEY_ y _RIJNDAEL_IV_. Puedes generar nuevas claves en sitios como random.org.

Preguntas frecuentes (FAQ)

¿Por qué mi hosting usa "Syspanel" y no DirectAdmin?

Algunos proveedores usan el panel "Syspanel" (anteriormente HestiaCP) en lugar de DirectAdmin. Ambos cumplen la misma función, pero la interfaz es diferente. En Syspanel, el acceso es a través del puerto 2106 y las opciones de base de datos y archivos están en menús laterales.

¿Puedo usar FTP para editar el archivo?

Sí, puedes descargar el archivo con un cliente FTP como FileZilla, editarlo con un editor de texto como Notepad++ y volver a subirlo. Eso sí, asegúrate de que el archivo se suba en modo ASCII y no binario.

¿Qué hago si me aparece un error de memoria?

Si ves un error de memoria al acceder a tu tienda, no es un problema del settings.inc.php sino de la configuración de PHP. En DirectAdmin puedes modificar el límite de memoria desde "PHP Configuration" o editando el archivo .htaccess.

¿Necesito editar este archivo si solo quiero cambiar el idioma de mi tienda?

No. El idioma se cambia desde el panel de administración de PrestaShop. El archivo settings.inc.php solo contiene configuración técnica de bajo nivel.

Resumen final

Configurar el archivo settings.inc.php en PrestaShop con DirectAdmin no es complicado si sabes qué buscar y cómo editar. Recuerda siempre:

Trabaja con una copia de seguridad del archivo.
Edita solo las líneas necesarias (base de datos y prefijo).
Mantén los permisos en 644.
Prueba tu tienda después de cada cambio.

Si sigues estos pasos, tu tienda PrestaShop funcionará sin problemas de conexión y podrás gestionar tu negocio con tranquilidad. Y si tu hosting usa Syspanel en lugar de DirectAdmin, recuerda que el acceso es por el puerto 2106, pero el proceso de edición es prácticamente idéntico.

¿Tienes más dudas? Déjalas en los comentarios y te ayudaré a resolverlas. ¡Buena suerte con tu tienda online!