前置基础概念
主表:在一对多关系中,一条记录可匹配多条其他表记录的表(1端)。
从表:在一对多关系中,存放外键的表,一条记录仅能匹配一条主表记录(N端)。
外键:用于建立两表关联的字段。在一对多场景下,外键始终存放在从表中。
预加载 with():旨在解决 N+1 查询性能问题,为优先推荐方案;严禁在循环体内单独查询关联数据。
本文示例约定:
- banner_cate:轮播分类表(主表,1端)
- banner:轮播图表(从表,N端)
- 关联条件:banner.cate_id = banner_cate.id
多对一 belongsTo(从表关联主表)
使用场景:从表的单条记录对应主表的一条记录。例如:一条轮播图(从表)属于一个轮播分类(主表)。
代码位置:写在【从模型】中(如 Banner.php)。
belongsTo(关联模型, 当前模型外键, 关联模型主键)
- 参数 1:目标关联模型(主表模型)
- 参数 2:当前模型(从表)自身包含的外键字段
- 参数 3:关联模型(主表)的主键字段
代码示例:
// app/model/Banner.php
public function cate()
{
// 匹配规则:banner.cate_id = banner_cate.id
return $this->belongsTo(BannerCate::class, 'cate_id', 'id');
}
调用方式:
// 查询轮播,同时带出对应的分类信息
$banner = Banner::with('cate')->find(1);
echo $banner->cate->cate_name; // 获取分类名称
核心总结:belongsTo 用于从表关联主表,外键位于当前从表中。
一对多 hasMany(主表关联从表)
使用场景:主表的单条记录对应从表的多条记录。例如:一个轮播分类(主表)下包含多条轮播图(从表)。
代码位置:写在【主模型】中(如 BannerCate.php)。
hasMany(关联模型, 关联模型外键, 当前模型主键)
- 参数 1:目标关联模型(从表模型)
- 参数 2:关联模型(从表)中的外键字段(注意:外键不在当前主表)
- 参数 3:当前模型(主表)自身的主键字段
代码示例:
// app/model/BannerCate.php
public function bannerList()
{
// 匹配规则:banner.cate_id = banner_cate.id
return $this->hasMany(Banner::class, 'cate_id', 'id');
}
调用方式:
// 查询分类,同时拿到该分类下全部轮播
$cate = BannerCate::with('bannerList')->find(1);
var_dump($cate->bannerList); // 返回数据集,可循环输出
核心总结:hasMany 用于主表关联从表,外键存放在对方的从表中。
一对一 hasOne
使用场景:主表的单条记录对应从表的唯一一条记录。例如:用户表(主表)与用户详情表(从表)。
参数规则:与 hasMany 完全一致,区别在于返回的是单条记录对象而非数据集。
hasOne(关联模型, 关联模型外键, 当前模型主键)
代码示例:
// User.php(主模型)
public function info()
{
return $this->hasOne(UserInfo::class, 'user_id', 'id');
}
调用方式:
$user = User::with('info')->find(1);
echo $user->info->phone;
多对多 belongsToMany(中间表模式)
使用场景:两张表互相存在一对多关系,需通过中间表维系关联。例如:文章与标签(一篇文章可有多个标签,一个标签可对应多篇文章)。
表结构要求:需要三张表,即文章表、标签表及中间表(如 article_tag)。中间表仅存放两个外键:article_id 和 tag_id。
注意:多对多关系无严格的主从表划分,双方模型均需定义 belongsToMany。
belongsToMany(关联模型, 中间表名, 当前模型在中间表的外键, 关联模型在中间表的外键)
代码示例(Article模型):
// app/model/Article.php
public function tags()
{
return $this->belongsToMany(Tag::class, 'article_tag', 'article_id', 'tag_id');
}
调用方式:
$article = Article::with('tags')->find(1);
foreach($article->tags as $tag){
echo $tag->tag_name;
}
关联附加 where 条件
在预加载时可通过闭包函数对关联数据进行筛选。
// 只预加载状态为启用的分类
$list = Banner::with([
'cate' => function($query){
$query->where('status',1);
}
])->select();
核心语法速查
- belongsTo(从表关联主表):belongsTo(主模型, 自身外键, 主表主键)
- hasMany(主表关联多条从表):hasMany(从模型, 从表外键, 自身主键)
- hasOne(主表关联单条从表):参数同 hasMany,返回单条记录
- belongsToMany(多对多):依赖中间表,无主从划分
#tp8模型关联

