ThinkPHP 8的一对一关联

【图书介绍】《ThinkPHP 8高效构建Web应用》-CSDN博客

《2025新书 ThinkPHP 8高效构建Web应用 编程与应用开发丛书 夏磊 清华大学出版社教材书籍 9787302678236 ThinkPHP 8高效构建Web应用》【摘要 书评 试读】- 京东图书

使用VS Code开发ThinkPHP项目-CSDN博客

编程与应用开发_夏天又到了的博客-CSDN博客

关系数据库中的关联关系是其核心组成部分之一，它们可以确保数据的一致性、优化查询语句、实现复杂的业务逻辑等。通过定义关联关系，可以使得不同表之间存在明确的对应关系，从而更好地反映业务需求。

在工程实践中，一般有一对一、一对多、多对多三种关联关系。本文讲解ThinkPHP 8的一对一关联。

每个主模型有一个关联模型，可以选择在主模型添加外键或者在关联模型添加外键，在模型中使用hasOne方法定义。下面以用户模型和用户资料模型的示例来演示一对一关联，用户表参见8.1节，这里再创建一个用户资料表profile并加入一条id为1的记录（可以使用MySQL Workbench工具来操作表及其数据，学习起来相对方便），SQL语句如下：

CREATE TABLE `profile` (`id` int NOT NULL,`mobile` varchar(45) DEFAULT NULL,`email` varchar(45) DEFAULT NULL,PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb3;
INSERT INTO `mydb`.`profile`(`id`,`mobile`,`email`) VALUES(1 ,'13701352990','[e-mail]' );

1. 用户模型

用户模型的示例如下：

<?php
namespace app\model;use think\Model;class UserModel extends Model
{protected $table = 'users';// 设置字段信息protected $schema = ['id'			=> 'int','name'		=> 'string','nickname'	=> 'string','status'		=> 'int',];public function profile(){return $this->hasOne(ProfileModel::class, 'id'); // hasOne}
}

在ThinkPHP 8中默认会使用profile数据表的id作为关联键，可以在定义关联关系时指定。比如，上面代码中我们指定id为profile的关联键：

return $this->hasOne(ProfileModel::class, 'id');

2. 属性模型

属性模型的示例如下：

<?php
namespace app\model;use think\Model;class ProfileModel extends Model
{protected $table = 'profile';// 设置字段信息protected $schema = ['id'       => 'int','mobile'  => 'string','email'   => 'string',];
}

3. 关联查询

关联查询的示例如下：

<?php
namespace app\controller;use think\Model;
use app\model\UserModel;
use app\model\ProfileModel;class User {public function one2one(){$user = UserModel::find(1);// 输出用户资料中的电子邮箱return $user->profile->email;}
}

上面2个模型1个控制器完成后，运行服务器，在浏览器中访问http://localthost:8000/user/one2one，可以查询出id为1的用户的电子邮箱。

4. 根据关联数据查询

上面的示例中，我们是基于主模型进行查询的，那么也可以根据关联模型进行查询。

下面是查询昵称为admin开头的用户示例：

$users = User::hasWhere('profile', function(Query $query) {$query->where('email', 'like', 'tom%');
})->select();

5. 关联预载入

默认情况下，只有在访问关联模型的属性时，才会查询关联模型数据。比如下面的示例中，如果有10个$users，将产生11条查询（1条查询主模型列表，10条查询用户资料），这就是著名的数据库N+1问题。

$users = UserModel::select();
foreach ($users as $user) {echo $user->profile->email;
}

使用以下两种方案解决N+1问题：

（1）两次查询。第一次查询用户列表，取得用户ID列表，第二次使用IN查询方法查询用户资料。

（2）连表查询。直接使用数据库JOIN语句同时查询用户和用户资料。

ThinkPHP 8对上面两种方法都有对应的实现。

6. 两次查询

使用with方法传入关联名称即可，示例如下：

$users = UserModel::with('profile')->select();
foreach ($users as $user) {echo $user->profile->email;
}

如果需要自定义关联查询对象，则可以使用闭包，示例如下：

$users = UserModel::with(['profile'	=> function(Query $query) {$query->field(['id','name','email']);
}])->select();
foreach ($users as $user) {echo $user->profile->email;
}