So implementieren Sie das Repository-Entwurfsmuster in Laravel

In diesem Artikel zeige ich Ihnen, wie Sie das Repository-Entwurfsmuster von Grund auf in Laravel implementieren. Ich werde Laravel Version 5.8.3 verwenden, aber die Laravel-Version ist nicht die wichtigste. Bevor Sie mit dem Schreiben von Code beginnen, müssen Sie einige Informationen über das Repository-Entwurfsmuster kennen.

repository Mit Entwurfsmustern können Sie mit Objekten arbeiten, ohne zu wissen, wie diese Objekte beibehalten werden. Im Wesentlichen handelt es sich um eine Abstraktion der Datenschicht.

Das bedeutet, dass Ihre Geschäftslogik nicht wissen muss, wie sie die Daten abruft oder was die Datenquelle ist. Die Geschäftslogik verlässt sich auf das Repository, um die richtigen Daten abzurufen.

Was dieses Muster betrifft, habe ich gesehen, dass jemand es missverstanden hat als das Repository, das zum Erstellen oder Aktualisieren von Daten verwendet wird. Das ist nicht das, was repository tun soll. repository soll keine Daten erstellen oder aktualisieren, sondern nur Daten abrufen.

Verstehst du? Lasst uns gemeinsam Code schreiben

Da wir bei Null anfangen, erstellen wir ein neues Laravel-Projekt:

composer create-project --prefer-dist laravel/laravel repository

Für dieses Tutorial erstellen wir eine kleine Blogging-Anwendung. Nachdem wir nun ein neues Laravel-Projekt erstellt haben, sollten wir einen Controller und ein Modell dafür erstellen.

php artisan make:controller BlogController

Dadurch wird der BlogController im Verzeichnis app/Http/Controllers erstellt.

php artisan make:model Models/Blog -m

Tipps: Die Option
-m erstellt eine entsprechende Datenbankmigration. Sie finden die generierte Migration im Verzeichnis *database/migrations-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(&#39;blogs&#39;, function (Blueprint $table) {
            $table->bigIncrements(&#39;id&#39;);
            $table->string(&#39;title&#39;);
            $table->text(&#39;content&#39;);
            $table->integer(&#39;user_id&#39;);
            $table->timestamps();

            $table->foreign(&#39;user_id&#39;)
                  ->references(&#39;id&#39;)
                  ->on(&#39;users&#39;);
        });
    }

    public function down()
    {
        Schema::dropIfExists(&#39;blogs&#39;);
    }
}

提示：
如果你使用的是 Laravel 5.8 以下的旧版本，请将

$table->bigIncrements('id');

替换为：

$table->increments('id');

设置数据库

我将使用 MySQL. *

Jetzt sollten Sie das neu generierte Modell Blog im Verzeichnis app/Models finden können. Dies ist einfach eine Art, wie ich meine Modelle gerne aufbewahre.

Da wir nun unseren Controller und unser Modell haben, ist es an der Zeit, einen Blick auf die von uns erstellte Migrationsdatei zu werfen. Zusätzlich zum standardmäßigen Laravel-Zeitstempelfeld benötigt unser Blog nur die Felder „Titel“, „Inhalt“ und „Benutzer-ID“.

mysql -u root -p 
create database laravel_repository;

Tipp:

Wenn Sie eine ältere Version von Laravel unter 5.8 verwenden, ersetzen Sie bitte

DB_DATABASE=laravel_repositoryDB_USERNAME=rootDB_PASSWORD=secret

durch:

php artisan config:clear

Richten Sie die Datenbank ein Ich werde My verwenden SQL< /code>Datenbank Als Beispiel besteht der erste Schritt darin, eine neue Datenbank zu erstellen.

php artisan migrate

Der obige Befehl erstellt eine neue Datenbank namens laravel_repository

. Als nächstes müssen wir Datenbankinformationen zur Datei

.env im Laravel-Stammverzeichnis hinzufügen.

<?php

namespace App\Repositories\Interfaces;

use App\User;

interface BlogRepositoryInterface
{
    public function all();

    public function getByUser(User $user);
}

Nachdem Sie die Datei .env aktualisiert haben, müssen wir den Cache leeren:

<?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(&#39;user_id&#39;,$user->id)->get();
    }
}

Migration ausführenDa wir nun die Datenbank eingerichtet haben, können wir mit der Migration beginnen:

app/└── Repositories/
    ├── BlogRepository.php
    └── Interfaces/
        └── BlogRepositoryInterface.php

Dadurch wird die Tabelle „Blogs“ erstellt, die die Felder „Titel“, „Inhalt“ und „Benutzer-ID“ enthält, die wir bei der Migration deklariert haben.

Implementierung des Repository-DesignmustersAlles ist bereit, wir können jetzt mit der Implementierung des

Repository-Designstils beginnen. Wir erstellen das Verzeichnis

Repositories
• im Verzeichnis

  app. Das zweite Verzeichnis, das wir erstellen werden, ist das Verzeichnis „Interfaces“, das sich im Verzeichnis „Repositories“ befindet.

  In der
Interfaces
• -Datei erstellen wir eine

  BlogRepositoryInterface-Schnittstelle mit zwei Methoden.

Die Methode

all, die alle Blogbeiträge zurückgibt.

Die Methode

getByUser, die alle Blogbeiträge eines bestimmten Benutzers zurückgibt Wenn Sie das BlogRepositoryInterface Repository

implementieren, schreiben wir die einfachste Implementierung.

<?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(&#39;blog&#39;)->withBlogs($blogs);
    }

    public function detail($id)
    {
        $user = User::find($id);
        $blogs = $this->blogRepository->getByUser($user);

        return view(&#39;blog&#39;)->withBlogs($blogs);
    }
}

Ihr Repositories-Verzeichnis sollte so aussehen:

php artisan make:provider RepositoryServiceProvider

Sie haben jetzt erfolgreich ein

Repository erstellt. Aber wir sind noch nicht fertig, es ist Zeit, unser Repository zu nutzen.

Mit Repository

Um

BlogRepository zu verwenden, müssen wir es zunächst in BlogController injizieren. Dank der Abhängigkeitsinjektion von Laravel können wir sie problemlos durch eine andere ersetzen. So sieht unser Controller aus:

<?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
        );
    }
}

Wie Sie sehen können, ist der Code im Controller sehr kurz und sehr gut lesbar. Sie benötigen keine zehn Codezeilen, um die benötigten Daten zu erhalten, dank 🎜repository🎜 kann die gesamte Logik in einer Codezeile ausgeführt werden. Dies eignet sich auch hervorragend für Unit-Tests, da die Methoden des 🎜Repository🎜 leicht wiederverwendbar sind. 🎜

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 列表中。完成了这些后我们需要清空缓存：

'providers' => [
  \App\Providers\RepositoryServiceProvider::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

【相关推荐：laravel视频教程】

Das obige ist der detaillierte Inhalt vonSo implementieren Sie das Repository-Entwurfsmuster in Laravel. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!