
本文详解如何在 laravel 的单一 `category` 模型中,基于 `category_type` 和 `parent_category` 字段,灵活定义并查询不同层级的自关联一对多关系(如主类目→上级类目、上级类目→次级类目等)。
在单表多类型分类场景中(如 categories 表通过 category_type 区分“主类目”“上级类目”“次级类目”等),虽然物理上只有一张表和一个 Eloquent 模型,但逻辑上存在清晰的层级依赖关系。此时无需拆分模型,而是通过自关联关系(Self-Referencing Relationships) + 条件约束(Query Scopes 或带 where 的关系方法) 实现语义化、可复用的关联定义。
首先,在 app/Models/Category.php 中补充以下关系方法:
use Illuminate\Database\Eloquent\Model;
class Category extends Model
{
use HasFactory;
protected $fillable = [
'name', 'short_name', 'description', 'picture',
'category_type', 'parent_category'
];
// 【核心】反向关系:当前分类所属的父分类(一对一)
public function parentCategory()
{
return $this->belongsTo(Category::class, 'parent_category', 'id');
}
// 【核心】正向关系:当前分类下的所有子分类(一对多)
public function childCategories()
{
return $this->hasMany(Category::class, 'parent_category', 'id');
}
// 【按类型细化】获取指定类型的子分类(例如:主类目 → 上级类目)
public function superiorChildCategories()
{
return $this->childCategories()->where('category_type', 2); // 2 = Superior Category
}
// 同理可扩展其他类型关系
public function secondaryChildCategories()
{
return $this->childCategories()->where('category_type', 3); // 3 = Secondary Category
}
public function mainParentCategory()
{
return $this->parentCategory()->where('category_type', 1); // 只关联到主类目
}
}✅ 使用示例:
系统特点:功能简洁实用。目前互联网上最简洁的企业网站建设系统!原创程序代码。非网络一般下载后修改的代码。更安全。速度快!界面模版分离。原创的分离思路,完全不同于其他方式,不一样的简单感受!搜索引擎优化。做了基础的seo优化。对搜索引擎更友好系统功能关于我们:介绍企业介绍类信息,可自由添加多个介绍栏目!资讯中心:公司或行业资讯类内容展示。可自由添加多个资讯内容!产品展示:支持类别设置,可添加产品图片
// 获取首个主类目(category_type = 1)
$main = Category::where('category_type', 1)->first();
// 获取它所有的「上级类目」子项(category_type = 2)
$superiors = $main->superiorChildCategories; // 自动应用 where('category_type', 2)
// 获取某个次级类目的直接父类目(无论父类目类型)
$secondary = Category::where('category_type', 3)->first();
$parent = $secondary->parentCategory; // 返回 Category 实例(如为 Superior 类目)
// 链式查询:查找某主类目下所有「次级子类目」的「次级子子类目」
$grandChildren = $main
->secondaryChildCategories()
->with(['secondaryChildCategories']) // 预加载二级子项
->get();⚠️ 关键注意事项:
- 数据库字段 parent_category 必须为 BIGINT(与 id 类型一致),且建议添加外键约束(如 ALTER TABLE categories ADD FOREIGN KEY (parent_category) REFERENCES categories(id) ON DELETE SET NULL;);
- category_type 值应统一用整数(而非字符串),便于数据库索引与查询性能优化;
- 若需强制类型安全,可在模型中定义常量或访问器:
const TYPE_MAIN = 1; const TYPE_SUPERIOR = 2; const TYPE_SECONDARY = 3; const TYPE_SUB_SECONDARY = 4;
- 关系方法返回的是 Illuminate\Database\Eloquent\Relations\HasMany / BelongsTo 实例,调用时加 () 是定义关系,不加 ()(如 $cat->childCategories)才是触发查询;
- 如需懒加载(Lazy Eager Loading)或避免 N+1,务必配合 with() 使用,例如:Category::with('childCategories')->get()。
通过这种设计,你既能保持模型简洁性,又能精准表达业务中的多层分类语义,同时获得 Laravel ORM 全套查询能力(过滤、排序、预加载、分页等),是处理树形结构与类型化自关联的经典实践方案。









