ThinkPHP 8的一对一关联

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

在工程实践中，一般有一对一、一对多、多对多三种关联关系。本文讲解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','tom@163.com' );

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;
}