Configuración de la aplicación
Cómo combina HWD POS config/app.php y storage/config.php, y cómo editar los ajustes propios de cada instalación.
HWD POS es una aplicación en PHP nativo. Su configuración efectiva se forma con dos archivos:
| Archivo | Contenido |
|---|---|
config/app.php | Valores predeterminados incluidos con la aplicación. No lo edite: las actualizaciones lo reemplazan. |
storage/config.php | Valores propios de esta instalación: conexión a la base de datos, URL base, idioma, zona horaria y servicios opcionales. |
El asistente del navegador crea storage/config.php automáticamente. Puede contener contraseñas, así que manténgalo privado: está fuera de la raíz web (public/) y el servidor web nunca lo sirve.
Editar storage/config.php
Para cambiar un valor a mano, edite /var/www/HWDPOS/storage/config.php. Su estructura es:
<?php
return [
'app' => [
'name' => 'HWD POS',
'env' => 'production',
'debug' => false,
'base_url' => '',
'locale' => 'es',
'timezone' => 'America/Panama',
],
'db' => [
'driver' => 'mysql',
'socket' => '',
'host' => '127.0.0.1',
'port' => '3306',
'database' => 'hwd_pos',
'username' => 'hwdpos_manager',
'password' => 'YOUR_DB_PASSWORD',
'charset' => 'utf8mb4',
],
];Después de modificar el archivo, recargue la aplicación en el navegador.
Mantenga debug en false en producción. Los mensajes de error detallados pueden revelar información interna.
Opciones
app
| Clave | Descripción |
|---|---|
name | Nombre de la aplicación. |
env | Entorno. Use production. |
debug | Mostrar errores detallados. false en producción. |
base_url | URL base. Normalmente vacía: los enlaces internos del sistema son relativos, así que funciona con cualquier IP o puerto. |
locale | Idioma predeterminado: es (español), en (inglés) o zh (chino). Los usuarios pueden cambiarlo desde la barra superior. |
timezone | Zona horaria de la aplicación. El sistema trabaja con la hora de Panamá (America/Panama). |
typesense | Conexión opcional al servicio de búsqueda. Consulte Búsqueda con Typesense. |
db
| Clave | Descripción |
|---|---|
driver | mysql (MariaDB o MySQL). |
socket | Ruta del socket Unix. Si no está vacío, tiene prioridad sobre host y port. |
host | Servidor de base de datos. 127.0.0.1 en el mismo servidor, o la IP del servidor de base de datos en una instalación separada. |
port | 3306. |
database | Nombre de la base (hwd_pos por defecto). |
username | Usuario de la base (hwdpos_manager si lo creó el instalador). |
password | Contraseña del usuario de la base. |
charset | utf8mb4. No lo cambie. |
Socket o TCP
En servidores Linux y en Windows, deje socket vacío para conectar por TCP a host y port. Es lo que configuran los instaladores.
El socket es solo para configuraciones locales especiales. Por ejemplo, en XAMPP para macOS el socket suele ser /Applications/XAMPP/xamppfiles/var/mysql/mysql.sock.
Use 127.0.0.1 en lugar de localhost en host. Con localhost, el controlador de MySQL intenta usar un socket, lo que puede fallar con «No such file or directory».
Contraseña de la base de datos
Si cambia la contraseña del usuario en MariaDB, actualice también password aquí. Al reejecutar el instalador, ambos quedan sincronizados: lee la contraseña de storage/config.php y se la aplica al usuario de la base. Puede consultar las credenciales vigentes con hwdpanel (opción 8) o con:
php /var/www/HWDPOS/scripts/hwd-admin.php db-infoArchivo .env antiguo
Las versiones anteriores usaban un archivo .env. Ya no es necesario; consérvelo solo temporalmente durante una migración desde una versión anterior. En cualquier caso, el servidor web bloquea el acceso a los archivos .env.