Skip to content

配置数据 ​

配置数据是系统的核心设置,存储于 system_config 集合,被前台、后台及插件统一读取。配置数据按「配置分类」组织,每条配置项定义如下:

字段说明
menu_name配置变量名(英文唯一,用于代码中读取)
type数据类型(见下文)
input_type输入组件类型
config_tab_id所属配置分类
append / append_value父级联动:仅当父配置值命中时显示
parameter下拉 / 单选的可选参数(如 1=>男\n2=>女)
upload_type上传类型(1 单图 / 2 多图 / 3 文件)
value默认值
info配置名称(显示名)
desc配置说明
sort排序值
status状态,1 启用,0 禁用

数据类型 ​

配置项支持以下数据类型,对应不同的表单组件:

类型输入组件说明
textInput单行输入框文本、数字、地址等
multiLineInput多行文本域长文本、富文本代码
radioButton单选按钮配合 parameter 使用
fileUpload文件上传单图 / 多图 / 文件
checkbox多选框多选配置
dropdown下拉选择配合 parameter 使用
colorPicker颜色选择器主题色等
slider滑块数值区间
arrayTable数组表格结构化多行数据(如权益列表)
switch开关布尔开关
useSelect选择器关联选择

配置读取方式 ​

前台与后台通过配置分类 eng_title 或配置变量名读取:

按分类读取(返回该分类下全部配置)
按变量名读取(返回单个配置值)

保存配置后,系统会自动刷新配置缓存(Redis),前台立即生效,无需重启服务。

NOTE

配置变量名只允许字母、数字、下划线与 $ 开头,不能包含空格。命名后不建议修改,否则会影响代码读取。

相关接口 ​

接口方法说明
/admin/config/indexGET配置数据列表
/admin/config/addPOST新增配置项
/admin/config/editGET配置项表单
/admin/config/updatePOST编辑配置项
/admin/config/deletePOST删除配置项
/admin/config/drag_updatePOST拖拽排序

Released under the MIT License.