一对一关联
如一个用户一个资料,User模型
<?php
namespace app\index\model;
use think\Model;
class User extends Model
{
    public function profile()
    {
        return $this->hasOne('Profile');
    }
}

hasOne方法的参数
hasOne('关联模型','外键','主键');
除了关联模型外,其它参数可选
关联模型(必须):关联的模型名或类名
外键:默认的外键规则是当前模型名(不含命名空间,下同)+_id ,例如user_id
主键:当前模型主键,默认会自动获取也可指定

一对一关联定义时支持额外的方法
方法名    描述
setEagerlyType    定义关联查询方式,0 - JOIN查询 1 - IN查询(默认)
bind    绑定关联属性到父模型
joinType    JOIN方式查询的JOIN方式,默认为INNER
selfRelation    定义当前关联为自关联
如果使用JOIN方式的关联查询方式,可在额外的查询条件中使用关联对象名(不含命名空间)作为表的别名

关联查询
定义好关联之后,就可以用下面的方法获取关联数据
$user = User::get(1);
// 输出Profile关联模型的email属性
echo $user->profile->email;
默认用的是user_id 作为外键关联,如果不是的话则需要在关联定义时指定
namespace app\index\model;
use think\Model;
class User extends Model
{
    public function profile()
    {
        return $this->hasOne('Profile','uid');
    }
}
关联方法的命名规范是驼峰法,而关联属性则一般是小写+下划线的方式,
系统在获取的时候会自动转换对应,读取user_profile关联属性则对应的关联方法应该是userProfile

根据关联数据查询
可根据关联条件来查询当前模型对象数据
// 查询用户昵称是think的用户
// 第一个参数是关联方法名(不是关联模型名)
$users = User::hasWhere('profile', ['nickname'=>'think'])->select();
// 可用闭包查询
$users = User::hasWhere('profile', function($query) {
    $query->where('nickname', 'like', 'think%');
})->select();

预载入查询
可使用预载入查询解决典型的N+1查询问题
$users = User::with('profile')->select();
foreach ($users as $user) {
    echo $user->profile->name;
}
上面使用的是IN查询,只会产生2条SQL查询。

如果要对关联模型进行约束,可使用闭包的方式
$users = User::with(['profile'    => function($query) {
    $query->field('name,email');
}])->select();
foreach ($users as $user) {
    echo $user->profile->name;
}

with方法可传入数组,表示同时对多个关联模型(支持不同的关联类型)进行预载入查询
$users = User::with(['profile','book'])->select();
foreach ($users as $user) {
    echo $user->profile->name;
    foreach($user->book as $book) {
        echo $book->name;
    }
}
如果需要用JOIN方式的查询,需要在定义关联的时候使用setEagerlyType(0)(高版本该用法不再建议使用,推荐用withJoin替代)
namespace app\index\model;
use think\Model;
class User extends Model
{
    public function profile()
    {
        return $this->hasOne('Profile')->setEagerlyType(0);
    }
}
V5.1.22+版本始,无需更改关联定义而用withJoin方法
$users = User::withJoin('profile')->select();
foreach ($users as $user) {
    echo $user->profile->name;
}
withJoin方法默认用的是INNER JOIN方式,如果需要使用其它的,可以改成
$users = User::withJoin('profile', 'LEFT')->select();
foreach ($users as $user) {
    echo $user->profile->name;
}
需要注意的是withJoin方式不支持嵌套关联,通常可以直接传入多个需要关联的模型
如果需要约束关联字段,使用简便方法
$users = User::withJoin([
    'profile'    =>    ['name', 'email']
])->select();
foreach ($users as $user) {
    echo $user->profile->name;
}

关联保存
$user = User::get(1);
// 如果还没有关联数据 则进行新增
$user->profile()->save(['email' => 'thinkphp']);
系统会自动把当前模型的主键传入Profile模型。
和新增一样使用save方法进行更新关联数据。
$user = User::get(1);
$user->profile->email = 'thinkphp';
$user->profile->save();
// 或
$user->profile->save(['email' => 'thinkphp']);

定义相对关联
可在Profile模型中定义一个相对的关联关系
namespace app\index\model;
use think\Model;
class Profile extends Model
{
    public function user()
    {
        return $this->belongsTo('User');
    }
}
belongsTo的参数包括:
belongsTo('关联模型','外键','关联主键');
除了关联模型外,其它参数都是可选。
关联模型(必须):模型名或者模型类名
外键:当前模型外键,默认的外键名规则是关联模型名+_id
关联主键:关联模型主键,一般会自动获取也可以指定传入
默认的关联外键是user_id,如果不是,需要在第二个参数定义
namespace app\index\model;
use think\Model;
class Profile extends Model
{
    public function user()
    {
        return $this->belongsTo('User','uid');
    }
}
可以根据档案资料来获取用户模型的信息
$profile = Profile::get(1);// 输出User关联模型的属性
echo $profile->user->account;

绑定属性到父模型
在定义关联的时候使用bind方法绑定属性到父模型
namespace app\index\model;
use think\Model;
class User extends Model
{
    public function profile()
    {
        return $this->hasOne('Profile','uid')->bind('nickname,email');
    }
}
或用数组的方式指定绑定属性别名
namespace app\index\model;
use think\Model;
class User extends Model
{
    public function profile()
    {
        return $this->hasOne('Profile','uid')->bind([
                'email',
                'truename'    => 'nickname',
                'profile_id'  => 'id',
            ]);
    }
}
然后用关联预载入查询的时候,可使用
$user = User::get(1,'profile');// 输出Profile关联模型的email属性
echo $user->email;
echo $user->profile_id;
绑定关联模型的属性支持读取器。
如果不是预载入查询,请使用模型的appendRelationAttr方法追加属性。
关联自动写入
可以使用together方法更方便的进行关联自动写入操作。
写入
$blog = new Blog;
$blog->name = 'thinkphp';
$blog->title = 'ThinkPHP5关联实例';
$content = new Content;
$content->data = '实例内容';
$blog->content = $content;
$blog->together('content')->save();
如果绑定了子模型的属性到当前模型,可以用数组指定子模型的属性
$blog = new Blog;
$blog->name = 'thinkphp';
$blog->title = 'ThinkPHP5关联实例';
$blog->content = '实例内容';
// title和content是子模型的属性
$blog->together(['content'=>['title','content']])->save();
// 查询
$blog = Blog::get(1);
$blog->title = '更改标题';
$blog->content->data = '更新内容';
// 更新当前模型及关联模型
$blog->together('content')->save();
// 查询
$blog = Blog::get(1,'content');
// 删除当前及关联模型
$blog->together('content')->delete();
如果不想这么麻烦每次调用together方法,
也可以直接在模型类中定义relationWrite属性
但必须是数组方式。不过考虑到模型的独立操作的可能性,并不建议。