dagasmart/dict

bizAdmin 数据字典扩展

1.0.3 2025-05-19 15:05 UTC

Requires

• php: >=8.0
• dagasmart/bizadmin: *

MIT

• dagasmart

• extension
• Dict
• bizadmin

README

效果

增加数据字典管理功能

安装

composer

composer require dagasmart/dict

使用说明

1. 安装扩展
2. 在扩展管理中启用扩展

使用方法

配置

在扩展管理中可以配置以下内容

• 屏蔽数据字典类型管理
• 屏蔽数据字典创建
• 屏蔽数据字典删除

调用

// 使用助手函数
admin_dict()->get('data.filesystem.driver');
//输出：['data' => ['local' => ['key' => 'local', 'value' => '本地存储'], ...]]
admin_dict()->getAll('data.filesystem.driver');
//输出：['local' => ['key' => 'local', 'value' => '本地存储'], ...]
admin_dict()->getKey('data.filesystem.driver');
//输出：['local', ...]
admin_dict()->getKey('data.filesystem.driver','本地存储');
//输出：local
admin_dict()->getValue('data.filesystem.driver');
//输出：['本地存储', ...]
admin_dict()->getValue('data.filesystem.driver', 'local');
//输出：本地存储
admin_dict()->getOptions('data.filesystem.driver');
//输出：[['label' => '本地存储', 'value' => 'local'], ...]
admin_dict()->getMapValues('data.filesystem.driver');
//输出：["本地存储", ...]

// 使用接口获取字典选项 (暂时不以使用，该接口会返回 [['label' => xx, 'value' => xx]] 格式的数据)
api('/basic/dict/options?path=data.filesystem.driver')

可用方法

/**
 * 获取数据字典值
 * @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)

注意事项

数据字典数据做了缓存, 新增或修改时会自动清理缓存
直接修改数据库数据字典表数据, 请手动清除缓存