Tinkerwell - PHP 草图板

使用父级的 Eloquent 模型单表继承

最后更新于 经过

使用父映像的 Eloquent 模型单表继承

Parental 是一个 Laravel 包 紧缩 它为 Eloquent 引入了单表继承 (STI) 功能。Parental 允许您使用子类扩展父模型,而无需为每个模型变体创建单独的数据库表,所有子类共享同一张表,并通过 type 列来区分它们。

使用案例

当模型拥有大部分相同属性但行为不同时,单表继承非常有用。常见示例包括:

  • 用户类型 - 一个 Admin 和一个 Guest 延伸基座 User 每个模型都有其自身的方法和关系
  • 内容类型 - A TextPostImagePost 延伸 Post 模型,具有特定类型的关系,例如提及或附件
  • 秩序状态 - A PendingOrderShippedOrder 扩展 Order 其中状态转换会改变模型类型

入门

通过 Composer 安装软件包:

作曲家 要求 tightco/parental

接下来,通过添加以下内容来定义父模型和子模型: HasChildren 特征与父模型和 HasParent 每个子模型都有一个特性。每个子类都继承自父类,并且都从同一个数据库表中读取和写入数据:

使用 照亮\数据库\雄辩\模型 ;
使用 收起\家长\有孩子 ;
班级 命令 延伸 模型
{
使用 有孩子 ;
}
使用 收紧\家长\有家长 ;
班级 待处理订单 延伸 命令
{
使用 HasParent ;
}
使用 收紧\家长\有家长 ;
班级 已发货订单 延伸 命令
{
使用 HasParent ;
}

当你创建一个 PendingOrder 或者 ShippedOrder 记录存储在 orders 一张桌子 type 设置列以标识子类。

自定义类型列

如果您的表使用除以下列名之外的列名: type 用以下方式覆盖它 $childColumn 父模型上的属性:

班级 命令 延伸 模型
{
使用 有孩子 ;
受保护 子列 = '地位' ;
}

自定义类型别名

默认情况下,Parental 会将完全限定类名存储在 type 列中。您可以使用以下方式映射较短的别名: $childTypes 父模型上的属性:

使用 照亮\数据库\雄辩\模型 ;
使用 收起\家长\有孩子 ;
班级 命令 延伸 模型
{
使用 有孩子 ;
受保护 子类型 = [
'待办的' => 待处理订单 ::班级 ,
已发货 => 已发货订单 ::班级 ,
];
}

这家商店 pending 或者 shipped 在数据库中,可以使用类型列代替完整的类名。如果您更喜欢使用数字标识符,类型列也支持整数值:

受保护 子类型 = [
1 => 待处理订单 ::班级 ,
2 => 已发货订单 ::班级 ,
];

类型之间的转换 become()

become() 该方法允许您在运行时将模型从一种子类型切换到另一种子类型。例如,当订单经历其生命周期时,您可以将其重新转换为不同的类:

$订单 = 待处理订单 :: 查找或失败 1 (英文):
$订单 = $订单 -> 变得 已发货订单 ::班级 (英文):
$订单 -> 节省 ();

该调用返回目标类的一个全新实例,并保留所有原始属性。Parental 还会分发一个 becoming 在切换之前发生事件,因此您可以监听类型更改并在发生更改时运行额外的逻辑。

急切地加载儿童特定关系

当查询返回多种子类型时,您可能需要加载仅存在于某些类上的关系。调用标准 load() 如果关系仅定义在一个子类型上,则会抛出错误。Parental 提供了专门的辅助函数来处理这种情况,方法是将 eager load 的范围限定到正确的子类:

$订单 -> 加载子项 ([
待处理订单 ::班级 => [ '项目' ],
已发货订单 ::班级 => [ “货物” ],
]);

这些辅助函数适用于 Eloquent 查询构建器、集合和分页器:

// 关于查询
命令 :: 孩子们与 ([
待处理订单 ::班级 => [ '项目' ],
已发货订单 ::班级 => [ “货物” ],
]) -> 得到 ();
// 计算子项之间的关系
命令 :: childrenWithCount ([
待处理订单 ::班级 => [ '项目' ],
已发货订单 ::班级 => [ “货物” ],
]) -> 得到 ();

要了解更多关于 Parental 的信息并查看源代码,请访问 GitHub 存储库

Yannick Lyn Fatt 的照片

Laravel News 的特约撰稿人和全栈 Web 开发人员。

归档于:
立方体

Laravel 时事通讯

加入超过 4 万名开发者的行列,不错过任何新的技巧、教程等内容。

图像
Laravel 代码审查

几天内即可获得 Laravel 代码审查方面的专家指导

访问 Laravel 代码审查
银行标志

银行

只需每月 3200 美元,即可聘请一位拥有 4-6 年经验的资深 Laravel 开发人员,为您的项目注入强劲动力。您将获得 160 小时的专属专业服务,并享受 15 天无风险试用。立即预约通话!

银行
Tinkerwell 徽标

廷克威尔

Laravel 开发者必备的代码运行器。可在本地和生产环境中体验 AI、自动补全和即时反馈功能。

廷克威尔
几天内即可获得 Laravel 代码审查徽标的专家指导

几天内即可获得 Laravel 代码审查方面的专家指导

专家级代码审查!两位拥有 10 年以上 Laravel 开发经验的开发者将为您提供清晰、实用的反馈,帮助团队构建更优质的应用程序。

几天内即可获得 Laravel 代码审查方面的专家指导
了解 Softtech 的标志

了解软科技

Acquaint Softtech 提供 AI 就绪的 Laravel 开发人员,48 小时内即可上手,每月费用为 3000 美元,没有冗长的销售流程,并提供 100% 退款保证。

了解软科技
Kirschbaum 标志

樱桃树

提供创新和稳定性,确保您的Web应用程序取得成功。

樱桃树
Shift 标志

转移

还在运行旧版本的 Laravel?立即实现 Laravel 自动升级和代码现代化,让您的应用程序保持最新状态。

转移
鱼叉:新一代时间跟踪和发票标志

Harpoon:新一代时间跟踪和发票系统

新一代时间跟踪和计费软件,帮助您的机构规划和预测盈利的未来。

Harpoon:新一代时间跟踪和发票系统
Lucky Media 标志

幸运传媒

Get Lucky Now——拥有十余年经验的 Laravel 开发理想之选!

幸运传媒
SaaSykit:Laravel SaaS 入门套件徽标

SaaSykit:Laravel SaaS 入门套件

SaaSykit 是一个多租户 Laravel SaaS 入门套件,包含运行现代 SaaS 所需的所有功能,例如支付、美观的结账界面、管理面板、用户仪表盘、身份验证、现成组件、统计数据、博客、文档等等。

SaaSykit:Laravel SaaS 入门套件
Laravel 添加了官方 Svelte + Inertia Starter Kit 图片

Laravel 新增官方 Svelte + Inertia 入门套件

阅读文章
Laravel 中的 MongoDB 向量搜索:查找无法查询的图像

Laravel 中的 MongoDB 向量搜索:查找无法查询的内容

阅读文章
Laravel Cloud 新增“Markdown for Agents”功能,用于提供 AI 友好型内容图片

Laravel Cloud 新增“Markdown for Agents”功能,以提供对 AI 友好的内容。

阅读文章
Laravel 发布 Nightwatch MCP 服务器,支持 Claude Code 和 AI Agents 图片

Laravel 发布适用于 Claude Code 和 AI 代理的 Nightwatch MCP 服务器。

阅读文章
使用父映像的 Eloquent 模型单表继承

使用父级的 Eloquent 模型单表继承

阅读文章
Laravel Live Denmark 将于 2026 年 8 月重返哥本哈根(图片)

Laravel Live Denmark 将于 2026 年 8 月重返哥本哈根

阅读文章