一、序言
最近在写ThinkPHP关联模型的时候一些用法总忘,我就想通过写博客的方式复习和整理下一些用法。
具体版本:
- topthink/framework:6.1.4
- topthink/think-orm:2.0.61
二、实例应用
1、一对多的关联
本文案例:一个用户对应多篇文章,一篇文章对应多条评论。
以下是用户、文章、评论的模型建立:
(1)用户模型
<?php /** * Created by PhpStorm * Author: fengzi * Date: 2023/12/19 * Time: 14:50 */ namespace app\common\model; /** * 用户模型 */ class UserModel extends ComBaseModel { protected $name='user'; /** * 文章关联表:一对多 * hasMany() * 第一个参数:要关联的模型类 * 第二个参数:在关联表中表示当前模型的外键名 * 第三个参数:当前模型(userModel)的主键名 * @return \think\model\relation\HasMany * @Author: fengzi * @Date: 2024/7/3 11:40 */ public function article() { return $this->hasMany(ArticleModel::class,'user_id','id'); } /** * 评论表模型:远程一对多关联 * hasManyThrough() * 第一个参数(必须):关联的模型类 * 第二个参数(必须):中间表的模型类 * 第三个参数:在中间模型中表示当前模型的外键 * 第四个参数:在关联模型中表示当前模型的外键 * 第五个参数:当前模型主键 * 第六个参数:中间模型主键 * @return \think\model\relation\HasManyThrough * @Author: fengzi * @Date: 2024/7/3 11:42 */ public function articleComment() { return $this->hasManyThrough(ArticleCommentModel::class, ArticleModel::class, 'user_id', 'user_id', 'id', 'id'); } }
(2)文章模型
<?php /** * Created by PhpStorm * Author: fengzi * Date: 2023/12/19 * Time: 14:50 */ namespace app\common\model; /** * 文章模型 */ class ArticleModel extends ComBaseModel { protected $name='article'; /** * 用户模型 * belongsTo() * 第一个参数:关联模型类 * 第二个参数:在当前模型(ArticleModel)中表示关联模型(UserModel)的外键 * 第三个参数:关联模型主键 * @return \think\model\relation\BelongsTo * @Author: fengzi * @Date: 2024/7/3 13:54 */ public function user() { return $this->belongsTo(UserModel::class, 'user_id', 'id'); } /** * 评论关联表:一对多 * hasMany() * 第一个参数:要关联的模型类 * 第二个参数:在关联表中表示当前模型的外键名 * 第三个参数:当前模型(ArticleModel)的主键名 * @return \think\model\relation\HasMany * @Author: fengzi * @Date: 2024/7/3 11:40 */ public function comment() { return $this->hasMany(ArticleCommentModel::class, 'article_id', 'id'); } }
(3)评论模型
<?php /** * Created by PhpStorm * Author: fengzi * Date: 2023/12/19 * Time: 14:50 */ namespace app\common\model; /** * 文章评论模型 */ class ArticleCommentModel extends ComBaseModel { protected $name='article_comment'; /** * 评论模型 * belongsTo() * 第一个参数:关联模型类 * 第二个参数:在当前模型(ArticleCommentModel)中表示关联模型(ArticleModel)的外键 * 第三个参数:关联模型主键 * @return \think\model\relation\BelongsTo * @Author: fengzi * @Date: 2024/7/3 13:54 */ public function article() { return $this->belongsTo(ArticleModel::class, 'article_id', 'id'); } }
2、一对多查询:
(1)一对多的简单查询示例
public function many() { // 实例化模型 $userModel = app(UserModel::class); $articleModel = app(ArticleModel::class); $articleCommentModel = app(ArticleCommentModel::class); /** 关联查询 */ // 查询ID=1的用户 $user = $userModel->find(1); dump($user->toArray()); // 查询ID=1的用户的所有文章,【article()】就是UserModel模型中定义的关联方法 $article = $user->article()->select()->toArray(); dump($article); /** 根据关联条件查询 */ // 查询评论大于等于4个的文章,【comment】就是ArticleModel模型中定义的【comment()】关联方法 $lists = $articleModel->has('comment','>=',4)->select()->toArray(); dump($lists); // 查询评论评论来源为APP的文章(评论来源source:1web,2App),【comment】就是ArticleModel模型中定义的【comment()】关联方法 $lists = $articleModel->hasWhere('comment',['source'=>2])->select()->toArray(); dump($lists); /** 复杂的关联条件查询 */ // 当有复杂的查询条件时,可以先通过评论表进行查询,把查询结果的对象当作条件,再关联文章表 // 不需要select()或find()方法进行查询,直接返回查询对象即可 $articleCommentWhere = $articleCommentModel->where([['source', '=', 2], ['content', 'like', '%有点耐%'], ['user_id', '=', 1]]); // 【comment】就是ArticleModel模型中定义的【comment()】关联方法 $lists = $articleModel->hasWhere('comment', $articleCommentWhere)->select()->toArray(); dd($lists); }
(2)一对多的预查询加载
- 一对多关联查询的时候只能用【with()】,不能用【withJion()】。
- 使用with()的时候,关联数据可以正常输出,withCount()等方法可以同时使用。
- 使用withJoin()的时候,关联数据可以正常输出,但withCount()等方法不可以同时使用。
- withCount()、withSum()、withAvg()、withMax()等类似的方法所输出的字段格式为:关联名称(article)+ “_” + [count | sum | avg | max]。例如:article_count
当用户模型(UserModel)中关联文章变成一对一的时候【return $this->hasOne(ArticleModel::class,’user_id’,’id’);】,【with()】和【withJion()】两个都可以使用。但需注意以下几点:
public function many() { // 实例化模型 $userModel = app(UserModel::class); // 查询ID=1的用户,关联查询文章,【article】就是UserModel模型中定义的关联方法 $userWith = $userModel->with(['article']) ->withCount(['article']) ->withSum(['article'], 'read_num') ->withAvg(['article'], 'read_num') ->withMax(['article'], 'read_num') ->find(1)->toArray(); dump($userWith); // 查询ID=1的用户,关联查询文章,【article】就是UserModel模型中定义的关联方法 $userWithJon = $userModel->withJoin(['article']) ->withCount(['article']) ->withSum(['article'], 'read_num') ->withAvg(['article'], 'read_num') ->withMax(['article'], 'read_num') ->find(1)->toArray(); dd($userWithJon); }
- 关联查询使用闭包时,如果只需显示关联模型中的几个字段,field() 方法中必须带上两个模型中的关联字段(下图中的关联字段就是UserModel模型中article()里面的第二个参数[ user_id ])。当然,带上关联字段后,关联字段也会显示出来。
- 关联查询使用闭包时,如果要过滤关联模型中的几个字段不显示,使用 withoutField() 方法。这时就不用带上关联字段。
3、一对多关联新增
常用新增的使用(下图有执行插入操作后的数据情况),我总共使用了四种方法进行插入,下图可以看见结果。
- 使用【insert】和【insertGetId】虽说可以插入关联,但是关联字段[ user_id ]不会自动写入数据。而且在设置了自动写入时间的情况下,[ create_time ] 和 [ update_time ] 也没有数据。
- 使用【save】可以插入关联数据,也可以自动写入关联字段[ user_id ]和[ create_time ] 和 [ update_time ] 的数据。【saveAll】也是可行的。
- 使用【create】不能写入数据,会直接报错。
- 从用户模型添加关联数据到文章模型时,我们只需要在用户模型中设置关联模式。在关联模型(ArticleModel)中的相对关联不是必须设置的。
/** * 用户模型中的文章关联:一对多(必须设置才能实现关联数据的添加) * hasMany() * 第一个参数:要关联的模型类 * 第二个参数:在关联表中表示当前模型的外键名 * 第三个参数:当前模型(userModel)的主键名 * @return \think\model\relation\HasMany * @Author: fengzi * @Date: 2024/7/3 11:40 */ public function article() { return $this->hasMany(ArticleModel::class,'user_id','id'); }
/** * 文章模型中相对关联的用户模型(通过用户模型添加文章的关联数据时非必须) * belongsTo() * 第一个参数:关联模型类 * 第二个参数:在当前模型(ArticleModel)中表示关联模型(UserModel)的外键 * 第三个参数:关联模型主键 * @return \think\model\relation\BelongsTo * @Author: fengzi * @Date: 2024/7/3 13:54 */ public function user() { return $this->belongsTo(UserModel::class, 'user_id', 'id'); }
public function many() { // 实例化模型 $userModel = app(UserModel::class); // 查询ID=10的用户 $user = $userModel->find(10); // 使用insert添加ID=10用户的关联文章 $user->article()->insert(['title' => '厦门旅游', 'status' => 1]); // 使用insertGetId添加ID=10用户的关联文章 $user->article()->insertGetId(['title' => '黄山旅游', 'status' => 2]); // 使用save添加ID=10用户的关联文章 $user->article()->save(['title' => '泰山旅游', 'status' => 1]); // 使用create添加ID=10用户的关联文章 $user->article()->create(['title' => '泰山旅游', 'status' => 2]); dd($user->toArray()); }
4、一对多关联删除
一对多的关联删除跟【ThinkPHP一对一关联模型的运用(ORM)】文章中的【1.6.1、with 的关联删除】小节差不多,在此就不在重复赘述了。
在此我再补充一些细节:
- 关联删除的时候用select()方法查出来的数据不能用together()进行关联数据的删除。
- 链式操作的方式使用together()的时候一定要注意一个细节:前面查找的数据一定不能为空,不然链式操作直接跟together()会报错( Call to a member function together() on null )。
- 必须以查询结果的对象进行together()操作(使用find()方法后获取到一个查询结果对象)。不能直接条件查询后进行together()操作,不然会报错“method not exist:think\db\Query->together”。
public function many() { // 实例化模型 $userModel = app(UserModel::class); // 正确使用:必须以查询结果的对象进行together()操作,使用find()方法后获取到一个查询结果对象。 $res = $userModel->with(['article'])->where('id', 1)->find()->together(['article'])->delete(); // 错误使用:不能直接条件查询后进行together()操作,不然会报错“method not exist:think\db\Query->together” $res = $userModel->with(['article'])->where('id', 1)->together(['article'])->delete(); dd($res); }
5、一对多的关联编辑
一对多的关联编辑跟【ThinkPHP一对一关联模型的运用(ORM)】文章中的【1.5、with 关联修改】小节差不多,在此就举几个简单的例子:
public function many() { // 实例化模型 $userModel = app(UserModel::class); // 获取用户ID=4的信息 $res = $userModel->with(['article'])->where('id', 4)->find(); // 打印修改前的数据 dump($res->toArray()); // 修改用户名 $res->name = 'xiaohuang';
// 保存修改 $res->save(); // 添加标题为“海口旅游攻略”的新文章 $res->article()->save(['title' => '海口旅游攻略']); // 修改文章ID=7的阅读量 $res->article()->save(['id'=>7, 'read_num' => 1000]); // 查询打印修改后的数据 $info = $userModel->with(['article'])->where('id', 4)->find(); dd($info->toArray()); }
没有回复内容