ThinkPHP模型
模型定義
在app
目錄下創建Model
目錄,即可創建模型文件
定義一個和數據庫表相匹配的模型
use think\Model;
class User extends Model
{
}
User
會自動匹配對於數據庫中的數據表tp_user
模型命名后綴,是為了防止關鍵字沖突,可以開啟應用類后綴:創建
Class UserModel
use think\Model; class UserModel extends Model { //指向數據表 protected $name = 'user'; protected $table = 'tp_user'; }
模型類的定義需要去除表前綴,采用駝峰式命名首字母大寫
tp_user ==> User
tp_user_type ==> UserType
創建於數據表相匹配的模型類后,可以在使用User::*
方法來調用數據庫進行操作
namespace app\controller;
use think\facade\Db;
use app\model;
class DataTest
{
public function index()
{
$user = model\User::select();
return json($user);
}
}
設置模型
模型中默認的主鍵為id
,也可以在模型類中設置主鍵字段名$pk
protected $pk = 'uid';
在控制器中調用模型操作,發生重名可以設置別名
use app\model\User as UserModel;
模型類中可以定義指向數據庫表
protected $table = 'tp_user'; //包含前綴
protected $name = 'user'; //不含前綴
模型類初始化操作(控制器也有),但是必須設置static
靜態方法
protected static funtion init()
{
echo "初始化";
}
模型設置屬性:
屬性 | 描述 |
---|---|
name | 指向數據表名(無前綴),默認為當前模型名 |
table | 數據表 |
suffix | 數據表后綴(默認為空) |
pd | 設置數據表主鍵字段名(默認為id ) |
connection | 數據庫連接(默認加載數據庫配置database.php ) |
query | 模型使用的查詢類名稱 |
field | 指定允許操作的字段(支持數組) |
schema | 模型對應數據表字段和類型 |
type | 模型需要自動轉換的字段和類型 |
strict | 是否嚴重區分字段大小(默認true) |
disuse | 數據表廢棄字段 |
模型字段
模型的數據字段和對應的數據表字段是對應的,默認會自動獲取(以及類型),自動獲取的過程會加一次查詢操作(浪費資源),thinkphp支持自定義字段信息。
$schema = [
'[字段名]' => '[字段類型]';
]
schema
需要定義整個數據表字段,對單個字段定義需要自動轉換的類型可以使用type
如果需要廢棄(忽略)數據表中的字段,可以使用$disuse
來定義
protected $disuse = [‘type’,'status'];
獲取數據
$user = User::find(1);
echo $user->create_time;
echo $user->name;
由於模型類實現了ArrayAccess
接口,所以可以當成數組使用。
$user = User::find(1);
echo $user['create_time'];
echo $user['name'];
如果你是在模型內部獲取數據的話,需要改成:
$user = $this->find(1);
echo $user->getAttr('create_time');
echo $user->getAttr('name');
模型賦值、 實例化
給模型對象賦值
$user = new User() ;
$user->table = 'tp_user';
$user->score = 100 ;
上述代碼會將模型對象打包賦值給$user
,可以對其封裝的模型對象進行操作“修改器”
同時也可以使用
$data['name'] = 'thinkphp';
$data['score'] = 100;
$user = new User($data);
或者使用
$user = new User();
$data['name'] = 'thinkphp';
$data['score'] = 100;
$user->data($data);
data
方法支持使用修改器
$user = new User();
$data['name'] = 'thinkphp';
$data['score'] = 100;
$user->data($data, true);
如果需要對數據進行過濾,可以使用
$user = new User();
$data['name'] = 'thinkphp';
$data['score'] = 100;
$user->data($data, true, ['name','score']);
表示只設置data
數組的name
和score
數據。
最佳操作實踐
新增操作:
新增數據的最佳實踐原則:使用create
靜態方法新增數據,使用saveAll
批量新增數。
刪除操作:
刪除的最佳實踐原則是:如果刪除當前模型數據,用delete
方法,如果需要直接刪除數,使用destroy
靜態方法。
更新操作:
更新的最佳實踐原則是:如果需要使用模型事件,那么就先查詢后更新,如果不需要使用事件或者不查詢直接更新,直接使用靜態的Update
方法進行條件更新,如非必要,盡量不要使用批量更新。
新增-save()
模型數據的新增和數據庫的新增數據有所區別,數據庫的新增只是單純的寫入給定的數據,而模型的數據寫入會包含修改器、自動完成以及模型事件等環節,數據庫的數據寫入參考數據庫章節。
第一步:實例化模型對象
$user = new UserModel();
$user = new \app\model\UserModel();
第二步:新增數據
public function index()
{
$user = new model\UserModel();
$user->username = '諸葛大力';
$user->password = 'gouzaizai';
$user->gender = '女';
$user->email = 'chengguo@gmail.com';
$user->price = 100 ;
$user->uid = 0000;
$user->details = '000';
$user->save();
}
上述的只是一個普通方法,除此還有傳遞數據數組的方式
public function index()
{
$user = new model\UserModel();
$data = [
'username' => '諸葛大力',
'password' => 'gouzaizai',
'gender' => '女',
'email' => 'chengguo@gmail.com',
'price' => 100 ,
'uid' => 0000,
'details' => '000',
];
$user->save($data);
}
allowField()
限制寫入允許字段
$user
// 限制只允許寫入‘username、password’字段
->allowField(['username','password'])
->save($data);
replace()
新增
實現REPLACE into
新增(修改新增)
$user->replace()->save($data);
如果$data
數據表已存在會更新;
REPLACE INTO `tp_user` SET `id` = 301 , `username` = '諸葛大力' , `password` = 'gouzaizai' , `gender` = '女' , `email` = 'chengguo@gmail.com' , `price` = 100 , `uid` = 0 , `details` = '000' , `create_time` = '2020-04-10 11:40:20.660840' , `update_time` = '2020-04-10 11:40:20.660840'
獲取自增ID
$user->id;
$user->uid;
……
批量新增數據saveAll()
*
可以批量添數據,返回新增數組
$user = new User;
$list = [
['name'=>'thinkphp','email'=>'thinkphp@qq.com'],
['name'=>'onethink','email'=>'onethink@qq.com']
];
$user->saveAll($list);
saveAll方法新增數據返回的是包含新增模型(帶自增ID)的數據集對象。
saveAll
方法新增數據默認會自動識別數據是需要新增還是更新操作,當數據中存在主鍵的時候認為是更新操作。
靜態方法 create()
*
$user = UserModel::create([
'username' => '李白',
'password' => '123',
'gender' => '男',
'email' => 'libai@163.com',
'price' => 100,
'details' => '123',
'uid' => 1011
], ['username', 'password', 'details'], false);
參數 1 是新增數據數組,必選
參數 2 是允許寫入的字段,可選
參數 3 為是否 replace 寫入,默認 false 為 Insert 寫入
新增數據的最佳實踐原則:使用create
方法新增數據,使用saveAll
批量新增數據。
刪除-delete()
刪除當前模型
$user = new User();
$user->delete();
根據主鍵刪除
User::destroy(1);
User::destroy([1,2,3]);
條件刪除
User::where('id',10)->delete();
User::destroy(function($query){
$query->where('id',10);
});
刪除的最佳實踐原則是:如果刪除當前模型數據,用delete
方法,如果需要直接刪除數據,使用destroy
靜態方法。
更新
使用find()
方法獲取數據,通過save()
方法提交修改
$user = new model\UserModel();
$data = [
'username' => '諸葛大力',
'gender' => '女'
];
$user->find(305)->save($data);
使用where()
方法結合find()
方法設置查詢條件並獲取數據
$user = new model\UserModel();
$data = [
'username' => '齊天大聖'
];
$user->where('username','孫悟空')
->find()->save($data);
save()
只會更新數據有區別的地方;強制使用save()
更新數據需要使用force()
Db::raw()
執行SQL函數方法同樣可以實現更新
$user = model\UserModel::find(305);
$user->price = Db::raw('price+10');
$user->save();
使用allowField()
方法,允許要更新的字段
$user = model\UserModel::find(305);
$data = [
'username' => '李白',
'password' => '123',
'gender' => '男',
'email' => 'libai@163.com',
'price' => 100,
'details' => '123',
'uid' => 1011
];
$user->allowField(['username'])->save($data);
使用saveAll()
方法可以批量修改數據,返回被修改數據集;批量saveAll()
更新只可以通過主鍵來進行
靜態方法::update()
更新
$data = [ 'username=> '李白',
'password' => '123',
'gender' => '男',
'email' => 'libai@163.com',
'price' => 100,
'details' => '123',
'uid' => 1011
];
model\UserModel::update($data,['id'=> 304],['username']);
參數 1 是數據數組,必選
參數 2 更新條件,可選
參數 3 是允許寫入的字段,可選
save()
模型的新增、更新都需要
save()
進行執行,具有自動識別;實例化模型后調用
save()
表示新增,查詢數據后調用save()
表示修改
更新的最佳實踐原則是:如果需要使用模型事件,那么就先查詢后更新,如果不需要使用事件或者不查詢直接更新,直接使用靜態的Update
方法進行條件更新,如非必要,盡量不要使用批量更新。
查詢
模型普通查詢
-
使用
find()
通過主鍵查詢想要的數據(可以在模型類中設置主鍵字段)調用
find()
方法是,如果數據不存在返回Null,使用findOrEmpty()
方法,數據不存返回空模型使用
isEmpty()
方法判斷是否為空模型 -
使用
where()
進行條件篩選查詢 -
使用
select()
方法,查詢多條指定主鍵的字段,不指定就是全部字段$user = model\UserModel::select([304,305]); foreach ($user as $key=>$value) { echo $value->username; }
-
支持查詢構造器的各種方法
模型動態查詢
getBy[字段名]
:可以獲取對應字段的value(駝峰命名,字段首字母大寫)
$user = model\UserModel::getByUsername('李白');
模型聚合查詢
支持max
min
sum
count
avg
等方法
UserModel::max('price');
模型分批查詢
支持使用chunk()
進行分批處理數據
User::chunk(100, function ($users) {
foreach($users as $user){
// 處理user模型對象
}
});
模型游標查詢
支持使用cursor()
方法進行游標查詢,返回生成器對象
foreach(User::where('status', 1)->cursor() as $user){
echo $user->name;
}
user
變量是一個模型對象實例。
模型查詢的最佳實踐原則是:在模型外部使用靜態方法進行查詢,內部使用動態方法查詢,包括使用數據庫的查詢構造器。
模型獲取器
獲取器的作用是對模型實例的數據做出自動處理
每一個獲取器對應模型的一個特殊方法,方法要求public
獲取器命名規范
get[FieldName]Attr()
,FieldName為數據表字段的駝峰轉換,定義了獲取器自動觸發
- 模型的數據對象取值操作
$model->field_name
- 模型的序列化輸出操作
$model->toArray()
- 顯式調用
getAttr
方法$this->getAttr('field_name')
獲取器常見場景以及基本使用
- 時間日期字段的格式化輸出
- 集合或枚舉類型的輸出
- 數字狀態字段的輸出
- 組合字段的輸出
// 狀態值的轉換輸出
// 模型類
public function getStatusAttr($value)
{
$status = [-1=>'刪除' , 0=>'禁用' , 1=>'正常' , 2=>"待審核"];
return $status[$value];
}
// 控制端
$user = model\UserModel::find(19);
return $user->status;
通俗理解:
在控制端正常的查看字段值,模型類定義一個獲取器(一個字段可以對應一個模型類中的特殊方法獲取器方法)),獲取器就會對控制端的字段查詢進行獲取並進行自定義的處理方法。
獲取器還可以定義數據表不存在的字段,在控制端用戶可以正常的按照字段名讀取的方式來訪問
<?php
namespace app\model;
use think\Model;
class User extends Model
{
public function getStatusTextAttr($value,$data)
{
$status = [-1=>'刪除',0=>'禁用',1=>'正常',2=>'待審核'];
return $status[$data['status']];
}
}
獲取器方法的第二個參數傳入的是當前的所有數據數組。
我們就可以直接使用status_text字段的值了,例如:
$user = User::find(1);
echo $user->status_text; // 例如輸出“正常”
這里也就是為了解決多種處理方法並規避沖突的寫法;因為如果獲取器定義以后就無法在控制端獲原始的字段值,不過也還有另外一種getData()
方法獲得原始字段值:
$user = User::find(1);
// 通過獲取器獲取字段
echo $user->status;
// 獲取原始字段數據
echo $user->getData('status');
// 獲取全部原始數據
dump($user->getData());
動態獲取器
可以支持對模型使用動態獲取器,無需在模型類中定義獲取器方法,在控制端使用動態獲取器:
$user = model\UserModel::find(19)
->withAttr('status',function($value,$data){
$status = [
-1=>'刪除',0=>'禁用',
1=>'正常',2=>'待審核'
];
return $status[$value];
});
echo $user->status;
withAttr
方法支持多次調用,定義多個字段的獲取器。另外注意,withAttr
方法之后不能再使用模型的查詢方法,必須使用Db類的查詢方法。
模型修改器
模型修改器的左右:對模型設置對象的值進行處理
在新增數據的時候,可以利用修改器對數據進行格式化、轉換等處理;處理數據新增,還有數據更新也可能觸發修改器
模型修改器命名規范:
setFieldNameAttr()
ps:修改器只對模型方法有效
public function setEmailAttr($value)
{
return strtolower($value);
}
$user = model\UserModel::create([
'username' => '李白',
'password' => '123',
'gender' => '男',
'email' => 'LIBai@163.com',
'price' => 100,
'details' => '123',
'uid' => 1011
], ['username', 'password', 'details','email'], false);
echo $user->save();
查詢范圍
在模型類創建一個封裝的查詢和寫入方法,有便於控制端調用
查詢封裝方法 scope()
前綴scope
,后綴自定義,在調用時吧后綴當做參數即可。
public function scopeMale($query)
{
$query->where('gender','男')
->field('id,username,gender,email')
->limit(5);
}
$user = model\UserModel::scope('male')->select();
return "<hr>".Db::getLastSql()."<hr>".$user;
public function scopeEmail($query, $value)
{
$query->where('email','like','%'.$value.'%');
}
$user = UserModel::scope('email','xiao')->select();
return "<hr>".Db::getLastSql()."<hr>".$user;
scope()
的第一個參數是調用的封裝方法,第二個參數是封裝方法可以接收的數據
支持多個查詢封裝方法連綴調用
$user = UserModel::scope('email','xiao')
->scope('price',80)
->select();
return "<hr>".Db::getLastSql()."<hr>".$user;
在使用查找范圍
scope()
后,指定使用find()
select()
查詢;在模型類中的查詢封裝方法中可以使用包括修改器、獲取器等在內的模型操作方法。
public function getGenderAttr($value,$data) { $gender = ['男'=>'純爺們','女'=>'小姑娘']; return $gender[$value]; } public function scopeMale($query) { $query->where('gender','男') ->field('id,username,gender,email') ->limit(5); }
全局查找范圍
支持在模型中設置globaScope
屬性,定義全局查找范圍
class User extends Model
{
// 定義全局的查詢范圍
protected $globalScope = ['status'];
public function scopeStatus($query)
{
$query->where('status',1);
}
}
然后,執行下面的代碼:
$user = User::find(1);
最終的查詢條件會是
status = 1 AND id = 1
如果需要動態關閉所有的全局查詢范圍,可以使用:
// 關閉全局查詢范圍
User::withoutGlobalScope()->select();
可以使用withoutGlobalScope
方法動態關閉部分全局查詢范圍。
User::withoutGlobalScope(['status'])->select();
模型搜索器
搜索器用於封裝字段或搜索標識的表達式,類似查找范圍
一個搜索器對應模型的一個特殊方法
命名規范
search[FieldName]Attr()
User模型定義name
字段和時間字段的搜索器,可以使用:
class User extends Model
{
public function searchNameAttr($query, $value, $data)
{
$query->where('name','like', $value . '%');
}
public function searchCreateTimeAttr($query, $value, $data)
{
$query->whereBetweenTime('create_time', $value[0], $value[1]);
}
}
然后,我們可以使用下面的查詢
User::withSearch(['name','create_time'], [
'name' => 'think',
'create_time' => ['2018-8-1','2018-8-5'],
'status' => 1
])->select();
最終生成的SQL語句類似於
SELECT * FROM `think_user` WHERE `name` LIKE 'think%' AND create_time` BETWEEN '2018-08-01 00:00:00' AND '2018-08-05 00:00:00'
可以看到查詢條件中並沒有status
字段的數據,因此可以很好的避免表單的非法查詢條件傳入,在這個示例中僅能使用name
和create_time
條件進行查詢。
事實上,除了在搜索器中使用查詢表達式外,還可以使用其它的任何查詢構造器以及鏈式操作。
例如,你需要通過表單定義的排序字段進行搜索結果的排序,可以使用
class User extends Model
{
public function searchNameAttr($query, $value, $data)
{
$query->where('name','like', $value . '%');
if (isset($data['sort'])) {
$query->order($data['sort']);
}
}
public function searchCreateTimeAttr($query, $value, $data)
{
$query->whereBetweenTime('create_time', $value[0], $value[1]);
}
}
然后,我們可以使用下面的查詢
User::withSearch(['name','create_time', 'status'], [
'name' => 'think',
'create_time' => ['2018-8-1','2018-8-5'],
'status' => 1,
'sort' => ['status'=>'desc'],
])
->select();
最終查詢的SQL可能是
SELECT * FROM `think_user` WHERE `name` LIKE 'think%' AND `create_time` BETWEEN '2018-08-01 00:00:00' AND '2018-08-05 00:00:00' ORDER BY `status` DESC
你可以給搜索器定義字段別名,例如:
User::withSearch(['name'=>'nickname','create_time', 'status'], [
'nickname' => 'think',
'create_time' => ['2018-8-1','2018-8-5'],
'status' => 1,
'sort' => ['status'=>'desc'],
])
->select();
搜索器通常會和查詢范圍進行比較,搜索器無論定義了多少,只需要一次調用,查詢范圍如果需要組合查詢的時候就需要多次調用
模型數據集
數據集直接繼承collection
類,和數據的數據集方式一樣、操作一樣。
參照官方技術文檔
模型自動時間戳
系統支持自動寫入創建和更新的時間戳字段(默認會關閉),具體配置方法:
-
全局開啟:在
database.php
文件中修改auto_timestamp
為truely -
在模型類中單獨開啟自動時間戳:
$autoWriteTimestamp
class User extends Model { protected $autoWriteTimestamp = true; }
也或者單獨關閉自動時間戳
class User extends Model { protected $autoWriteTimestamp = false; }
配置開啟后會自動添加自動時間戳寫入
create_time
和update_time
兩個
端,默認的類型是int,如果是時間類型,可以設置如下
protected $autoWriteTimestamp = [自動時間戳字段]
同時也可以自定義兩個自動時間戳:
protected $createTime = '[字段]';
protected $updateTime = '[字段]';
只讀字段
在模型類中定義readonly
屬性:靜態
protected $readonly = ['字段1','字段2',……]
動態設置制度字段:
$user->readonly(['字段1',……])->save();
系統轉換
系統可以通過模型端設置寫入或讀取時對字段類型進行轉換type
php rotected $type = [ 'price' => 'integer', 'status' => 'boolean', ;
設置廢棄字段 $disuse
JSON字段 *
數據庫JSON
數據庫寫入JSON字段,直接通過數組方式即可完成:
data = [
'username' => '李白',
'password' => '123',
'gender' => '男',
'email' => 'LIBai@163.com',
'price' => 100,
'details' => '123',
'list' => ['username'=>李白,'gender'=>'女']
];
Db::table('tp_user')
->json(['list']) // 定義list字段為json類型字段
->insert($data)
查詢數據,需要轉換JSON數據格式:
Db::table('tp_user')->json(['list'])->find(288);
將JSON字段里的數據作為查詢條件
$user = Db::table('tp_user')->json(['list'])->where('list-username','李白')->find();
修改JSON字段數據
$data['list'] = ['username'=>'李白','gender'=>'男'];
Db::table('tp_user')->json(['list'])->where('id',220)->update($data);
模型JSON
設置寫入JSON字段的字符字段:
protetced $json = ['list'];
使用模型方法新增JSON數據的字段
$user = new User;
$user->name = 'thinkphp';
$user->info = [
'email' => 'thinkphp@qq.com',
'nickname '=> '流年',
];
$user->save();
具體的請參考官方文檔JSON部分
模型軟刪除
在實際項目中,對數據頻繁使用刪除操作會導致性能問題,軟刪除的作用就是把數據加上刪除標,而不是真正的刪除,同時也便於需要的時候進行數據的恢復。
要使用軟刪除功能,需要引入SoftDelete
trait,例如User模型按照下面的定義就可以使用軟刪除功能:
use SoftDelete ;
rotected $deleteTime = 'delete_time';
delete_time
默認為Null,類型為時間戳類型,用於記錄數據的刪除時間。
確定開啟軟刪除和字段后
// 軟刪除
User::destroy(1);
// 真實刪除
User::destroy(1,true);
$user = User::find(1);
// 軟刪除
$user->delete();
// 真實刪除
$user->force()->delete();
軟刪除后系統會忽略該條數據,模型會自動屏蔽數據
-
使用
withTrashed()
取消屏蔽軟刪除的數據 -
使用
onlyTrashend()
可以查詢被軟刪除的數據 -
使用
restore()
可以恢復被軟刪除的數據 -
如果需要強制刪除,需要使用
force()
強制安排
模型和數據庫的事件
數據庫事件
執行增刪改查操作的時候,可以同時出發一些事件來執行額外的操作;額外的操作事件可以部署在構造方法中等待激活后執行;數據庫事件方法是Db::event('事件名','執行函數')
事件名 | 描述 |
---|---|
before_select | select 查詢前回調 |
before_find | find 查詢前回調 |
after_insert | insert 操作后回調 |
after_update | update 操作后回調 |
after_delete | delete 操作后回調 |
一般情況下,數據庫事件卸載控制器端的初始化方法里,有利於統一管理
public function initialize()
{
Db::event('before_select', function($query){
echo "執行了批量的查詢操作"
});
}
模型事件
事件 描述 事件方法名
after_read 查詢后 onAfterRead
before_insert 新增前 onBeforeInsert
after_insert 新增后 onAfterInsert
before_update 更新前 onBeforeUpdate
after_update 更新后 onAfterUpdate
before_write 寫入前 onBeforeWrite
after_write 寫入后 onAfterWrite
before_delete 刪除前 onBeforeDelete
after_delete 刪除后 onAfterDelete
before_restore 恢復前 onBeforeRestore
after_restore 恢復后 onAfterRestore
在模型類中使用靜態方法調用即可完`成事件觸發
關聯模型
關聯模型:將數據表與表之間進行關聯和對象化;
關聯方式
關聯方式 | 描述 |
---|---|
hasOne |
一對一關聯 |
belongsTo |
一對一關聯-反向 |
hasMany |
一對多關聯 |
hasOneThrough |
遠程一對一 |
hasManyThrough |
遠程一對多 |
belongsToMany |
多對多關聯 |
morphMany |
多態一對多 |
morphOne |
多態一對一 |
morphTo |
多態關聯 |
實例:
主表:tp_user
主鍵:id
附屬表:tp_profile
字段:user_id
hobby
外鍵user_id
主表的主鍵與附屬表的外鍵進行關聯
一對一關聯 hasOne
-
關聯定義:
hasOne('關聯模型類名','外鍵','主鍵')
關聯模型:
外鍵:默認的外鍵規則是當前的模型名+
_id
主鍵:當前模型的主鍵,自動獲取也可以指定
class UserModel extends Model { protected $table = 'tp_user'; public function profile() { return $this->hasOne(ProfileModel::class , 'user_id' , 'id'); } }
class ProfileModel extends Model { protected $table = 'tp_profile'; }
$user = model\UserModel::find(19); //return json($user->profile); return $user->profile->hobby;
使用
save()
設置關聯修改,通過主表修改附表字段的值$user = UserModel::find(19); $user->profile->save(['hobby'=>'美女']);
->profile()
方法新增數據$user->profile()->save(['hobby'=>'靚女']);
-
相對關聯(反向)
belongsTo('關聯模型','外鍵','關聯主鍵')
belonsTo
模式適合於附屬表關聯主表class ProfileModel extends Model { protected $table = 'tp_profile'; public function user() { return $this->belongsTo(UserModel::class , 'user_id' , id'); } }
$profile = ProfileModel::find(1); return $profile->user;
使用
hasOne()
模擬belongsTo()
$user = UserModel::hasWhere('profile',['id'=>19])->find(); // 這里的profile是user模型勒種的方法而不是profile模型類
$user = UserModel::hasWhere('profile',function($query){ $query->where('profile.id',19); })-select();
一對多關聯-hasMany
hasMany
模式適合主表關聯附表,實現一對多查詢;與一對一查詢的主要區別就是,hasMany
可以實現查詢返回多條。
hasMany('關聯模型',['外鍵','主鍵']);
使用->profile()
方法模式,可以對數據進行篩選
$user->profile()->where('id','>',19)->select()
調用屬性方式會直接返回結果,調用方法方式可以進行中間處理
使用has()
方法查詢關聯附表的主表內容
$user = UserModel::has('profile','>=',2)->select();
return $user;
這里的查詢是在附表中判斷數據與主表的關聯內容
上述代碼的主要功能:在附表中查找與主表有兩次以上關聯的數據,例如id=19在附表中兩兩條關聯數據
使用haswhere
查詢關聯附表的處理內容(反向關聯)
$user = UserModel::hasWhere('profile',['status'=>1])->select();
return $user;
$user = UserModel::hasWhere('profile',function($query){
$query->where('status','>=',1);
})->select();
使用save()/saveAll()
新增數據
$user = UserModel::find(20);
// 新增單條數據
$user->profile()->save(['hobby'=>'計算機','status'=>'1']);
// 新增批量數據
$user->profile()->saveAll([
['hobby'=>'計算機','status'=>'1'],
['hobby'=>'游戲機','status'=>'1']
]);
使用together()
刪除主表內容時,附表關聯的內容全部刪除
$user = UserModel::with('profile')->find(20);
$user->together(['profile'])->delete();
關聯預載入 with
普通的關聯查詢,會循環執行多次SQL查詢;
$list = UserModel::select([19,20,21]);
foreach($list as $user)
{
dump($user->profile);
}
采用關聯預載入的方式 ,可以減少多次查詢的耗時;
with(['關聯數據表1','關聯數據表2']);
延遲預載入:先執行
select()
再執行load()
關聯統計
使用withCount()
可以統計主表關聯附表的個數,使用profile_count
$list = UserModel::withCount(['profile'])->select([19,20,21]);
foreacth($list as $user)
{
echo $user->profile_count;
}
關聯統計的輸出采用"[關聯方法名]_count"的結構
同時支持withMax``withMin``withSum``withAvg
……
關聯輸出
使用hidden()
方法,隱藏主表字段或附表字段
$list = Usermodel::with('profile')->select();
return json($list->hidden(['profile.status']));
使用visible()
方法,只顯示指定字段
使用append()
方法,添加額外的字段
多對多關聯
三張表:
access表包含了user和role表的關聯ID
belongsToMany('關聯模型','中間表',['外鍵','關聯鍵'])
關聯模型:模型名或類名
中間表:{需要繼承Pivot}
外鍵:
關聯鍵:中間表的當前模型關聯鍵名
參考官方文檔