Expand description
§wordval-config
Wordval 配置系统:TOML 加载、多环境 Profile、静态/动态配置。
§特性
- TOML 格式 — 结构清晰,易于维护
- 多环境 Profile — 通过命令行参数
profile=dev/prod切换配置 - 静态配置 — 启动时加载,运行时只读
- 动态配置 — 运行时可读写(通过
RwLock) - 命令行生成 —
gen-config一键生成默认配置文件
§快速开始
ⓘ
use wordval_config::{parse_args, detect_profile, ConfigManager};
let args = parse_args();
let profile = detect_profile();
let manager = ConfigManager::load(None);Re-exports§
pub use env::detect_profile;pub use env::merge_env_overrides;pub use env::parse_args;pub use log::init as init_log;
Modules§
Structs§
- AppConfig
- 完整应用配置——Settings + Routes + Plugins 三合一
- Audit
Middleware Config - 操作审计配置(批量落盘管道 + 敏感路由审计层)
- Audit
Route - 审计记录落盘目标
- Auth
Middleware Config - 认证中间件
- Cache
Config - 缓存配置
- Compress
Config - 响应压缩配置
- Config
Manager - 配置管理器——持有静态配置 + 允许运行时覆盖
- Cors
Config - CORS 配置
- Database
Config - 数据库配置
- Download
Config - 下载配置
- FsConfig
- 文件存储配置
- LogConfig
- 日志配置
- Middleware
Config - 中间件配置
- Migration
Config - 数据库迁移配置
- Nonce
Config - Nonce 重放防护配置
- NotFound
Config - 404 处理配置
- Permission
Config - 权限校验中间件配置
- Permission
Rule - 单条路径权限规则
- Plugins
Config - 插件配置
- Rate
Limit Config - IP 限流配置
- Redis
Config - Redis 配置
- Request
LogConfig - 请求日志中间件配置
- Router
Config - 路由配置
- Scheduler
Config - Security
Headers Config - 安全响应头配置
- Server
Config - 服务器配置
- Static
Config - 静态文件配置
- Template
Config - 模板配置
- Upload
Config - 上传配置
Constants§
- DEFAULT_
APP_ NAME - DEFAULT_
CACHE_ TYPE - DEFAULT_
CSP_ VALUE - DEFAULT_
DB_ ALIAS - 默认数据库别名:
db()返回该别名对应的库,多库配置中它具有特殊意义 - DEFAULT_
DB_ TYPE - DEFAULT_
DOWNLOAD_ PATH - DEFAULT_
FS_ BACKEND - DEFAULT_
FS_ REGION - DEFAULT_
FS_ ROOT - DEFAULT_
HOST - DEFAULT_
LISTEN - DEFAULT_
LOG_ FORMAT - DEFAULT_
LOG_ LEVEL - DEFAULT_
LOG_ PREFIX - DEFAULT_
MIGRATION_ PATH - DEFAULT_
NOT_ FOUND_ MSG - DEFAULT_
PERMISSIONS_ POLICY_ VALUE - DEFAULT_
PROFILE - DEFAULT_
REDIS_ URL - DEFAULT_
REFERRER_ POLICY_ VALUE - DEFAULT_
STATIC_ PATH - DEFAULT_
TEMPLATE_ PATH - DEFAULT_
UPLOAD_ PATH