Configurar settings.inc.php en PrestaShop (cPanel) | Manual

¿Tu tienda PrestaShop da errores de conexión a la base de datos? ¿Ves pantallas en blanco o mensajes como "Error de MySQL" o "No se puede conectar a la base de datos"? No te preocupes, no eres el único. Este es uno de los problemas más comunes al administrar una tienda online, y la solución casi siempre pasa por un archivo muy específico: el settings.inc.php.

En esta guía completa, y pensada para principiantes absolutos, vamos a explicarte paso a paso cómo configurar el archivo settings.inc.php de PrestaShop desde el panel de control cPanel. Aprenderás a editarlo de forma segura, qué significa cada dato y cómo evitar errores fatales. Al final, serás capaz de hacer cambios en la configuración de tu tienda sin miedo y con total confianza.

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

Antes de tocar nada, es fundamental que entiendas qué es este archivo. El settings.inc.php es, básicamente, el "cerebro de conexión" de tu PrestaShop. Es un archivo de texto plano (aunque con extensión .php) que contiene las credenciales y parámetros necesarios para que tu tienda pueda comunicarse con su base de datos.

Piénsalo así: tu tienda PrestaShop es un restaurante, y la base de datos es el almacén donde guardas todos los ingredientes (productos, pedidos, clientes, precios). El archivo settings.inc.php es la llave maestra que le da al camarero (PrestaShop) acceso al almacén. Si la llave es incorrecta, el camarero no puede cocinar y el restaurante cierra (tu tienda muestra un error).

Los parámetros que contiene este archivo son:

El nombre de la base de datos (database_name).
El usuario de la base de datos (database_user).
La contraseña de la base de datos (database_password).
El servidor de la base de datos (database_host), que normalmente es "localhost".
El prefijo de las tablas (db_prefix), que suele ser "ps_".

Configurar este archivo correctamente es vital para que tu tienda funcione. Es lo primero que debes revisar si cambias de hosting, modificas la contraseña de la base de datos o tienes problemas de conexión.

Accediendo a cPanel y localizando el archivo

El primer paso es acceder a tu panel de control cPanel. Normalmente, lo encuentras en una URL como tudominio.com/cpanel o cpanel.tudominio.com, usando el usuario y contraseña que te proporcionó tu proveedor de hosting.

Una vez dentro, verás una cuadrícula de iconos. Debes buscar la sección "Archivos" (o "Files"). Dentro de ella, haz clic en el "Administrador de archivos" (File Manager). Esta herramienta te permite navegar por los archivos de tu hosting como si fuera el explorador de tu ordenador.

Navegando hasta la carpeta de PrestaShop

En el Administrador de archivos, verás una lista de carpetas. Debes entrar en la carpeta public_html. Esta es la carpeta raíz de tu sitio web. Si tu PrestaShop está instalado en una subcarpeta (por ejemplo, public_html/tienda), deberás entrar en esa carpeta.

Dentro de la carpeta donde está tu tienda, busca la carpeta llamada config. Ábrela. Ahí es donde vive el archivo que buscamos: settings.inc.php (en versiones antiguas) o parameters.php (en versiones más modernas). Esta guía se centra en el clásico settings.inc.php, pero los pasos son idénticos para ambos.

Editando el archivo settings.inc.php de forma segura

Ahora viene la parte delicada. Editar este archivo con errores puede romper tu tienda, así que vamos a hacerlo con mucho cuidado. Sigue estos pasos al pie de la letra.

Paso 1: Crear una copia de seguridad (¡IMPORTANTE!)

Antes de tocar nada, haz una copia de seguridad. Esto te salvará la vida si algo sale mal.

En el Administrador de archivos, haz clic derecho sobre el archivo settings.inc.php.
Selecciona "Copiar" (Copy).
En el campo de destino, escribe settings.inc.php.bak o similar. Así tendrás un respaldo en el mismo directorio.
Haz clic en "Copiar archivos".

[WARNING] No subestimes este paso. Una copia de seguridad te permite restaurar la configuración original en segundos si cometes un error. Es la diferencia entre un problema menor y un dolor de cabeza enorme.

Paso 2: Abrir el editor de texto

Haz clic derecho sobre el archivo settings.inc.php original y selecciona "Editar" (Edit). Se abrirá una ventana de confirmación. Asegúrate de que la opción "Mostrar el código fuente" esté marcada y haz clic en "Editar". Esto abrirá el editor de texto de cPanel, donde verás el código PHP.

Paso 3: Identificar y modificar los parámetros clave

Verás un montón de código, pero no te asustes. Solo nos interesan las líneas que empiezan por define('_DB_. Estas son las que definen la conexión a la base de datos.

Busca estas líneas y modifícalas con tus datos correctos:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_nombre_de_base_de_datos');
define('_DB_USER_', 'tu_usuario_de_base_de_datos');
define('_DB_PASSWD_', 'tu_contraseña_de_base_de_datos');
define('_DB_PREFIX_', 'ps_');

_DB_SERVER_: Esto es el servidor de la base de datos. En el 99% de los casos, es localhost. Solo cámbialo si tu proveedor de hosting te indica un servidor diferente (como mysql.tudominio.com).
_DB_NAME_: Es el nombre exacto de tu base de datos. Lo puedes encontrar en cPanel -> Base de datos MySQL.
_DB_USER_: Es el usuario asociado a esa base de datos. También lo encuentras en cPanel -> Base de datos MySQL.
_DB_PASSWD_: Es la contraseña de ese usuario. Si has cambiado la contraseña recientemente, este es el lugar para actualizarla.
_DB_PREFIX_: Es el prefijo de las tablas de tu base de datos. Por defecto es ps_, pero si lo cambiaste durante la instalación, debes poner el tuyo. No lo modifiques a menos que sepas exactamente lo que haces, ya que podrías dejar tu tienda sin acceso a sus datos.

Paso 4: Guardar los cambios

Una vez que hayas modificado los valores necesarios, haz clic en el botón "Guardar cambios" (Save Changes) en la esquina superior derecha del editor.

[TIP] Cierra el editor y visita tu tienda. Si todo ha ido bien, verás tu web funcionando con normalidad. Si ves un error de conexión a la base de datos, es que algo no coincide. Revisa los datos que has introducido y compáralos con los de tu cPanel.

Solución de problemas comunes (FAQ)

Aquí tienes las dudas más frecuentes que nos encontramos en el soporte técnico. Esperamos que te ayuden a resolver tu problema.

¿Por qué me sale "Error al conectar con la base de datos"?

Este es el error más común. Las causas suelen ser:

Credenciales incorrectas: El nombre de la base de datos, el usuario o la contraseña no coinciden con los de cPanel.
El usuario no tiene permisos: Asegúrate de que el usuario de la base de datos está añadido a la base de datos con TODOS LOS PRIVILEGIOS. Esto se gestiona en cPanel -> Base de datos MySQL.
El servidor de la base de datos es incorrecto: Aunque es raro, a veces no es localhost. Consulta la documentación de tu hosting.

¿Qué hago si he olvidado mi contraseña de la base de datos?

No hay problema, puedes cambiarla desde cPanel:

Ve a cPanel -> Base de datos MySQL.
Busca tu usuario en la lista.
Haz clic en "Cambiar contraseña" (o "Change Password").
Crea una nueva contraseña segura.
IMPORTANTE: Después de cambiarla, debes actualizarla en el archivo settings.inc.php siguiendo los pasos anteriores. De lo contrario, tu tienda no podrá conectarse.

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

Sí, en esencia es lo mismo. PrestaShop 1.7 y versiones posteriores renombraron el archivo a parameters.php. La función es idéntica. Si tu versión es moderna, busca parameters.php en la carpeta config y sigue esta misma guía.

¿Puedo editar el archivo desde otro lugar que no sea cPanel?

Sí, también puedes hacerlo mediante FTP (con programas como FileZilla) o desde el Administrador de archivos de tu hosting si no usas cPanel. El proceso es el mismo: descargar el archivo, editarlo con un editor de texto como Notepad++ y volver a subirlo.

[INFO] Si tu hosting no usa cPanel sino un panel alternativo como Syspanel, el proceso es muy similar. Accede a tu panel Syspanel (recuerda que el puerto de acceso es el 2106) y busca el administrador de archivos. La estructura de carpetas y la lógica serán las mismas: busca public_html, luego config y edita el archivo correspondiente.

Consejos de oro para evitar problemas futuros

Configurar el archivo es solo el primer paso. Para mantener tu tienda sana, ten en cuenta estas recomendaciones:

Usa contraseñas fuertes: Tanto para tu base de datos como para tu acceso a cPanel. Evita contraseñas obvias como "123456" o "admin".
Realiza copias de seguridad periódicas: No solo del archivo de configuración, sino de toda tu base de datos y archivos. Así podrás restaurar tu tienda ante cualquier desastre.
Actualiza tu PrestaShop: Las versiones antiguas tienen vulnerabilidades de seguridad. Mantén tu tienda y sus módulos siempre actualizados.
No compartas tus credenciales: Nunca des tu contraseña de base de datos a terceros. Es la llave de acceso a toda la información de tu negocio.
Ten cuidado con los módulos: Un módulo mal codificado puede dañar tu configuración. Instala solo módulos de fuentes confiables y haz pruebas en un entorno de desarrollo si es posible.

Conclusión: Tú puedes con esto

Configurar el settings.inc.php en cPanel puede parecer una tarea de expertos, pero como has visto, es un proceso muy mecánico y manejable si sigues los pasos correctos. La clave está en la paciencia, la atención al detalle y, sobre todo, en la copia de seguridad.

Recuerda que este archivo es el puente entre tu tienda y sus datos. Mantenerlo correctamente configurado es esencial para la salud de tu negocio online. Ya sea que estés migrando de servidor, resolviendo un error de conexión o simplemente haciendo un mantenimiento, ahora tienes el conocimiento necesario para hacerlo sin depender de un técnico para cada pequeño cambio.

Si te has quedado con alguna duda, repasa los pasos de nuevo o consulta la documentación oficial de PrestaShop. Y si tu problema persiste después de verificar las credenciales, no dudes en contactar con tu proveedor de hosting. Ellos pueden verificar si el problema está en el servidor y no en tu configuración. ¡Mucha suerte con tu tienda!