最近在写ThinkPHP关联模型的时候一些用法总忘,我就想通过写博客的方式复习和整理下一些用法。
具体版本:
1、一对一关联
1.1、我先设计了两张表,分别为用户表(user),用户扩展表(user_extend)
1.2、分别给两个表建立模型
<?php /** * Created by PhpStorm * Author: fengzi * Date: 2023/12/19 * Time: 14:50 */ namespace app\common\model; /** * 用户模型 */ class UserModel extends ComBaseModel { protected $name='user'; /** * 关联的用户扩展表 * hasOne的第一个参数是要关联的模型类名,第二个参数是关联的外键名,第三个参数是当前模型(userModel)的主键名 * @return \think\model\relation\HasOne * @Author: fengzi * @Date: 2024/6/27 17:38 */ public function userExtend() { return $this->hasOne(UserExtendModel::class,'user_id','id'); } }
<?php /** * Created by PhpStorm * Author: fengzi * Date: 2023/12/19 * Time: 14:50 */ namespace app\common\model; /** * 用户扩展表 */ class UserExtendModel extends ComBaseModel { protected $name='user_extend'; /** * 用户模型的相对关联 * belongsTo的第一个参数是关联模型类名,第二个参数是当前模型(UserExtendModel)的外键,第三个参数是关联表的主键 * @return \think\model\relation\BelongsTo * @Author: fengzi * @Date: 2024/6/27 17:41 */ public function user() { return $this->belongsTo(UserModel::class,'user_id','id'); } }
1.3、with() 关联查询
一对一关联查询,user表对user_extend表使用的hasOne,使用hasWhere查询user_extend表时,相当于把user_extend表中符合查询条件的user_id集合作为user表的查询条件。
因为使用的一对一关联,所以当user_extend没找到对应查询数据时,user表也不会有数据。
注意:
<?php /** * Created by PhpStorm * Author: fengzi * Date: 2024/6/26 * Time: 17:13 */ namespace app\admin\controller\orm; use app\common\model\UserModel; class OrmController { /** * @var UserModel|object|\think\App */ private UserModel $userModel; public function __construct() { $this->userModel = app(UserModel::class); } public function index() { /** * with 关联查询一对一 * hasWhere第四个参数joinType的值:LEFT、RIGHT 或 INNER * user表对user_extend表使用的hasOne * 使用hasWhere查询user_extend表时,相当于把user_extend表中符合查询条件的user_id集合作为user表的查询条件。 * 因为使用的一对一关联,所以当user_extend没找到对应查询数据时,user表也不会有数据 */ $lists = $this->userModel ->with(['user_extend']) ->hasWhere('userExtend', function ($query){ $query->where('organize_id', 1); }, '*', 'LEFT') ->select()->toArray(); // 输出打印 dd($lists); } }
1.3.1、查询结果展示
1.4、withJoin() 的查询( 我在user模型中定义的user_extend表的关联方法名称为userExtend ):
public function index() { // 实例化模型 $userModel = app(UserModel::class); /** * 联表数据和主表数据在同一级 */ $info = $userModel->withJoin(['user_extend'])->find(1); dump($info->toArray()); /** * 联表数据是主表数据的一个子级,主/联表数据呈现父子级关系 */ $info = $userModel->withJoin(['userExtend'])->find(1); dd($info->toArray()); }
1.4.1、withJoin的条件查询注意事项:
public function index() { // 实例化模型 $userModel = app(UserModel::class); /** * where(['organize_id'=>3]) * 可以根据条件查询出结果 * * * hasWhere('userExtend', function ($query){ * $query->where('organize_id', 3); * }, '*', 'LEFT') * 不能查询出结果,报错“Illegal offset type” */ $info = $userModel->withJoin(['user_extend']) ->where(['organize_id'=>3]) /*->hasWhere('user_extend', function ($query){ $query->where('organize_id', 3); })*/ ->select(); /*********** 以下是主/联表有相同字段(role_id字段相同)时的查询方式 ***********/
// 要筛选主表(user表)中的相同字段时 $info = $userModel ->withJoin('userExtend') ->where(['mkl_user.role_id'=>2]) ->select(); // 输出打印 dump($info->toArray()); // 要筛选关联表(user_extend表)中的相同字段时 $extendInfo = $userModel ->withJoin('userExtend') ->where(['userExtend.role_id'=>3]) ->select(); // 输出打印 dd($extendInfo->toArray()); }
1.5、with 关联修改
关联修改的常见形式有两种:
注意:
public function index() { // 关联查询 $info = $this->userModel->with(['user_extend'])->find(1); // 输出打印 dump($info->toArray()); // 关联修改:方式一 /*$userExtend = [ 'email' => '88888888@qq.com', 'gender' => 1, ]; $info->user_extend->save($userExtend);*/ // 关联修改:方式二 $info->userExtend->email = '88888888@qq.com'; $info->userExtend->gender = 0; $info->userExtend->save(); // 再次关联查询 $newInfo = $this->userModel->with(['user_extend'])->find(1); // 输出打印 dd($newInfo->toArray()); }
1.5.1、with关联修改后的结果
1.6、关联删除
关联删除这里有一些小细节需要注意,下面我们用user_id=1的用户来试验。下图user_id=1的用户数据目前是没有删除的。
1.6.1、with 的关联删除
(1)这种写法能正确的删除主表和关联表的数据,需要注意的是【 with(['userExtend']) 】和【 together(['userExtend']) 】中的参数名称要一样,不能一个驼峰【userExtend】写法,另一个下划线【user_extend】写法。要么都写【userExtend】,要么都写【user_extend】。
public function index() { // 实例化模型 $userModel = app(UserModel::class); // 查询用户ID=1的数据 $info = $userModel->with(['userExtend'])->find(1); // 删除主表和关联表 $del = $info->together(['userExtend'])->delete(); }
(2)这种写法在查询的时候没有带 with() 方法,那么在删除数据的时候,只能删除主表数据,关联表数据不会删除。
public function index() { // 实例化模型 $userModel = app(UserModel::class); // 查询用户ID=1的数据 $info = $userModel->find(1); // 删除主表和关联表 $del = $info->together(['userExtend'])->delete(); // 输出打印 dd($del); }
注意:当主表的数据已经被删除后,还调用 together() 进行主/联表的数据删除就会报错。
(3)当前代码中的方式一和方式二其实跟上面介绍的没什么区别,只是上面几个写法的链式操作。
public function index() { // 实例化模型 $userModel = app(UserModel::class);// 删除主表和关联表 // 方式一 $del = $userModel->find(1)->together(['userExtend'])->delete(); // 方式二 $del = $userModel->with(['userExtend'])->find(1)->together(['userExtend'])->delete(); }
1.6.2、withJoin 的关联删除
注意:
public function index() { // 实例化模型 $userModel = app(UserModel::class); /** * withJoin(['user_extend']) together(['userExtend']) 主表数据删除,联表数据不会删除 * withJoin(['user_extend']) together(['user_extend']) 主表数据删除,联表数据不会删除 * withJoin(['userExtend']) together(['userExtend']) 主表数据删除,联表数据删除 * withJoin(['userExtend']) together(['user_extend']) 主表数据删除,联表数据不会删除 */ // 查询用户ID=1的数据 $info = $userModel->withJoin(['userExtend'])->find(1); // 删除主表和关联表 $del = $info->together(['userExtend'])->delete();
/** * together(['user_extend']) 主表数据删除,联表数据不会删除 * together(['userExtend']) 主表数据删除,联表数据不会删除 */ // 查询用户ID=1的数据 $info = $userModel->find(1); // 删除主表和关联表 $del = $info->together(['userExtend'])->delete(); }