Configurar settings.inc.php en PrestaShop: Guía para cPanel y Plesk

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

Si alguna vez has tenido que mudar tu tienda PrestaShop de un servidor a otro, o has visto un error de "conexión a la base de datos fallida", seguramente has oído hablar de este archivo. El settings.inc.php es el corazón de la configuración técnica de tu PrestaShop. Es un archivo de texto que contiene las credenciales de acceso a tu base de datos MySQL, la URL de tu tienda y otras variables críticas para el funcionamiento del sistema.

Piénsalo como el "interruptor general" de tu casa: si no está bien configurado, nada funciona. Por eso, saber configurar settings PrestaShop en cPanel o editarlo en otros paneles es una habilidad básica que todo administrador de tienda debería dominar, aunque no sea un experto en programación.

En este artículo, te voy a guiar paso a paso, con un lenguaje claro y sin tecnicismos innecesarios, para que puedas editar este archivo tanto en cPanel como en Plesk sin miedo a romper nada. Al final, también resolveremos las dudas más frecuentes que nos llegan a soporte.

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

Antes de empezar a tocar nada, necesitas saber dónde buscar. La ruta típica es:

/public_html/config/settings.inc.php

En la mayoría de instalaciones, tu tienda está en la carpeta public_html (o www en algunos servidores). Dentro de ella, existe una carpeta llamada config. Ahí es donde vive nuestro archivo.

Consejo rápido: Si tu PrestaShop está instalada en una subcarpeta (por ejemplo, public_html/tienda), la ruta sería public_html/tienda/config/settings.inc.php.

Antes de tocar nada: haz una copia de seguridad

[WARNING] Este es el paso más importante de todo el artículo. Si editas el archivo y cometes un error, tu tienda puede quedar inaccesible. No es un desastre irreversible, pero te hará perder tiempo y paciencia. Por eso, siempre haz una copia de seguridad antes de modificar nada.

Para copiarlo, tienes dos opciones:

Desde el panel de archivos de cPanel o Plesk: Busca el archivo, haz clic derecho y selecciona "Copiar". Pega la copia en la misma carpeta con un nombre como settings.inc.php.bak.
Desde FTP: Conéctate con FileZilla o cualquier cliente FTP, descarga el archivo a tu ordenador y guárdalo en un lugar seguro.

Con la copia hecha, ya puedes trabajar con tranquilidad.

Configurar settings.inc.php en cPanel (paso a paso)

cPanel es uno de los paneles de control más usados en hosting compartido. Si tu proveedor lo usa, sigue estos pasos:

Paso 1: Accede al Administrador de Archivos

Entra a tu cPanel con tu usuario y contraseña (normalmente es tudominio.com/cpanel).
Busca la sección Archivos y haz clic en Administrador de Archivos.
Se abrirá una ventana; elige la opción Documento raíz para el dominio y haz clic en "Ir". Te llevará directamente a public_html.

Paso 2: Navega hasta la carpeta config

Dentro de public_html, busca la carpeta config. Ábrela con doble clic. Verás una lista de archivos; localiza settings.inc.php.

Paso 3: Edita el archivo

Haz clic derecho sobre el archivo y selecciona Editar. El sistema te preguntará si quieres codificar el archivo; elige "Editar" de nuevo (o "Cancelar" si te ofrece opciones raras). Se abrirá un editor de texto en tu navegador.

Paso 4: Identifica las líneas clave

Dentro del archivo, busca estas líneas (pueden variar ligeramente según la versión de PrestaShop):

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_base_de_datos');
define('_DB_USER_', 'tu_usuario_mysql');
define('_DB_PASSWD_', 'tu_contraseña');
define('_DB_PREFIX_', 'ps_');
define('_PS_BASE_URL_', 'https://tudominio.com');

Estas son las que tendrás que modificar si cambias de servidor o de base de datos.

Paso 5: Guarda los cambios

Cuando hayas modificado los valores, haz clic en Guardar cambios en la esquina superior derecha. cPanel te pedirá confirmación; acéptala.

Paso 6: Verifica que todo funciona

Abre tu tienda en el navegador. Si ves la página principal sin errores, ¡enhorabuena! Has configurado correctamente el settings.inc.php PrestaShop en cPanel.

Configurar settings.inc.php en Plesk (paso a paso)

Plesk es otro panel muy popular, sobre todo en servidores VPS y dedicados. El proceso es similar, pero con diferencias en la interfaz.

Paso 1: Accede al Administrador de Archivos de Plesk

Entra a tu panel de Plesk (https://tudominio.com:8443 normalmente).
En el menú lateral, busca Sitios web y dominios.
Haz clic en el dominio de tu tienda y luego en Administrador de archivos (suele ser un icono de carpeta).

Paso 2: Navega hasta la carpeta config

Igual que en cPanel, entra en httpdocs (así se llama la carpeta raíz en Plesk) y después en config. Localiza settings.inc.php.

Paso 3: Edita el archivo

Haz clic en el archivo y luego en el botón Editar en el editor de texto (o "Editar" a secas). Se abrirá un editor en línea.

Paso 4: Modifica los valores

Busca las mismas líneas que mencionamos antes y cámbialas según necesites. Recuerda que si solo estás editando settings.inc.php en Plesk para corregir un error de conexión, solo tendrás que tocar las líneas de la base de datos.

Paso 5: Guarda y comprueba

Haz clic en Guardar y luego en Aceptar si te pide confirmación. Visita tu tienda para comprobar que todo está correcto.

¿Qué significan cada una de las variables?

Para que no te pierdas, aquí tienes un mini-glosario de las variables más importantes:

_DB_SERVER_: Es la dirección del servidor de base de datos. Normalmente es localhost, pero en algunos hostings puede ser algo como mysql.tudominio.com.
_DB_NAME_: El nombre de tu base de datos. Suelo tener prefijos como usuario_basededatos.
_DB_USER_: El usuario con permisos para acceder a esa base de datos.
_DB_PASSWD_: La contraseña de ese usuario. Debe ir entre comillas simples.
_DB_PREFIX_: El prefijo de las tablas. Si tu tienda usa ps_, todas las tablas se llamarán ps_products, ps_orders, etc. No lo cambies a menos que sepas lo que haces.
_PS_BASE_URL_: La URL de tu tienda. Es importante que coincida con el dominio real, incluyendo el protocolo (http o https).

[INFO] Si tu tienda no carga o te da errores raros después de editar, revisa también las líneas _PS_CACHING_SYSTEM_ y _PS_CACHE_ENABLED_. A veces, la caché guarda datos antiguos y da problemas. Puedes poner _PS_CACHE_ENABLED_ en '0' temporalmente para forzar que se regeneren.

Errores comunes y cómo solucionarlos

Error "Link to database cannot be established"

Este es el error más típico. Significa que PrestaShop no puede conectar con MySQL. Las causas más frecuentes son:

Credenciales erróneas: Revisa que el usuario, la contraseña y el nombre de la base de datos sean exactos. Un espacio extra o una coma mal puesta puede romperlo todo.
El servidor de BD no es localhost: Algunos hostings usan servidores externos. Mira la información de tu proveedor.
La base de datos no existe: Si estás migrando, asegúrate de haber importado la base de datos correctamente.

Error "Access denied for user"

Este error indica que el usuario no tiene permisos. En cPanel, ve a Bases de datos MySQL y asegúrate de que el usuario esté añadido a la base de datos con todos los privilegios.

La tienda carga pero sin estilos

Si la tienda carga pero se ve "fea" (sin colores ni CSS), es un problema de URL. Revisa _PS_BASE_URL_ y asegúrate de que no tenga una barra final (/) de más o de menos.

Preguntas frecuentes (FAQ)

¿Puedo editar el archivo con el bloc de notas de Windows?

Sí, pero con cuidado. El bloc de notas puede añadir caracteres invisibles. Mejor usa un editor como Notepad++ o Visual Studio Code. Si usas el panel de archivos de cPanel o Plesk, no tendrás este problema.

¿Qué pasa si dejo el archivo vacío o lo borro?

Si borras o vacías el archivo, tu tienda dejará de funcionar por completo. No lo hagas nunca. Por eso es tan importante la copia de seguridad.

¿Cada cuánto debo revisar este archivo?

Normalmente, solo lo tocas cuando migras de servidor, cambias la base de datos o hay un error. No es algo que debas andar tocando a menudo.

¿Puedo cambiar el prefijo de las tablas?

Técnicamente sí, pero no lo recomiendo. Cambiar el prefijo implica renombrar todas las tablas de la base de datos. Es un trabajo de alto riesgo. Déjalo como está.

¿Qué pasa si mi hosting usa Syspanel en lugar de cPanel o Plesk?

Si tu proveedor usa Syspanel (antes conocido como HestiaCP), el proceso es muy parecido. Accede a tu panel a través del puerto 2106 (por ejemplo, https://tudominio.com:2106), navega hasta el administrador de archivos y sigue los mismos pasos que en Plesk. La estructura de carpetas es similar (public_html o web).

¿Necesito conocimientos de programación para hacer esto?

No. Solo necesitas saber copiar y pegar, y entender qué significan las variables. Si sigues los pasos de esta guía, no tendrás ningún problema.

Consejos finales para no meter la pata

Trabaja siempre con calma. No tengas prisa. Un error de dedo puede costarte un buen rato.
Prueba en un entorno de desarrollo si es posible. Si tienes una copia local de tu tienda, practica ahí antes de tocar la producción.
Guarda la copia de seguridad en dos sitios. Por ejemplo, en tu ordenador y en un correo electrónico. Nunca está de más.
Si algo sale mal, restaura la copia. Es tan fácil como subir el archivo .bak y renombrarlo a settings.inc.php.

Resumen rápido

El archivo settings.inc.php es el puente entre tu tienda y su base de datos. Aprender a configurarlo en cPanel o en Plesk te dará autonomía para resolver problemas de conexión sin depender de soporte técnico. Recuerda: copia de seguridad antes de tocar nada, localiza las líneas correctas, edita con cuidado y verifica el resultado.

Si has llegado hasta aquí, ya sabes más que muchos administradores de tiendas online. Ahora, si te surge cualquier otra duda, ya sabes dónde estamos. ¡Buena suerte con tu PrestaShop!