当前位置:首页 > CMS教程 > 其它CMS > 列表

如何在Laravel5.8中正确地应用Repository设计模式

发布:smiling 来源: PHP粉丝网  添加日期:2022-01-24 14:09:44 浏览: 评论:0 

这篇文章主要介绍了如何在Laravel5.8中正确地应用Repository设计模式,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧。

在本文中,我会向你展示如何在 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 字段。

  1. <?php 
  2.  
  3. use Illuminate\Support\Facades\Schema; 
  4. use Illuminate\Database\Schema\Blueprint; 
  5. use Illuminate\Database\Migrations\Migration; 
  6.  
  7. class CreateBlogsTable extends Migration 
  8.  public function up() 
  9.  { 
  10.   Schema::create('blogs'function (Blueprint $table) { 
  11.    $table->bigIncrements('id'); 
  12.    $table->string('title'); 
  13.    $table->text('content'); 
  14.    $table->integer('user_id'); 
  15.    $table->timestamps(); 
  16.  
  17.    $table->foreign('user_id'
  18.      ->references('id'
  19.      ->on('users'); 
  20.   }); 
  21.  } 
  22.  
  23.  public function down() 
  24.  { 
  25.   Schema::dropIfExists('blogs'); 
  26.  } 

提示:

如果你使用的是 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 方法

  1. <?php 
  2.  
  3. namespace App\Repositories\Interfaces; 
  4.  
  5. use App\User; 
  6.  
  7. interface BlogRepositoryInterface 
  8.  public function all(); 
  9.  
  10.  public function getByUser(User $user); 

我们需要创建的最后一个类是将要实现 BlogRepositoryInterface 的 BlogRepository ,我们会写一个最简单的实现方式。

  1. <?php 
  2.  
  3. namespace App\Repositories; 
  4.  
  5. use App\Models\Blog; 
  6. use App\User; 
  7. use App\Repositories\Interfaces\BlogRepositoryInterface; 
  8.  
  9. class BlogRepository implements BlogRepositoryInterface 
  10.  public function all() 
  11.  { 
  12.   return Blog::all(); 
  13.  } 
  14.  
  15.  public function getByUser(User $user
  16.  { 
  17.   return Blog::where('user_id'$user->id)->get(); 
  18.  } 

你的 Repositories 目录应该像这样:

  1. app/ 
  2. └── Repositories/ 
  3.  ├── BlogRepository.php 
  4.  └── Interfaces/ 
  5.   └── BlogRepositoryInterface.php 

你现在已经成功创建了一个 repository 了。但是我们还没有完成,是时候开始使用我们的 repository 了。

在控制器中使用 Repository

要开始使用 BlogRepository ,我们首先需要将其注入到 BlogController 。由于 Laravel 的依赖注入,我们很容易用另一个来替换它。这就是我们控制器的样子:

  1. <?php 
  2.  
  3. namespace App\Http\Controllers; 
  4.  
  5. use App\Repositories\Interfaces\BlogRepositoryInterface; 
  6. use App\User; 
  7.  
  8. class BlogController extends Controller 
  9.  private $blogRepository
  10.  
  11.  public function __construct(BlogRepositoryInterface $blogRepository
  12.  { 
  13.   $this->blogRepository = $blogRepository
  14.  } 
  15.  
  16.  public function index() 
  17.  { 
  18.   $blogs = $this->blogRepository->all(); 
  19.  
  20.   return view('blog')->withBlogs($blogs); 
  21.  } 
  22.  
  23.  public function detail($id
  24.  { 
  25.   $user = User::find($id); 
  26.   $blogs = $this->blogRepository->getByUser($user); 
  27.  
  28.   return view('blog')->withBlogs($blogs); 
  29.  } 

如你所见,控制器中的代码很简短,可读性非常的高。不需要十行代码就可以获取到所需的数据,多亏了 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 会像下面这样:

  1. <?php 
  2.  
  3. namespace App\Providers; 
  4.  
  5. use App\Repositories\BlogRepository; 
  6. use App\Repositories\Interfaces\BlogRepositoryInterface; 
  7. use Illuminate\Support\ServiceProvider; 
  8.  
  9. class RepositoryServiceProvider extends ServiceProvider 
  10.  public function register() 
  11.  { 
  12.   $this->app->bind( 
  13.    BlogRepositoryInterface::class,  
  14.    BlogRepository::class 
  15.   ); 
  16.  } 

留意用另一个 repository 替代 BlogRepository 是多么容易!

不要忘记添加 RepositoryServiceProvider 到 config/app.php 文件的 providers 列表中。完成了这些后我们需要清空缓存:

php artisan config:clear

就是这样

现在你已经成功实现了 repository 设计模式,不是很难吧?

你可以选择增加一些路由和视图来拓展代码,但本文将在这里结束,因为本文主要是介绍 repository 设计模式的。

原文地址:https://itnext.io/repository-design-pattern-done-right-in-laravel-d177b5fa75d4

Tags: Laravel5.8 Repository

分享到: