## 關聯定義
例如,我們的用戶和角色就是一種多對多的關系,我們在`User`模型定義如下:
~~~
<?php
namespace app\model;
use think\Model;
class User extends Model
{
public function roles()
{
return $this->belongsToMany(Role::class, 'access');
}
}
~~~
`belongsToMany`方法的參數如下:
>[info] ### belongsToMany('關聯模型','中間表','外鍵','關聯鍵');
* **關聯模型**(必須):關聯模型類名
* **中間表**:默認規則是當前模型名+`_`+關聯模型名 (可以指定模型名)
* **外鍵**:中間表的當前模型外鍵,默認的外鍵名規則是關聯模型名+`_id`
* **關聯鍵**:中間表的當前模型關聯鍵名,默認規則是當前模型名+`_id`
中間表名無需添加表前綴,并支持定義中間表模型,例如:
~~~
public function roles()
{
return $this->belongsToMany(Role::class, Access::class);
}
~~~
中間表模型類必須繼承`think\model\Pivot`,例如:
~~~
<?php
namespace app\model;
use think\model\Pivot;
class Access extends Pivot
{
protected $autoWriteTimestamp = true;
}
~~~
中間表模型的基類`Pivot`默認關閉了時間戳自動寫入,上面的中間表模型則開啟了時間戳字段自動寫入。
## 關聯查詢
我們可以通過下面的方式獲取關聯數據
~~~php
$user = User::find(1);
// 獲取用戶的所有角色
$roles = $user->roles;
foreach ($roles as $role) {
// 輸出用戶的角色名
echo $role->name;
// 獲取中間表模型
dump($role->pivot);
}
~~~
## 關聯新增
~~~
$user = User::find(1);
// 給用戶增加管理員權限 會自動寫入角色表和中間表數據
$user->roles()->save(['name'=>'管理員']);
// 批量授權
$user->roles()->saveAll([
['name'=>'管理員'],
['name'=>'操作員'],
]);
~~~
只新增中間表數據(角色已經提前創建完成),可以使用
~~~php
$user = User::find(1);
// 僅增加管理員權限(假設管理員的角色ID是1)
$user->roles()->save(1);
// 或者
$role = Role::find(1);
$user->roles()->save($role);
// 批量增加關聯數據
$user->roles()->saveAll([1,2,3]);
~~~
單獨更新中間表數據,可以使用:
~~~
$user = User::find(1);
// 增加關聯的中間表數據
$user->roles()->attach(1);
// 傳入中間表的額外屬性
$user->roles()->attach(1,['remark'=>'test']);
// 刪除中間表數據
$user->roles()->detach([1,2,3]);
~~~
>[danger] `attach`方法的返回值是一個`Pivot`對象實例,如果是附加多個關聯數據,則返回`Pivot`對象實例的數組。
## 相對關聯
我們可以在`Role`模型中定義一個相對的關聯關系,例如:
~~~
<?php
namespace app\model;
use think\Model;
class Role extends Model
{
public function users()
{
return $this->belongsToMany(User::class, Access::class);
}
}
~~~
- 簡介
- 數據庫配置
- 分布式數據庫
- 查詢構造器
- 查詢數據
- 新增數據
- 更新數據
- 刪除數據
- 鏈式操作
- Where
- Table
- Alias
- Field
- Strict
- Limit
- Page
- Order
- Group
- Having
- Join
- Union
- Distinct
- Lock
- Cache
- Comment
- FetchSql
- Force
- Partition
- Replace
- FailException
- Extra
- Duplicate
- Sequence
- Procedure
- View
- 聚合查詢
- 分頁查詢
- 時間查詢
- 高級查詢
- 子查詢
- 原生查詢
- 事務操作
- 存儲過程
- 查詢事件
- JSON字段
- 模型
- 定義
- 新增
- 更新
- 刪除
- 查詢
- 查詢范圍
- 只讀字段
- JSON字段
- 自動時間寫入
- 獲取器
- 修改器
- 搜索器
- 類型轉換
- 模型輸出
- 模型事件
- 虛擬模型
- 關聯
- 一對一關聯
- 一對多關聯
- 遠程一對多
- 遠程一對一
- 多對多關聯
- 多態一對多
- 多態一對一
- 關聯預載入
- 關聯統計
- 關聯輸出
- SQL監聽
- 緩存機制
- 字段緩存
- 查詢緩存
- 擴展
- 自定義查詢類
- 自定義數據庫驅動