ThinkPHP一对多的关联模型运用-牛翰网

ThinkPHP一对多的关联模型运用

一、序言

最近在写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()】。
  • 当用户模型(UserModel)中关联文章变成一对一的时候【return $this->hasOne(ArticleModel::class,’user_id’,’id’);】,【with()】和【withJion()】两个都可以使用。但需注意以下几点:

    • 使用with()的时候,关联数据可以正常输出,withCount()等方法可以同时使用。
    • 使用withJoin()的时候,关联数据可以正常输出,但withCount()等方法不可以同时使用。
  • withCount()、withSum()、withAvg()、withMax()等类似的方法所输出的字段格式为:关联名称(article)+ “_” + [count | sum | avg | max]。例如:article_count
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()); }

 

请登录后发表评论

    没有回复内容