>[info]本章節僅適用于1.3.2版本以上
從`1.3.2`版本開始,數據授權修改為分模塊設置,模塊內可分組。

在模塊信息文件`info.php`中,數據授權格式如下(以cms模塊為例):
```
// 授權配置
'access' => [
'column' => [
'title' => '欄目授權',
'page_tips' => '頁面提示',
'tips_type' => 'primary',
'nodes' => [
'group' => 'column',
'table_name' => 'cms_column',
'primary_key' => 'id',
'parent_id' => 'pid',
'node_name' => 'name',
'model_name' => 'column',
'child' => [],
]
],
],
```
其中,鍵值`column`為分組標識,建議使用英文單詞。
```
// 授權配置
'access' => [
'column' => [
'title' => '欄目授權',
'nodes' => [
'group' => 'column',
'table_name' => 'cms_column',
'primary_key' => 'id',
'parent_id' => 'pid',
'node_name' => 'name',
]
],
'type' => [
'title' => '分類授權',
'nodes' => [
'group' => 'type',
'table_name' => 'cms_type',
'primary_key' => 'id',
'parent_id' => 'pid',
'node_name' => 'name',
]
]
],
```
授權頁面如下:

**頁面提示**
如果想在數據授權頁面顯示一些提示性文字,可配置 `page_tips`和 `tips_type`。
```
// 授權配置
'access' => [
'column' => [
'title' => '欄目授權',
'page_tips' => '這是頁面提示',
'tips_type' => 'danger',
'nodes' => [
'group' => 'column',
'table_name' => 'cms_column',
'primary_key' => 'id',
'parent_id' => 'pid',
'node_name' => 'name',
]
]
],
```

下面講解最重要的配置參數`nodes`,所有的授權數據內容均在`nodes`內定義,在`nodes`內可定義的參數如下:
* `group` 分組標識,名字自定義
* `table_name` 表名,表示要關聯哪張表,不需要填寫表前綴
* `primary_key` 主鍵字段名
* `parent_id` 父級id字段名
* `node_name` 權限節點字段名
* `model_name` 模型名(可選)
* `child` 子節點配置信息,格式與父節點一致
`dp_cms_column`數據表有如下三個字段,分別對應`primary_key`、`parent_id`、`node_name`。

`table_name`定義表名后,系統會從該表讀取授權節點,比如上面的cms模塊配置

在需要判斷當前用戶或者某個用戶是否有某些權限,可以使用Access模型的`getAuthNode`方法和`checkAuthNode`方法。
### 按模型獲取數據
以上說的是讀取的數據在同一張表上,如果有些數據在另外一張表,那么就不好處理了。
如果遇到這樣的需求,可以設置模型名。
~~~
// 授權配置
'access' => [
'column' => [
'title' => '欄目授權',
'nodes' => [
'group' => 'column',
'table_name' => 'cms_column',
'primary_key' => 'id',
'parent_id' => 'pid',
'node_name' => 'name',
'module_name' => 'column',
]
]
],
~~~
這樣配置的話,那你必須在你模塊下有名為`Column`的模型文件,路徑為:`\app\模塊名\model\Column.php`
除此之外,該模型下必須有一個特定的方法,方法名為`access`,你只需在這個方法返回你需要展示的數據即可。
```
public function access()
{
return self::all();
}
```
也可以使用Db類進行查詢數據,然后返回數據。返回的數據必須包含上面 `primary_key`, `parent_id` , `node_name`所定義的字段即可。
>[info]這種方法靈活性比較大,可以隨意查詢數據,只要返回的數據中,有包含上面設置的三個字段名id、pid、name即可。
### 子節點定義
如果數據節點來自不多張表,并且表之間是關聯關系,那么需要定義子節點信息。
比如某招生系統中,院系節點、專業節點、班級節點分班在不同的表,但希望數據授權的時候,能集中授權,那么這種情況下,就需要定義子節點信息。
```
// 授權配置
'access' => [
'yx' => [
'title' => '院系專業班級',
'nodes' => [
'group' => 'yx',
'table_name' => 'admin_yxdm',
'primary_key' => 'YXDM',
'parent_id' => 'pid',
'node_name' => 'YXMC',
'model_name' => 'Yxdm',
'child' => [
'group' => 'zy',
'table_name' => 'admin_zydm',
'primary_key' => 'ZYDH',
'parent_id' => 'pid',
'node_name' => 'ZYMC',
'child' => [
'group' => 'bj',
'table_name' => 'admin_bjdm',
'primary_key' => 'BJDM',
'parent_id' => 'pid',
'node_name' => 'BJMC',
]
]
]
]
],
```
在第一個`nodes`中,我們定義了`model_name`為`Yxdm`,那么我們需要創建一個模型文件,路徑為:`\app\模塊名\model\Yxdm.php`
在模型文件中,定義access方法
```
public function access()
{
$data_list = self::all(['status' => 1]);
foreach ($data_list as $key => $item) {
$data_list[$key]['pid'] = 0;
// 專業
$child = Db::name('admin_zydm')->where('YXDM', $item['YXDM'])->select();
if ($child) {
foreach ($child as $k => $v) {
$list_bj = Db::name('admin_bjdm')
->where('ZYDH', $v['ZYDH'])
->where('ND', config('curr_year'))
->select();
if ($list_bj) {
$child[$k]['child'] = $list_bj;
}
}
$data_list[$key]['child'] = $child;
}
}
return $data_list;
}
```
最終返回的$data_list格式類似這樣:
```
array(
array(
'YXDM' => 1,
'pid' => 0,
'YXMC' => '機電工程學院',
'child' => [
[
'ZYDH' => 12,
'pid' => 0,
'ZYMC' => '電器自動化技術',
'child' => [
[
'BJDM' => 1,
'pid' => 0,
'BJMC' => '18自動化1班',
],
[
'BJDM' => 2,
'pid' => 0,
'BJMC' => '18自動化2班',
]
]
],
[
'ZYDH' => 13,
'pid' => 0,
'ZYMC' => '模具設計與制造',
'child' => [
[
'BJDM' => 3,
'pid' => 0,
'BJMC' => '18模具1班(兩年制)',
]
]
]
]
),
);
```
授權頁面類似這樣

### 獲取用戶授權節點
```
$nodes = get_auth_node(1, 'cms.column');
```
表示獲取用戶id為1的欄目授權節點,其中`column`是數據授權配置中`group`所定義的值。
### 檢查用戶數據授權
```
if(check_auth_node(1, 'cms.column', 55)){
//id為1的用戶,擁有欄目節點id為55的訪問權限
} else {
// id為1的用戶,沒有欄目節點id為55的訪問權限
}
```
- 序言
- 環境搭建
- 下載及安裝
- 目錄結構
- 快速構建器(ZBuilder)
- 表單(form)
- 設置頁面標題
- 設置頁提示信息
- 設置表單提交地址
- 隱藏按鈕
- 添加按鈕
- 設置按鈕標題
- 添加表單項
- 復選
- 單選
- 日期
- 時間
- 開關
- 標簽
- 數組
- 分組
- 范圍
- 按鈕
- 數字框
- 密碼框
- 取色器
- 下拉菜單
- 普通聯動
- 快速聯動
- 拖拽排序
- 靜態文本
- 格式文本
- 日期時間
- 日期范圍
- 圖片裁剪
- 百度地圖
- 單文件上傳
- 多文件上傳
- 單圖片上傳
- 多圖片上傳
- 隱藏表單項
- 圖標選擇器
- 單行文本框
- 多行文本框
- 百度編輯器
- CKEditor編輯器
- wang編輯器
- markdown編輯器
- summernote編輯器
- 圖片展示(1.1.0+)
- 單文件展示(1.1.0+)
- 多文件展示(1.1.0+)
- 下拉菜單Ajax(1.3.3+)
- 復雜表格(1.4.3+)
- 數據表格(1.4.3+)
- 分組下拉菜單(1.4.3+)
- 表格選取(1.4.3+)
- 穿梭框(1.4.3+)
- 添加表單項通用方法
- 直接設置表單項
- 表單布局
- 設置Tab按鈕列表
- 設置表單數據
- 引入js文件
- 引入css文件
- 設置額外JS代碼
- 設置額外CSS樣式
- 設置額外HTML代碼
- 是否ajax方式提交
- 設置模版路徑
- 設置觸發器
- 設置表單提交確認框
- 自定義表單項(1.0.6+)
- 設置表單提交方式(1.0.6+)
- 模板變量賦值(1.0.7+)
- 設置頁面空表單項提示(1.0.7+)
- 自定義擴展表單圖標(1.2.0+)
- 設置表單令牌(1.3.1+)
- 新窗口打開返回的url(1.4.4+)
- 表格(table)
- 設置頁面標題
- 設置頁面提示信息
- 添加一列
- 字段類型
- switch
- status
- yesno
- text.edit
- textarea.edit
- password
- url
- tel
- number
- icon
- byte
- date
- time
- datetime
- date.edit
- time.edit
- datetime.edit
- picture
- pictures
- select
- callback
- link
- text
- img_url
- files(1.1.1+)
- popover(1.4.4+)
- 添加多列
- 添加數量索引
- 添加快捷編輯的驗證器
- 設置表格數據
- 隱藏第一列多選框
- 添加表頭排序
- 添加表頭篩選
- 添加表頭篩選條件
- 添加時間段篩選
- 添加一個右側按鈕
- 添加多個右側按鈕
- 添加一個頂部按鈕
- 添加多個頂部按鈕
- 自動添加按鈕
- 自動編輯按鈕
- 替換右側按鈕
- 設置搜索參數
- 設置數據庫表名
- 設置插件名稱
- 設置表格主鍵
- 設置Tab按鈕列表
- 設置分頁
- 去除分頁
- 引入js文件
- 引入css文件
- 設置額外JS代碼
- 設置額外CSS樣式
- 設置額外HTML代碼
- 設置額外HTML代碼-模板文件(1.4.0+)
- 設置模版路徑
- 添加行class名
- 添加頂部下拉篩選
- 設置頁面空數據提示(1.0.7+)
- 模板變量賦值(1.0.7+)
- 設置使用原始數據字段(1.0.8+)
- 設置搜索區域(1.1.0+)
- 設置表格高度(1.3.0+)
- 固定左列(1.3.0+)
- 固定右列(1.3.0+)
- 設置列寬(1.3.0+)
- 設置隱藏列(1.3.0+)
- 側欄(aside)
- 添加區塊
- 設置Tab按鈕列表
- 追加Tab按鈕列表
- 設置當前tab
- 設置單個tab內容
- 設置多個tab內容
- 追加tab內容
- 覆蓋側欄
- 模塊開發
- 創建模塊信息文件
- 安裝模塊
- 模塊配置
- 控制器
- 創建菜單節點
- 第一個控制器
- 模塊參數配置頁面
- 方法參考
- 數據授權(1.3.2+)
- 插件開發
- 插件入口文件
- 插件基本信息
- 管理界面的字段信息
- 新增或編輯的字段信息
- 插件鉤子
- 觸發器
- 原數據庫表前綴
- 插件配置信息
- 安裝和卸載Sql文件
- 控制器
- 模型
- 驗證器
- 視圖
- 方法參考
- 實踐教程
- 變量參考
- 函數參考
- 安全相關
- 常見問題
- 其他雜項
- 更新日志
- 升級指導
- 貢獻名單
- 關于文檔