本文详解如何在 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); // 只关联到主类目
}
}✅ 使用示例：
// 获取首个主类目（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 全套查询能力（过滤、排序、预加载、分页等），是处理树形结构与类型化自关联的经典实践方案。
