在本文中，我会向你展示如何在 laravel 中从头开始实现 repository 设计模式。我将使用 laravel 5.8.3 版，但 laravel 版本不是最重要的。在开始写代码之前，你需要了解一些关于 repository 设计模式的相关信息。
repository 设计模式允许你使用对象，而不需要了解这些对象是如何持久化的。本质上，它是数据层的抽象。
这意味着你的业务逻辑不需要了解如何检索数据或数据源是什么，业务逻辑依赖于 repository 来检索正确的数据。
关于这个模式，我看到有人将它误解为 repository 被用来创建或更新数据。 这不是 repository 应该做的，repository 不应该创建或更新数据，仅仅用于检索数据。
理解透了吧？接下来一起写代码
既然我们从头开始，那么我们先创建一个新的 laravel 项目吧：
composer create-project --prefer-dist laravel/laravel repository
对于本教程，我们将构建一个小型的博客应用。现在我们已经创建好了一个新的 laravel 项目，接下来应该为它创建一个控制器和模型。
php artisan make:controller blogcontroller
这将在 app/http/controllers 目录中创建 blogcontroller 。
php artisan make:model models/blog -m
提示：
-m 选项会创建一个对应的数据库迁移，你可以在 database/migrations 目录中找到所生成的迁移。
现在你应该能在 app/models 目录中找到刚生成的模型 blog 了吧。这只是一种我喜欢的存放模型的方式。
现在我们有了控制器和模型，是时候看看我们创建的迁移文件了。除了默认的 laravel 时间戳字段外，我们的博客只需要 标题、内容 和 用户 id 字段。
<?php
use illuminate\support\facades\schema;
use illuminate\database\schema\blueprint;
use illuminate\database\migrations\migration;
class createblogstable extends migration
{
public function up()
{
schema::create('blogs', function (blueprint $table) {
$table->bigincrements('id');
$table->string('title');
$table->text('content');
$table->integer('user_id');
$table->timestamps();
$table->foreign('user_id')
->references('id')
->on('users');
});
}
public function down()
{
schema::dropifexists('blogs');
}
}
提示：
如果你使用的是 laravel 5.8 以下的旧版本，请将
$table->bigincrements('id');
替换为：
$table->increments('id');
设置数据库
我将使用 mysql 数据库作为示例，第一步就是创建一个新的数据库。
mysql -u root -p create database laravel_repository;
以上命令将会创建一个叫 laravel_repository 的新数据库。接下来我们需要添加数据库信息到 laravel 根目录的 .env 文件中。
db_database=laravel_repository db_username=root db_password=secret
当你更新了 .env 文件后我们需要清空缓存：
php artisan config:clear
运行迁移
现在我们已经设置好了数据库，可以开始运行迁移了：
php artisan migrate
这将会创建 blogs 表，包含了我们在迁移中声明的 title , content 和 user_id 字段。
实现 repository 设计模式
一切就绪，我们现在可以开始实现 repository 设计风格了。我们将会在 app 目录中创建 repositories 目录。我们将要创建的第二个目录是 interfaces 目录，这个目录位于 repositories 目录中。
在 interfaces 文件中我们将创建一个包含两个方法的 blogrepositoryinterface 接口。
- 返回所有博客文章的 all 方法
- 返回特定用户所有博客文章的 getbyuser 方法
<?php
namespace app\repositories\interfaces;
use app\user;
interface blogrepositoryinterface
{
public function all();
public function getbyuser(user $user);
}
我们需要创建的最后一个类是将要实现 blogrepositoryinterface 的 blogrepository ，我们会写一个最简单的实现方式。
<?php
namespace app\repositories;
use app\models\blog;
use app\user;
use app\repositories\interfaces\blogrepositoryinterface;
class blogrepository implements blogrepositoryinterface
{
public function all()
{
return blog::all();
}
public function getbyuser(user $user)
{
return blog::where('user_id'. $user->id)->get();
}
}
你的 repositories 目录应该像这样：
app/ └── repositories/ ├── blogrepository.php └── interfaces/ └── blogrepositoryinterface.php
你现在已经成功创建了一个 repository 了。但是我们还没有完成，是时候开始使用我们的 repository 了。
在控制器中使用 repository
要开始使用 blogrepository ，我们首先需要将其注入到 blogcontroller 。由于 laravel 的依赖注入，我们很容易用另一个来替换它。这就是我们控制器的样子：
<?php
namespace app\http\controllers;
use app\repositories\interfaces\blogrepositoryinterface;
use app\user;
class blogcontroller extends controller
{
private $blogrepository;
public function __construct(blogrepositoryinterface $blogrepository)
{
$this->blogrepository = $blogrepository;
}
public function index()
{
$blogs = $this->blogrepository->all();
return view('blog')->withblogs($blogs);
}
public function detail($id)
{
$user = user::find($id);
$blogs = $this->blogrepository->getbyuser($user);
return view('blog')->withblogs($blogs);
}
}
如你所见，控制器中的代码很简短，可读性非常的高。不需要十行代码就可以获取到所需的数据，多亏了 repository ，所有这些逻辑都可以在一行代码中完成。这对单元测试也很好，因为 repository 的方法很容易复用。
repository 设计模式也使更改数据源变得更加容易。在这个例子中，我们使用 mysql 数据库来检索我们的博客内容。我们使用 eloquent 来完成查询数据库操作。但是假设我们在某个网站上看到了一个很棒的博客 api，我们想使用这个 api 作为数据源，我们所要做的就是重写 blogrepository 来调用这个 api 替换 eloquent 。
repositoryserviceprovider
我们将注入 blogcontroller 中的 blogrepository ，而不是注入 blogcontroller 中的 blogrepositoryinterface ，然后让服务容器决定将使用哪个存储库。这将在 appserviceprovider 的 boot 方法中实现，但我更喜欢为此创建一个新的 provider 来保持整洁。
php artisan make:provider repositoryserviceprovider
我们为此创建一个新的 provider 的原因是，当您的项目开始发展为大型项目时，结构会变得非常凌乱。设想一下，一个拥有 10 个以上模型的项目，每个模型都有自己的 repository ，你的 appserviceprovider 可读性将会大大降低。
我们的 repositoryserviceprovider 会像下面这样：
<?php
namespace app\providers;
use app\repositories\blogrepository;
use app\repositories\interfaces\blogrepositoryinterface;
use illuminate\support\serviceprovider;
class repositoryserviceprovider extends serviceprovider
{
public function register()
{
$this->app->bind(
blogrepositoryinterface::class,
blogrepository::class
);
}
}
留意用另一个 repository 替代 blogrepository 是多么容易！
不要忘记添加 repositoryserviceprovider 到 config/app.php 文件的 providers 列表中。完成了这些后我们需要清空缓存：
php artisan config:clear
就是这样
现在你已经成功实现了 repository 设计模式，不是很难吧？
你可以选择增加一些路由和视图来拓展代码，但本文将在这里结束，因为本文主要是介绍 repository 设计模式的。
原文地址：
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持www.887551.com。
