细说Laravel中存储库模式(Repository)到底有何用?

                                                                               

Laravel中的存储库模式为什么在Laravel中使用存储库模式?

在我 上一篇文章 中,我解释了什么是存储库模式,它与active record模式有何不同,以及如何在laravel中实现它。现在我想深入了解一下为什么应该使用存储库模式。

我在上一篇文章的评论中注意到,Repository模式在Laravel社区中是一个有争议的话题。有些人认为没有理由使用它,并坚持使用内置的Active Record模式。其他人则倾向于使用其他方法将数据访问从逻辑域中分离出来。请注意,我尊重这些意见,并将在接下来的博客文章中专门讨论此主题。

有了这个免责声明,让我们来了解一下使用存储库模式的优点。【相关教程推荐:laravel】

单一责任原则

单一责任原则是主要鉴别器来区分Active Record模式和存储库模式。模型类已经保存数据并提供域对象的方法。当使用Active Record模式时,数据访问是额外引入的责任。这是我想在以下示例中说明的东西:

/** * @property string $first_name * @property int    $company_id */class Employee extends Model {}$jack = new Employee();$jack->first_name = 'Jack';$jack->company_id = $twitterId;$jack->save();

虽然域模型和数据访问技术的职责混合,但它直观上看还说得过去。在我们的应用程序中,员工必须以某种方式存储在数据库中,因此为什么不调用对象上的save()。单个对象被转化成单个数据行并存储。

但是,让我们更进一步,看看我们还能对员工做些什么:

$jack->where('first_name', 'John')->firstOrFail()->delete();$competition = $jack->where('company_id', $facebookId)->get();

现在,它变得不直观,甚至违背了我们的域模型。 为什么 Jack 会突然删除另一个甚至可能在不同公司工作的员工? 或者他为什么能把 Facebook 的员工拉过来?

当然,这个例子是人为设计的,但它仍然显示了 Active Record 模式如何不允许有意的域模型。 员工与所有员工列表之间的界限变得模糊。 您始终必须考虑该员工是被用作实际员工还是作为访问其他员工的机制。

仓库模式通过强制执行这个基本分区来解决这个问题。它的唯一用途是标识域对象的合集,而不是域对象的本身。

要点:

通过将所有域对象的集合与单个域对象分离, 仓库模式体现了单一责任原则

不要重复自己 (DRY)

一些项目将数据库查询洒遍了整个项目。下面是一个例子,我们从数据库中获取列表,并在 Blade 视图中显示他们。

class InvoiceController {    public function index(): View {        return view('invoices.index', [            'invoices' => Invoice::where('overdue_since', '>=', Carbon::now())                ->orderBy('overdue_since')                ->paginate()        ]);    }}

当这样的查询遍得更加复杂并且在多个地方使用时,考虑将其提取到 Repository 方法中。

存储库模式通过将重复查询打包到表达方法中来帮助减少重复查询。如果必须调整查询,只需更改一次即可。

class InvoiceController {    public __construct(private InvoiceRepository $repo) {}    public function index(): View {        return view('invoices.index', [            'invoices' => $repo->paginateOverdueInvoices()        ]);    }}

现在查询只实现一次,可以单独测试并在其他地方使用。此外,单一责任原则再次发挥作用,因为控制器不负责获取数据,而只负责处理HTTP请求和返回响应。

Takeaway:

存储库模式有助于减少重复查询

依赖反转

解释 Dependency Inversion Principle 值得发表自己的博客文章。我只是想说明存储库可以启用依赖项反转。

在对组件进行分层时,通常较高级别的组件依赖于较低级别的组件。 例如,控制器将依赖模型类从数据库中获取数据:

class InvoiceController {    public function index(int $companyId): View {        return view(            'invoices.index',            ['invoices' => Invoice::where('company_id', $companyId)->get()]        );    }}

依赖关系是自上而下的,紧密耦合的。 InvoiceController 取决于具体的 Invoice 类。 很难将这两个类解耦,例如单独测试它们或替换存储机制。 通过引入 Repository 接口,我们可以实现依赖倒置:

有道小P 有道小P

有道小P,新一代AI全科学习助手,在学习中遇到任何问题都可以问我。

有道小P 64 查看详情 有道小P

interface InvoiceRepository {    public function findByCompanyId($companyId): Collection;}class InvoiceController {    public function __construct(private InvoiceRepository $repo) {}    public function index(int $companyId): View {        return view(            'invoices.index',            ['invoices' => $this->repo->findByCompanyId($companyId)]        );    }}class EloquentInvoiceRepository implements InvoiceRepository {    public function findByCompanyId($companyId): Collection {        // 使用 Eloquent 查询构造器实现该方法    }}

Controller 现在只依赖于 Repository 接口, 和 Repository 实现一样. 这两个类现在只依赖于一个抽象, 从而减少耦合. 正如我将在下一节中解释的那样,这会带来更多优势.

Takeaway:

存储库模式作为一种抽象类,支持依赖反转.

抽象类

存储库 提高了可读性 因为复杂的操作被具有表达性名称的高级方法隐藏了.

访问存储库的代码与底层数据访问技术分离. 如有必要,您可以切换实现,甚至可以省略实现,仅提供 Repository 接口。 这对于旨在与框架无关的库来说非常方便。

OAuth2 服务包 ——  league/oauth2-server 也用到这个抽象类机制。 Laravel Passport 也通过 实现这个库的接口 集成 league/oauth2-server 包。

正如 @bdelespierre 在 评论 里回应我之前的一篇博客文章时向我指出的那样,你不仅可以切换存储库实现,还可以将它们组合在一起。大致以他的示例为基础,您可以看到一个存储库如何包装另一个存储库以提供附加功能:

interface InvoiceRepository {    public function findById(int $id): Invoice;}class InvoiceCacheRepository implements InvoiceRepository {    public function __construct(        private InvoiceRepository $repo,        private int $ttlSeconds    ) {}    public function findById(int $id): Invoice {        return Cache::remember(            "invoice.$id",            $this->ttlSeconds,            fn(): Invoice => $this->repo->findById($id)        );    }}class EloquentInvoiceRepository implements InvoiceRepository {    public function findById(int $id): Invoice { /* 从数据库中取出 $id */ }}// --- 用法:$repo = new InvoiceCacheRepository(    new EloquentInvoiceRepository(););

要点:

存储库模式抽象了有关数据访问的详细信息。存储库将客户端与数据访问技术分离。这允许切换实现,提高可读性并实现可组合性。

可测试性

存储库模式提供的抽象也有助于测试。

如果你有一个 Repository 接口,你可以提供一个替代的测试实现。 您可以使用数组支持存储库,而不是访问数据库,将所有对象保存在数组中:

class InMemoryInvoiceRepository implements InvoiceRepositoryInterface {    private array $invoices;    // implement the methods by accessing $this->invoices...    }    // --- Test Case:    $repo = new InMemoryInvoiceRepository();    $service = new InvoiceService($repo);

通过这种方法,您将获得一个现实的实现,它速度很快并且在内存中运行。 但是您必须为测试提供正确的 Repository 实现,这 ** 本身可能需要大量工作**。 在我看来,这在两种情况下是合理的:

1.您正在开发一个(与框架无关的)库,它本身不提供存储库实现。

2.测试用例复杂,Repository 的状态很重要。

另一种方法是“模仿”,要使用这种技术,你不需要适当的接口。你可以模仿任何 non-final 类。
使用 PHPUnit API ,您可以明确规定如何调用存储库以及应该返回什么。

$companyId = 42;/** @var InvoiceRepository&MockObject */$repo = $this->createMock(InvoiceRepository::class);$repo->expects($this->once())    ->method('findInvoicedToCompany')    ->with($companyId)    ->willReturn(collect([ /* invoices to return in the test case */ ]));$service = new InvoiceService($repo);$result = $service->calculateAvgInvoiceAmount($companyId);$this->assertEquals(1337.42, $result);

有了 mock,测试用例就是一个适当的单元测试。上面示例中测试的唯一代码是服务。没有数据库访问,这使得测试用例的设置和运行非常快速

另外:

仓库模式允许进行适当的单元测试,这些单元测试运行快并且是隔离的

原文地址:https://dev.to/davidrjenni/why-use-the-repository-pattern-in-laravel-2j1m

译文地址:https://learnku.com/laravel/t/62521

以上就是细说Laravel中存储库模式(Repository)到底有何用?的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/481282.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年11月8日 11:26:10
下一篇 2025年11月8日 11:31:37

相关推荐

  • HTMLrev 上的免费 HTML 网站模板

    HTMLrev 是唯一的人工策划的库专门专注于免费 HTML 模板,适用于由来自世界各地慷慨的模板创建者制作的网站、登陆页面、投资组合、博客、电子商务和管理仪表板世界。 这个人就是我自己 Devluc,我已经工作了 1 年多来构建、改进和更新这个很棒的免费资源。我自己就是一名模板制作者,所以我知道如…

    2025年12月24日
    300
  • 如何使用 Laravel 框架轻松整合微信支付与支付宝支付?

    如何通过 laravel 框架整合微信支付与支付宝支付 在 laravel 开发中,为电商网站或应用程序整合支付网关至关重要。其中,微信支付和支付宝是中国最流行的支付平台。本文将介绍如何使用 laravel 框架封装这两大支付平台。 一个简单有效的方法是使用业内认可的 easywechat lara…

    2025年12月24日
    000
  • Laravel 框架中如何无缝集成微信支付和支付宝支付?

    laravel 框架中微信支付和支付宝支付的封装 如何将微信支付和支付宝支付无缝集成到 laravel 框架中? 建议解决方案 考虑使用 easywechat 的 laravel 版本。easywechat 是一个成熟、维护良好的库,由腾讯官方人员开发,专为处理微信相关功能而设计。其 laravel…

    2025年12月24日
    300
  • 如何在 Laravel 框架中轻松集成微信支付和支付宝支付?

    如何用 laravel 框架集成微信支付和支付宝支付 问题:如何在 laravel 框架中集成微信支付和支付宝支付? 回答: 建议使用 easywechat 的 laravel 版,easywechat 是一个由腾讯工程师开发的高质量微信开放平台 sdk,已被广泛地应用于许多 laravel 项目中…

    2025年12月24日
    000
  • 使用Laravel框架如何整合微信支付和支付宝支付?

    使用 Laravel 框架整合微信支付和支付宝支付 在使用 Laravel 框架开发项目时,整合支付网关是常见的需求。对于微信支付和支付宝支付,推荐采用以下方法: 使用第三方库:EasyWeChat 的 Laravel 版本 建议直接使用现有的 EasyWeChat 的 Laravel 版本。该库由…

    2025年12月24日
    000
  • 如何将微信支付和支付宝支付无缝集成到 Laravel 框架中?

    如何简洁集成微信和支付宝支付到 Laravel 问题: 如何将微信支付和支付宝支付无缝集成到 Laravel 框架中? 答案: 强烈推荐使用流行的 Laravel 包 EasyWeChat,它由腾讯开发者维护。多年来,它一直保持更新,提供了一个稳定可靠的解决方案。 集成步骤: 安装 Laravel …

    2025年12月24日
    100
  • Web页面中动态内容与页脚重叠的解决方案

    本教程旨在解决使用php `include`功能构建bootstrap网站时,页脚内容与主体内容重叠的问题。核心在于纠正html结构中的多余 “ 和 ` ` 标签,确保每个页面只包含一个完整的html文档结构,并将javascript脚本正确放置在 “ 结束标签之前,从而实现…

    2025年12月23日
    000
  • Laravel Blade模板中DIV元素样式定制指南:字体、间距与最佳实践

    本教程详细介绍了如何在laravel blade模板中为div元素应用自定义字体、调整大小和设置间距。我们将探讨常见的错误、正确的内联样式方法,并强调使用css类的最佳实践,同时指导如何正确集成自定义字体,以实现清晰、可维护的样式控制。 引言:理解Blade模板中的样式需求 在构建Web应用时,我们…

    2025年12月23日
    200
  • 如何正确构建HTML结构以确保Bootstrap页脚自动下沉

    本教程旨在解决使用php `include` 和 bootstrap 5 时页脚与内容重叠的问题。核心在于纠正不正确的html结构,避免重复的“和` `标签,合理放置css和javascript引用,并移除可能导致布局冲突的`vh-100`类,确保页脚能根据内容动态下沉。 在Web开发中…

    2025年12月23日
    000
  • 优化Web页面布局:确保Bootstrap页脚自动适应内容高度

    当使用php `include` 动态构建页面时,不正确的html结构(如重复的 “ 和 ` ` 标签)常导致页脚与主体内容重叠。本文将指导如何通过修正html文档结构,避免冗余标签,并确保javascript脚本正确放置,从而实现页脚自动向下移动,适应动态内容高度,提升页面布局的稳定性…

    2025年12月23日
    000
  • PHP Include与Bootstrap布局:解决动态内容下的页脚重叠问题

    本文探讨了在使用php `include` 和 bootstrap 构建网页时,因不当的html结构和css应用导致的页脚重叠问题。教程将指导您如何通过规范html文档结构、正确放置脚本文件以及移除冲突的css属性,确保页脚能够随主体内容动态调整位置,实现健壮且响应式的页面布局。 问题分析:页脚重叠…

    2025年12月23日
    000
  • 怎么运行.html.tpl_运行.html.tpl文件步骤【指南】

    .html.tpl文件需通过后端模板引擎解析,不能直接运行;首先搭建PHP环境,安装Smarty等模板引擎,配置模板与编译目录,编写PHP脚本加载.tpl文件并分配数据,最后通过访问PHP文件触发渲染,浏览器查看最终HTML。 运行 `.html.tpl` 文件并不是直接像普通 HTML 文件那样在…

    2025年12月23日
    000
  • 解决PHP Include页面中页脚重叠问题的最佳实践

    本文旨在解决使用PHP `include`功能构建网页时,页脚与主体内容重叠的问题。核心在于纠正不规范的HTML结构,确保每个页面只有一个`html>`和` `标签,并合理组织导航、内容和页脚的PHP包含文件,同时优化脚本加载位置和元素间距,以实现稳固且响应式的页面布局。 理解问题根源:不规范…

    2025年12月23日
    000
  • Laravel开发:如何在编辑界面正确预选数据库中的多选标签

    本文旨在解决laravel应用中编辑界面多选(select multiple)标签无法自动预选数据库中已保存数据的问题。通过详细讲解控制器层的数据准备和视图层的条件渲染逻辑,我们将展示如何利用blade模板引擎和eloquent关系,确保用户在编辑时能直观看到并修改此前选择的标签,同时提供最佳实践,…

    2025年12月23日
    000
  • Laravel Blade 条件渲染:根据数据状态控制 HTML 元素显示

    本文将介绍在 laravel blade 模板中如何根据数据变量的值是否为空或不存在,来有条件地渲染 html 元素,例如 ` ` 标签。通过利用 blade 的 `@if` 指令结合 php 的 `empty()` 函数,开发者可以确保只有当数据有效时才显示相关内容,从而避免渲染空标签或不必要的信…

    2025年12月23日
    000
  • JavaScript按钮实现PUT/POST重定向与数据提交:模拟表单行为的教程

    本教程详细讲解如何通过JavaScript动态创建并提交隐藏表单,以实现从按钮点击触发的PUT或POST请求重定向,并携带请求体数据。这种方法无需使用`fetch` API,能够满足浏览器自动处理Cookie的需求,为需要模拟完整表单提交行为的场景提供了有效的解决方案。 引言:理解PUT/POST重…

    2025年12月23日
    000
  • PHP多语言网站:语言切换与内容翻译的最佳实践

    本教程旨在指导开发者如何在php项目中实现健壮的多语言切换功能。文章详细介绍了基于会话(session)的语言状态管理、通过url参数进行语言切换的方法,并提出了一套功能完善的辅助函数来加载和安全地检索翻译内容,从而有效避免常见的“未定义变量”或“非法字符串偏移”错误。通过结构化的代码示例和最佳实践…

    2025年12月23日
    000
  • 优化长HTML属性值:SonarQube警告与实用策略

    本文探讨html表单`action`属性过长导致sonarqube警告的问题,并提供三种解决方案:优化url结构、通过变量预构建url,以及灵活评估代码规范。重点推荐使用变量预构建url,以提升代码可读性和维护性,同时兼顾静态分析工具的建议与实际开发需求。 引言:处理HTML长属性值的挑战 在现代W…

    2025年12月23日
    000
  • 使用JavaScript从按钮触发GET重定向或模拟POST/PUT提交的教程

    本教程详细介绍了如何通过JavaScript从按钮触发客户端重定向,以实现类似表单提交的效果,同时确保浏览器Cookie的正常处理。文章涵盖了两种主要方法:一是使用location.href进行带查询参数的GET重定向,适用于简单的导航或GET请求触发的动作;二是通过动态创建和提交隐藏表单来模拟PO…

    2025年12月23日
    000
  • Mac Valet一键站点,HTML+CSS开发环境王者!

    首先确认Valet服务已安装并运行,通过valet install和valet start初始化;使用valet park将项目目录设为可自动访问的本地根目录,新增项目即享.test域名;对独立项目可用valet link绑定自定义.test域名;为优化静态文件支持,在项目根目录创建.valet/s…

    2025年12月23日
    000

发表回复

登录后才能评论
关注微信