Configurar settings.inc.php de PrestaShop en Syspanel

¿Qué es el archivo settings.inc.php de PrestaShop?

El archivo settings.inc.php es uno de los archivos más importantes dentro de la estructura de tu tienda PrestaShop. Este archivo contiene la configuración de conexión a la base de datos, la URL de tu tienda, el prefijo de las tablas y otras variables críticas que permiten que tu tienda funcione correctamente.

Puedes encontrar este archivo dentro de la carpeta config de tu instalación de PrestaShop. La ruta habitual es:

/public_html/config/settings.inc.php

Sin embargo, dependiendo de cómo esté configurado tu servidor, la ruta puede variar. En Syspanel, el panel de control de tu hosting, podrás localizarlo fácilmente si accedes al administrador de archivos.

¿Por qué necesito editar el archivo settings.inc.php?

Existen varias razones por las que podrías necesitar editar este archivo. Las más comunes son:

Cambiar la contraseña de la base de datos después de un cambio en el hosting.
Mover tu tienda a un nuevo servidor.
Cambiar la URL de tu tienda.
Corregir errores de conexión a la base de datos.
Actualizar el prefijo de las tablas por seguridad.

En este artículo te explicaremos paso a paso cómo configurar el archivo settings.inc.php de PrestaShop en Syspanel, de una forma sencilla y sin necesidad de ser un experto en programación.

Antes de empezar: haz una copia de seguridad

[WARNING]
Antes de modificar cualquier archivo de configuración, es imprescindible que hagas una copia de seguridad del archivo original. Un error al editar este archivo puede dejar tu tienda inaccesible. Para hacer la copia, simplemente descarga el archivo a tu ordenador o duplícalo en el servidor con un nombre como settings.inc.php.bak.

Acceder a Syspanel para editar el archivo

Para configurar el archivo settings.inc.php de PrestaShop en Syspanel, primero debes acceder a tu panel de control. Recuerda que Syspanel es el nombre del panel que gestiona tu hosting y el puerto de acceso es el 2106.

Pasos para acceder a Syspanel

Abre tu navegador web favorito.
En la barra de direcciones, escribe la URL de acceso a Syspanel. Normalmente será algo como: http://tu-dominio.com:2106 o https://tu-ip:2106.
Introduce tu nombre de usuario y contraseña.
Haz clic en "Iniciar sesión".

Una vez dentro, verás el panel de control con diferentes opciones. Busca la sección de "Administrador de archivos" o "Gestor de archivos", que suele estar representada con un icono de carpeta.

Localizar el archivo settings.inc.php en el administrador de archivos

Cuando estés en el administrador de archivos de Syspanel, sigue esta ruta:

Ruta típica

En la columna izquierda o en el explorador de archivos, navega hasta la carpeta public_html (o www, dependiendo de la configuración de tu servidor).
Dentro de public_html, busca la carpeta config.
Dentro de config, encontrarás el archivo settings.inc.php.

Editar el archivo settings.inc.php con el editor de Syspanel

Ahora que ya has localizado el archivo, es momento de editarlo. Syspanel incluye un editor de archivos integrado que te permitirá modificar el contenido directamente desde el panel.

Pasos para editar el archivo

Haz clic derecho sobre el archivo settings.inc.php.
Selecciona la opción "Editar" o "Edit".
Se abrirá un editor de texto en el navegador con el contenido del archivo.

El contenido del archivo tendrá un aspecto similar a este:

<?php

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_base_datos');
define('_DB_USER_', 'usuario_base_datos');
define('_DB_PASSWD_', 'contraseña_base_datos');
define('_DB_PREFIX_', 'ps_');
define('_MYSQL_ENGINE_', 'InnoDB');
define('_PS_CACHING_SYSTEM_', 'CacheMemcache');
define('_PS_CACHE_ENABLED_', '0');
define('_COOKIE_KEY_', 'clave_cookie');
define('_COOKIE_IV_', 'clave_iv');
define('_PS_CREATION_DATE_', '2024-01-01');
define('_THEME_NAME_', 'classic');
define('_PS_VERSION_', '1.7.8.10');

[TIP]
No te asustes si ves muchos más valores. Solo necesitas modificar las líneas que te indicaremos a continuación. El resto de valores no los toques a menos que sepas exactamente lo que estás haciendo.

Cambiar los datos de conexión a la base de datos

La parte más habitual que tendrás que modificar es la conexión a la base de datos. Esto es necesario cuando cambias de hosting o cuando se ha actualizado la contraseña de tu base de datos.

Variables que debes revisar

_DB_SERVER_: Es la dirección del servidor de base de datos. Normalmente es localhost, pero en algunos hostings puede ser un nombre como mysql.tudominio.com.
_DB_NAME_: Es el nombre de tu base de datos.
_DB_USER_: Es el usuario de la base de datos.
_DB_PASSWD_: Es la contraseña del usuario de la base de datos.

Cómo obtener los datos correctos en Syspanel

Para obtener estos datos desde Syspanel, sigue estos pasos:

Ve a la sección "Bases de datos" o "MySQL" en el panel principal de Syspanel.
Ahí verás listadas todas tus bases de datos, con el nombre, el usuario y la opción de cambiar la contraseña.
Copia estos datos y pégalos en el archivo settings.inc.php.

[INFO]
Si has creado la base de datos desde Syspanel, el usuario y el nombre suelen tener un prefijo con tu nombre de usuario en el hosting. Por ejemplo, si tu usuario es cliente1, la base de datos podría llamarse cliente1_tienda y el usuario cliente1_usuario.

Cambiar la URL de tu tienda

Otra modificación común es cambiar la URL de la tienda. Esto es necesario si has comprado un dominio nuevo o si estás moviendo la tienda a un subdominio.

Variables de URL

Busca estas líneas en el archivo:

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

Cómo modificarlas

Cambia http://tudominio.com por la nueva URL de tu tienda.
Si tu tienda usa SSL (algo muy recomendable), cambia también la URL en la línea de _PS_BASE_URL_SSL_.

[TIP]
Después de cambiar la URL, es posible que necesites borrar el archivo de caché que se encuentra en la carpeta var/cache para que los cambios se apliquen correctamente.

Cambiar el prefijo de las tablas

El prefijo de las tablas es una medida de seguridad que evita que atacantes puedan adivinar los nombres de tus tablas en la base de datos. Si quieres cambiarlo, debes hacerlo con mucho cuidado.

Variable del prefijo

define('_DB_PREFIX_', 'ps_');

Cómo cambiarlo

Cambia 'ps_' por el nuevo prefijo que desees, por ejemplo 'miprefijo_'.
Importante: Deberás renombrar todas las tablas de tu base de datos que empiecen con ps_ al nuevo prefijo. Esto se hace desde la sección de bases de datos de Syspanel o con un cliente MySQL como phpMyAdmin.

[WARNING]
Esta operación es delicada. Si no renombras todas las tablas, tu tienda dejará de funcionar. Si no estás seguro, es mejor que no cambies el prefijo.

Guardar los cambios y verificar

Una vez que hayas realizado todas las modificaciones necesarias, sigue estos pasos:

Haz clic en "Guardar" o "Save" en el editor de archivos de Syspanel.
Cierra el editor.
Accede a tu tienda para verificar que funciona correctamente.

Si la tienda carga sin errores, ¡enhorabuena! Has configurado correctamente el archivo settings.inc.php.

Solución de problemas comunes

Error de conexión a la base de datos

Si ves un error como "Error de conexión a la base de datos", revisa los siguientes puntos:

Que el nombre de la base de datos sea correcto.
Que el usuario tenga permisos para acceder a esa base de datos.
Que la contraseña no tenga caracteres especiales que puedan estar mal codificados.

Página en blanco

Si tu tienda muestra una página en blanco, puede ser que el archivo tenga un error de sintaxis. Revisa que no hayas borrado ninguna comilla o paréntesis.

Errores de caché

Después de editar el archivo, es recomendable limpiar la caché. Puedes hacerlo desde el administrador de PrestaShop en Parámetros avanzados > Rendimiento, o borrando manualmente los archivos de la carpeta var/cache.

¿Qué pasa si no puedo acceder a mi tienda?

Si después de editar el archivo tu tienda deja de funcionar, no te preocupes. Tienes dos opciones:

Restaurar la copia de seguridad: Sube de nuevo el archivo original que guardaste al principio.
Acceder por FTP: Si tienes acceso por FTP, puedes editar el archivo desde tu ordenador con un editor de texto y subirlo de nuevo.

Preguntas frecuentes (FAQ)

¿Es seguro editar el archivo settings.inc.php?

Sí, es seguro siempre que sepas lo que estás haciendo y hagas una copia de seguridad antes de modificar nada.

¿Puedo usar cualquier editor de texto para editar el archivo?

Puedes usar el editor de Syspanel o cualquier editor de texto plano como Notepad++ o Sublime Text. No uses procesadores de texto como Word, ya que pueden añadir caracteres invisibles que rompan el archivo.

¿Qué hago si no encuentro el archivo settings.inc.php?

En versiones recientes de PrestaShop (1.7 y superiores), este archivo puede estar en la carpeta app/config/parameters.php. Si no lo encuentras, busca esa ruta.

¿Necesito reiniciar el servidor después de editar el archivo?

No es necesario reiniciar el servidor. Los cambios se aplican automáticamente al guardar el archivo.

¿Puedo cambiar la contraseña de la base de datos desde Syspanel?

Sí, desde la sección de bases de datos de Syspanel puedes cambiar la contraseña. Después de hacerlo, deberás actualizar el archivo settings.inc.php con la nueva contraseña.

Conclusión

Configurar el archivo settings.inc.php de PrestaShop en Syspanel es un proceso sencillo si sigues los pasos adecuados. Recuerda siempre hacer una copia de seguridad antes de modificar cualquier archivo de configuración, y verifica cada cambio que realices.

[TIP]
Si tienes dudas sobre algún valor específico del archivo, no lo modifiques sin saber su función. Es mejor preguntar a tu proveedor de hosting o consultar la documentación oficial de PrestaShop.

Con esta guía, ya tienes todo lo necesario para editar el archivo settings.inc.php de PrestaShop en Syspanel de forma segura y eficaz. Si sigues estos pasos, podrás solucionar problemas de conexión, cambiar la URL de tu tienda o actualizar los datos de tu base de datos sin complicaciones.

Recuerda que Syspanel es tu aliado para gestionar tu hosting, y el puerto de acceso es el 2106. ¡No dudes en explorar todas sus funcionalidades para mantener tu tienda en perfecto estado!