站長資訊網
Laravel 9 保姆級視頻教程，想學不會都難！進入學習
在本文中，我會向你展示如何在 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 IlluminateSupportFacadesSchema; use IlluminateDatabaseSchemaBlueprint; use IlluminateDatabaseMigrationsMigration; 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_repositoryDB_USERNAME=rootDB_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 AppRepositoriesInterfaces; use AppUser; interface BlogRepositoryInterface { public function all(); public function getByUser(User $user); }
我們需要創建的最后一個類是將要實現 BlogRepositoryInterface 的 BlogRepository ，我們會寫一個最簡單的實現方式。
<?php namespace AppRepositories; use AppModelsBlog; use AppUser; use AppRepositoriesInterfacesBlogRepositoryInterface; 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 AppHttpControllers; use AppRepositoriesInterfacesBlogRepositoryInterface; use AppUser; 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 AppProviders; use AppRepositoriesBlogRepository; use AppRepositoriesInterfacesBlogRepositoryInterface; use IlluminateSupportServiceProvider; class RepositoryServiceProvider extends ServiceProvider { public function register() { $this->app->bind( BlogRepositoryInterface::class, BlogRepository::class ); } }
留意用另一個 repository 替代 BlogRepository 是多么容易！
不要忘記添加 RepositoryServiceProvider 到 config/app.php 文件的 providers 列表中。完成了這些后我們需要清空緩存：
'providers' => [ AppProvidersRepositoryServiceProvider::class ],
php artisan config:clear
就是這樣
現在你已經成功實現了 repository 設計模式，不是很難吧？
你可以選擇增加一些路由和視圖來拓展代碼，但本文將在這里結束，因為本文主要是介紹 repository 設計模式的。
如果你喜歡這篇文章，或者它幫助你實現了 repository 設計模式，請確保你也查看了我的其他文章。如果你有任何反饋、疑問，或希望我撰寫另一個有關 Laravel 的主題，請隨時發表評論。
原文地址：https://itnext.io/repository-design-pattern-done-right-in-laravel-d177b5fa75d4
譯文地址：https://learnku.com/laravel/t/31798
【
