slowlyo / owl-dict
OwlAdmin 数据字典扩展
v1.3.2
2024-07-08 03:05 UTC
Requires
- php: >=8.0
- slowlyo/owl-admin: *
README
效果
增加数据字典管理功能
安装
zip 下载地址
https://gitee.com/slowlyo/owl-dict/repository/archive/master.zip
composer
composer require slowlyo/owl-dict
使用说明
- 安装扩展
- 在扩展管理中启用扩展
使用方法
配置
在扩展管理中可以配置以下内容
- 屏蔽数据字典类型管理
- 屏蔽数据字典创建
- 屏蔽数据字典删除
调用
// 使用助手函数 admin_dict()->getValue('user.status', '未知'); // 使用容器 app('admin.dict')->getValue('user.status', '未知'); // 使用接口获取字典选项 (该接口会返回 [['label' => xx, 'value' => xx]] 格式的数据 /admin_dict/options?path=gender
可用方法
/** * 获取数据字典值 * @params string $path 路径 例如: user.status * @params string $default 默认值 * @params bool $needAllData 是否需要返回所有数据 (为true时返回所有数据, 包括禁用数据和软删除数据) * @return string 例如: 正常 */ public function getValue($path, $default = '', $needAllData = true) /** * 获取数据字典键 * @params ... * @return string 例如: normal */ public function getKey($path, $default = '', $needAllData = true) /** * 获取数据字典数据 * @params ... * @return array 例如: ['key' => 'normal', 'value' => '正常'] */ public function getAll($path, $default = [], $needAllData = true) /** * 获取数据字典数据 - 选项格式 * @params ... * @return array 例如: [['label' => '正常', 'value' => 'normal']] */ public function getOptions($path, $needAllData = true)
注意事项
数据字典数据做了缓存, 新增或修改时会自动清理缓存
直接修改数据库数据字典表数据, 请手动清除缓存