ThinkPHP一对一关联模型的运用（ORM）

疯子丶pony2024-07-25 16:31

一、序言

最近在写ThinkPHP关联模型的时候一些用法总忘，我就想通过写博客的方式复习和整理下一些用法。

具体版本：

  • topthink/framework：6.1.4
  • topthink/think-orm：2.0.61

二、实例应用

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表也不会有数据。

注意：

  • hasWhere() 的第一个参数一定是user模型中关联用户扩展表的方法名称。
  • with预载入查询中的关联模型中的名称是user模型中关联用户扩展表的方法名称，如果方法名是驼峰写法，也可以转换成下划线。如：userExtend => user_extend
复制代码 
<?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 ）：

  • withJoin(['user_extend"])：这种写法查询出来的关联表数据会和主表数据在同一层级。而关联表数据的展现方式会以user模型中定义的关联方法名称为前缀+下划线+表字段的形式呈现。
    • 注意：【userExtend__xxx】中的下划线是两个，并不是一个下划线(一个下划线 _ ；两个下划线 __ )。所以在查询结果对象转换成数组后去获取字段数据时要注意，避免报错。
    • 这个写法同级中还多了一个【user_extend】字段，其值为null。这个字段在两个数据表中都是不存在的。
  • withJoin(['userExtend"])：这种写法査询出来的关联表数据与主表数据是有父子级关系。以withJoin中定义的模型名称"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的条件查询注意事项：

  • 使用 withJoin() 做关联，进行条件查询的时候，只要使用 where() 方法进行条件筛选即可。
  • 如果主/联表中有相同的字段且筛选条件就是相同的字段，使用 hasWhere() 方法进行条件筛选会报错。
  • 如果主/联表中有相同的字段且筛选条件是主表中的字段，那么where条件应该这么写【where(['mkl_user.role_id'=>2])】。同时参数中的role_id要写明是哪个表，且带上表前缀。
  • 如果主/联表中有相同的字段且筛选条件是联表中的字段，那么where条件应该这么写【where(['userExtend.role_id'=>3])】。同时参数中的role_id要写明是哪个关联表，关联名称跟【withJoin('userExtend')】的一样。
复制代码 
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 关联修改

关联修改的常见形式有两种：

  • 方式一：把关联表要修改的数据写入一个数组中，使用save方法直接修改。
  • 方式二：单独字段一个个赋值后，最后使用save方法进行修改。

注意：

  • 不管是上面哪种，查询出来的对象不能转换成数组后进行关联表的修改，不然就会报错。
  • with中的关联名称一般要与修改时一致。当然，不一致也可以，写模型中关联方法的名称也行。如：with使用user_extend，修改时使用userExtend也是可以的。
复制代码 
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 的关联删除

注意：

  • 如果要主/联表的数据都删除，那么在查询的时候必须带 withJoin() 方法。
  • 带 withJoin() 方法查询后，删除时 together() 和 withJoin() 方法的参数必须是 UserModel 模型中关联的方法名称，即本文1.2处的userExtend() 方法的名称。
  • 如果不带 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();
}
相关推荐
残月只会敲键盘1 小时前
php代码审计--常见函数整理
开发语言·php
ac-er88882 小时前
MySQL如何实现PHP输入安全
mysql·安全·php
YUJIANYUE5 小时前
PHP将指定文件夹下多csv文件[即多表]导入到sqlite单文件
jvm·sqlite·php
龙哥·三年风水14 小时前
群控系统服务端开发模式-应用开发-个人资料
分布式·php·群控系统
Dingww101118 小时前
梧桐数据库中的网络地址类型使用介绍分享
数据库·oracle·php
Genius Kim1 天前
SpringCloud Sentinel 服务治理详解
spring cloud·sentinel·php
原机小子1 天前
城镇保障性住房管理：SpringBoot系统解决方案
数据库·spring boot·php
kali-Myon1 天前
NewStarCTF2024-Week5-Web&Misc-WP
前端·python·学习·mysql·web安全·php·web
DK七七1 天前
当今陪玩系统小程序趋势，陪玩系统源码搭建后的适用于哪些平台
小程序·php·uniapp
tekin2 天前
vscode php Launch built-in server and debug, PHP内置服务xdebug调试，自定义启动参数配置使用示例
ide·vscode·php·launch.json·runtimeargs·php内置服务自定义参数
热门推荐
01【HarmonyOS】HUAWEI DevEco Studio 下载地址汇总02(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明03组基轨迹建模 GBTM的介绍与实现（Stata 或 R）04【AIGC】重塑未来的科技巨轮05全面解析：构建基于深度学习的安全帽检测系统（UI界面+YOLO代码+数据集）06【经验分享】Ubuntu22.04安装微信(linux官方版)07基于YOLOv10深度学习的CT扫描图像肾结石智能检测系统【python源码+Pyqt5界面+数据集+训练代码】深度学习实战、目标检测08Ubuntu 20.04使用Livox mid 360 测试 FAST_LIO09RAG 实践- Ollama+RagFlow 部署本地知识库10【TC3xx芯片】TC3xx芯片电源管理系统PMS详解