应用配置

更新时间:2023-05-25 12:32

为了方便给用户一个统一便捷的应用配置入口,我们建议您用此方式设置您的应用后台,您只需书写此文件即可

/www/[app]/[ver]/conf/setting.yaml

节点定义

yaml 格式的节点定义及含义如下:

[页面ID]:
  name: [页面名称]
  items:
    name:
      name: 设置项名称
      desc: 设置项说明
      type: [类型]
      default: 默认值
      placeholder: 提示文字 
      selects: 选项
        值: 文字

类型目前包含如下内容:

类型含义
text单行文本框
textarea多行文本框
radio单选
checkbox多选
select下拉单选
multipleSelect下拉多选
number数字文本框
datetime-local日期时间文本框
date日期文本框
time时间文本框
month月份文本框
color颜色文本框
image图片上传(单图)

备注

image 类型设置项,上传图片后,存储的是图片的 key 值,可以使用 Lib\Cos::ImageUrl 接口获取图片类资源的 URL。

自定义配置入口

您可以自己做一个配置入口,通过下面的定义跳转到相应的 controller 和 action 中

[页面ID]:
  name: [页面名称]
  controller: controller
  action: action

为了安全,我们提供了相应的后台入口校验接口,详情请查看“应用配置入口校验”接口

完整的范例

base:
  name: 基本设置
  items:
    name:
      name: 姓名
      desc: 请输入姓名
      type: text
      default: ''
      placeholder: 唐三
    sex:
      name: 性别
      desc: 请输入性别
      type: radio
      selects:
        0: 未知
        1: 男
        2: 女
      default: 2
    equip:
      name: 初始装备
      desc: 请选择初始装备
      type: checkbox
      selects:
        1: 皮靴
        2: 木剑
        3: 背心
        4: 皮裤
      default: 2|3
    city:
      name: 出生地
      desc: 请选择出生地
      type: select
      selects:
        0: "- 请选择 -"
        1: 花园村
        2: 大圣村
        3: 土豆岭
        4: 海神岛
      default: 4
    task:
      name: 初始任务
      desc: 请选择初始任务
      type: multipleSelect
      selects:
        1: 杀死10只土豆怪
        2: 帮村民老王寻找鞋子
        3: 抓到偷盗村民财务的小偷
        4: 升级到 5 级
      default: 2|3
    logo:
      name: Logo图片
      desc: 请上传Logo图片
      type: image
      placeholder: 请上传Logo图片  
adv:
  name: 高级设置
  items:
    text:
      name: 说明文本
      desc: 说明内容
      type: textarea
      placeholder: 唐三
    age:
      name: 年龄
      desc: 请输入年龄
      type: number
      default: ''
      placeholder: 10
    dateTime:
      name: 日期时间
      desc: 请输入日期和时间
      type: datetime-local
      default: ''
    date:
      name: 日期
      desc: 请输入日期
      type: date
      default: ''
    time:
      name: 时间
      desc: 请输入时间
      type: time
      default: ''
    month:
      name: 月份
      desc: 请输入月份
      type: month
      default: ''
    color:
      name: 颜色
      desc: 请输入颜色
      type: color
      default: ''
myadmin:
  name: 自定义设置
  controller: Admin
  action: index

应用配置可用 Lib\Site::GetSetting() 接口获取设置的内容