Configurar el archivo settings.inc.php en DirectAdmin para PrestaShop

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

Si alguna vez has intentado mover tu tienda PrestaShop de un servidor a otro, cambiar de dominio o simplemente has recibido un error de "base de datos no encontrada", seguramente has oído hablar del archivo settings.inc.php. Este pequeño archivo es el corazón de la configuración técnica de tu PrestaShop, ya que contiene las credenciales de acceso a tu base de datos MySQL, la URL de tu tienda y otras opciones críticas de conexión.

En este artículo, nos centramos en cómo configurarlo correctamente dentro de un entorno DirectAdmin PrestaShop, es decir, cuando tu hosting utiliza el panel de control DirectAdmin. Aprenderás paso a paso a editarlo, solucionar errores comunes y protegerlo, incluso si no tienes experiencia técnica avanzada.

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

Antes de tocar nada, es crucial que sepas ubicar el archivo. Dentro de la estructura de carpetas de PrestaShop, la ruta habitual es:

/public_html/config/settings.inc.php

En algunos alojamientos, la carpeta raíz puede llamarse www, htdocs o incluso tienda. La clave es que busques la carpeta config dentro de la raíz donde está instalado PrestaShop. Dentro de esa carpeta, encontrarás el archivo settings.inc.php.

[INFO] En versiones modernas de PrestaShop (1.7 y superiores), este archivo se llama parameters.php y se encuentra en la carpeta app/config. Sin embargo, en la versión 1.6 y anteriores, sigue siendo settings.inc.php. Este artículo se centra en la configuración clásica, pero los principios son aplicables a ambos.

¿Por qué necesitas configurar settings.inc.php en DirectAdmin?

DirectAdmin es un panel de control muy popular en el mundo del hosting compartido y VPS. A diferencia de cPanel, tiene su propia estructura de gestión de bases de datos y usuarios. Cuando instalas PrestaShop manualmente (o migras una tienda existente), es muy probable que necesites ajustar manualmente este archivo para que tu tienda se conecte a la base de datos correcta.

Los errores más comunes que te obligan a tocar este archivo son:

• Error "Link to database cannot be established" al cargar la tienda.
• Migración de un servidor antiguo a un nuevo DirectAdmin.
• Cambio de contraseña de la base de datos desde DirectAdmin.
• Traslado de la tienda a un subdominio o dominio nuevo.

Requisitos previos antes de editar el archivo

Necesitarás tener a mano los siguientes datos, que podrás obtener desde tu panel de DirectAdmin:

1. Nombre de la base de datos (normalmente algo como usuario_bd_nombre).
2. Usuario de la base de datos (similar al nombre, pero puede ser distinto).
3. Contraseña del usuario de la base de datos.
4. Host de la base de datos (habitualmente localhost o 127.0.0.1).

Para obtener esta información en DirectAdmin, ve a la sección "MySQL Management" o "Base de Datos MySQL". Allí verás todas tus bases de datos y los usuarios asociados. Si no la has creado aún, hazlo ahora: crea una base de datos, un usuario y asigna los privilegios completos al usuario sobre esa base.

[WARNING] Nunca uses la contraseña de tu cuenta principal de DirectAdmin para la base de datos. Crea siempre un usuario exclusivo para MySQL con una contraseña robusta.

Paso a paso: Configurar settings.inc.php en DirectAdmin

Ahora que tienes los datos, vamos a la acción. Sigue estos pasos con calma.

Paso 1: Accede a tu gestor de archivos

Desde tu panel de DirectAdmin, busca el icono "File Manager" (Administrador de archivos). Si no lo encuentras, también puedes usar un cliente FTP como FileZilla. La ventaja del gestor de archivos de DirectAdmin es que no necesitas instalar nada extra.

Paso 2: Localiza y descarga el archivo

Navega hasta la carpeta config dentro de tu instalación de PrestaShop. Haz clic derecho sobre settings.inc.php y selecciona "Edit" (Editar). El sistema abrirá un editor de texto en línea. Si prefieres trabajar localmente, puedes descargarlo, editarlo con un editor como Notepad++ y volver a subirlo.

[TIP] Si no ves el archivo, asegúrate de que en el gestor de archivos esté activada la opción de "Mostrar archivos ocultos". Algunos archivos de configuración pueden estar ocultos por defecto.

Paso 3: Identifica las líneas clave del archivo

Dentro del archivo, verás una serie de definiciones de constantes. Las que nos interesan son estas:

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

Paso 4: Modifica los valores

Ahora sustituye los valores de ejemplo por los reales que obtuviste en DirectAdmin:

• _DB_SERVER_: normalmente es localhost. Si tu hosting usa un servidor de bases de datos remoto, DirectAdmin te indicará el host (por ejemplo, mysql.tudominio.com).
• _DB_NAME_: copia exactamente el nombre de tu base de datos (incluye el prefijo con el usuario, por ejemplo usuario_tienda).
• _DB_USER_: el usuario que has creado.
• _DB_PASSWD_: la contraseña de ese usuario.
• _DB_PREFIX_: este es el prefijo de las tablas. Si has instalado PrestaShop desde cero, suele ser ps_. Si estás migrando, respeta el prefijo original, de lo contrario tu tienda no encontrará sus tablas.

Paso 5: Guarda los cambios

Una vez modificados los valores, guarda el archivo. Si estás usando el editor en línea de DirectAdmin, simplemente pulsa el botón de guardar. Si lo has descargado, súbelo de nuevo a la misma ubicación, reemplazando el original.

Paso 6: Verifica tu tienda

Abre tu navegador y visita tu tienda. Deberías ver la página principal sin errores. Si todo ha ido bien, tu PrestaShop se conectará a la base de datos correctamente.

Configurar la URL de tu tienda en settings.inc.php

Además de los datos de la base de datos, este archivo también guarda la URL de tu tienda. Busca las siguientes líneas:

define('__PS_BASE_URI__', '/');
define('_PS_BASE_URL_', 'https://tudominio.com');

Si has movido tu tienda a un subdominio o a una subcarpeta, deberás ajustar estos valores. Por ejemplo, si tu tienda está en https://tudominio.com/tienda, entonces:

define('__PS_BASE_URI__', '/tienda/');
define('_PS_BASE_URL_', 'https://tudominio.com');

[WARNING] Si dejas estos valores incorrectos, tu tienda puede cargar sin estilos CSS, imágenes rotas o redirigir a la antigua URL. Después de editarlos, recuerda limpiar la caché de PrestaShop desde el panel de administración.

Errores comunes y soluciones al configurar settings.inc.php

Error: "Link to database cannot be established"

Este es el error más habitual. Significa que PrestaShop no puede conectarse a la base de datos. Revisa estos puntos:

• ¿El nombre de la base de datos y el usuario son exactamente los que ves en DirectAdmin? A veces hay un prefijo común.
• ¿La contraseña es correcta? Cuidado con mayúsculas, minúsculas y caracteres especiales.
• ¿El host es localhost? Si no, prueba a poner 127.0.0.1.

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

Si ves este error, el prefijo de las tablas (_DB_PREFIX_) no coincide con el que se usó al instalar. Si has migrado una tienda, revisa el nombre de las tablas en tu base de datos (por ejemplo, en phpMyAdmin) y ajusta el prefijo.

La tienda carga, pero sin estilos ni imágenes

Esto suele deberse a una URL mal configurada en _PS_BASE_URL_. Revisa que el dominio y la subcarpeta sean correctos. Además, en PrestaShop 1.6, es recomendable activar el modo amigable de URLs desde el panel de administración.

Buenas prácticas de seguridad para settings.inc.php

Este archivo contiene credenciales sensibles, así que debes protegerlo adecuadamente. Aquí tienes algunas recomendaciones:

• Cambia los permisos del archivo a 644 en DirectAdmin. Esto permite lectura y escritura solo al propietario, y lectura al grupo y otros. Para ello, haz clic derecho sobre el archivo, selecciona "Change Permissions" y marca 644.
• No lo edites nunca mientras la tienda esté en producción si puedes evitarlo. Hazlo en horas de bajo tráfico.
• Haz una copia de seguridad del archivo original antes de modificarlo. Si algo sale mal, podrás restaurarlo.
• No compartas este archivo en foros o con terceros, ya que contiene la clave de acceso a tu base de datos.

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), recuerda que el acceso a la gestión de archivos y bases de datos se realiza a través del puerto 2106. Aunque este artículo se centra en DirectAdmin, muchos conceptos son similares.

¿Necesitas configurar también el archivo .htaccess?

En muchas ocasiones, al mover una tienda PrestaShop, no solo tienes que tocar settings.inc.php, sino también el archivo .htaccess que se encuentra en la raíz. Este archivo contiene reglas de redirección y reescritura de URLs. Si tu tienda funciona pero las URLs amigables no, deberás regenerar el .htaccess desde el panel de administración de PrestaShop (Preferencias > URLs amigables) o eliminarlo para que PrestaShop lo regenere automáticamente.

Migrar tu PrestaShop a DirectAdmin: guía rápida

Si estás migrando una tienda desde otro hosting a DirectAdmin, el proceso resumido sería:

1. Exporta tu base de datos desde el hosting antiguo (phpMyAdmin) en formato .sql.
2. Crea una nueva base de datos y usuario en DirectAdmin.
3. Importa el archivo .sql en la nueva base de datos desde phpMyAdmin de DirectAdmin.
4. Sube todos los archivos de tu tienda (carpeta pública) al nuevo servidor, normalmente a public_html.
5. Edita settings.inc.php con los nuevos datos de conexión.
6. Ajusta la URL en el archivo de configuración.
7. Limpia la caché de PrestaShop y revisa que todo funcione.

Preguntas frecuentes (FAQ)

¿Puedo usar el mismo settings.inc.php en dos dominios diferentes?

No, cada dominio necesita su propia configuración, especialmente la URL base. Además, las credenciales de base de datos son únicas para cada instalación.

¿Qué hago si no tengo acceso al File Manager de DirectAdmin?

Puedes usar FTP. Conecta con tu cliente FTP (FileZilla, por ejemplo) usando el usuario y contraseña de tu cuenta de hosting. La ruta será similar: /public_html/config/settings.inc.php.

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

No exactamente. settings.inc.php es de PrestaShop 1.6 y anteriores. parameters.php es el equivalente en PrestaShop 1.7 y 8.x. La estructura es distinta (formato YAML en algunos casos), pero la función es la misma: conectar la tienda con la base de datos.

¿Por qué mi hosting usa "localhost" y no otro host?

En la mayoría de los hosting compartidos, la base de datos y el servidor web están en el mismo equipo, por lo que se usa localhost. Solo en configuraciones más avanzadas (como bases de datos separadas) se usa un host remoto.

¿Pierdo datos si edito settings.inc.php?

No, solo modificas la configuración. No afecta a tus productos, pedidos o clientes, siempre que la base de datos sea la correcta.

Conclusión final

Configurar el archivo settings.inc.php en un entorno DirectAdmin PrestaShop no tiene por qué ser una pesadilla. Con los pasos que te hemos dado, podrás conectar tu tienda a la base de datos en cuestión de minutos, solucionar errores típicos y asegurar que tu negocio online funcione sin contratiempos.

Recuerda siempre hacer una copia de seguridad antes de modificar cualquier archivo crítico y trabajar con calma. Si tienes dudas, consulta la documentación oficial de PrestaShop o contacta con el soporte de tu hosting. Y si tu proveedor utiliza Syspanel, recuerda que el acceso se realiza por el puerto 2106, pero la lógica de configuración es muy similar.

Ahora que ya sabes cómo hacerlo, ¡manos a la obra y a configurar tu tienda!