Apprenez à appliquer le modèle de conception du référentiel dans Laravel5.8

                                                     

Ci-dessous

Laravel La colonne du didacticiel vous présentera comment appliquer correctement le mode de conception du référentiel dans Laravel 5.8, j'espère que cela sera utile aux amis de besoin!

Dans cet article, je vais vous montrer comment implémenter le modèle de conception du

référentiel à partir de zéro dans Laravel. J'utiliserai la version 5.8.3 de Laravel, mais la version de Laravel n'est pas la plus importante. Avant de commencer à écrire du code, vous devez connaître quelques informations sur le modèle de conception du référentiel.

dépôt Le modèle de conception vous permet de travailler avec des objets sans savoir comment ces objets sont conservés. Il s’agit essentiellement d’une abstraction de la couche de données.

Cela signifie que votre logique métier n'a pas besoin de savoir comment récupérer les données ni quelle est la source de données, la logique métier s'appuie sur le

référentiel pour récupérer les données correctes.

Concernant ce modèle, j'ai vu que certaines personnes l'ont mal compris comme un

référentiel utilisé pour créer ou mettre à jour des données. Ce n'est pas ce que le référentiel est censé faire, le référentiel n'est pas censé créer ou mettre à jour des données, seulement les récupérer.

Vous comprenez ? Écrivons du code ensemble

Puisque nous partons de zéro, créons un nouveau projet Laravel :

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

Pour ce tutoriel, nous allons construire une petite application de blog. Maintenant que nous avons créé un nouveau projet Laravel, nous devons créer un contrôleur et un modèle pour celui-ci.

php artisan make:controller BlogController

Cela créera le

BlogController dans le répertoire app/Http/Controllers.

php artisan make:model Models/Blog -m

Astuce : L'option
créera une migration de base de données correspondante. Vous pouvez trouver la migration générée dans le répertoire *database/migrations-m. *

Vous devriez maintenant pouvoir trouver le modèle nouvellement généré

Blog dans le répertoire app/Models. C'est juste une façon dont j'aime stocker mes modèles.

Maintenant que nous avons notre contrôleur et notre modèle, il est temps de regarder le fichier de migration que nous avons créé. En plus du champ d'horodatage Laravel par défaut, notre blog n'a besoin que des champs

Titre, Contenu et ID utilisateur.

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

Astuce : Si vous utilisez une ancienne version de Laravel inférieure à 5.8, veuillez remplacer

$table->bigIncrements('id');

par :

$table->increments('id');

Configurer la base de données

Je vais utiliser la base de données

comme exemple, la première étape consiste à créer une nouvelle base de données. MySQL

mysql -u root -p 
create database laravel_repository;

La commande ci-dessus créera une nouvelle base de données appelée

laravel_repository. Ensuite, nous devons ajouter les informations de la base de données au fichier .env dans le répertoire racine de Laravel.

DB_DATABASE=laravel_repositoryDB_USERNAME=rootDB_PASSWORD=secret

Après avoir mis à jour le fichier

.env, nous devons vider le cache :

php artisan config:clear

Exécuter la migration

Maintenant nous avons Après avoir configuré la base de données, vous pouvez commencer à lancer la migration :

php artisan migrate

Cela créera la table

blogs, qui contient le titre, nous déclaré dans les champs migration content et user_id.

Implémentation du modèle de conception référentiel

Tout est prêt, nous pouvons maintenant commencer à implémenter le style de conception

référentiel. Nous allons créer le répertoire Repositories à l'intérieur du répertoire app. Le deuxième répertoire que nous allons créer est le répertoire Interfaces, qui se trouve dans le répertoire Repositories.

Dans le fichier

Interfaces nous allons créer une interface BlogRepositoryInterface avec deux méthodes.

La méthode
1. all qui renvoie tous les articles de blog
La méthode
2. getByUser qui renvoie tous les articles de blog d'un utilisateur spécifique

<?php

namespace App\Repositories\Interfaces;use App\User;interface BlogRepositoryInterface{
    public function all();

    public function getByUser(User $user);}

La dernière classe que nous devons créer est le

BlogRepository qui implémentera le BlogRepositoryInterface Nous écrirons l'implémentation la plus simple.

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

Votre répertoire

Dépôts devrait ressembler à ceci :

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

Vous avez maintenant créé avec succès un

dépôt. Mais nous n’avons pas encore fini, il est temps de commencer à utiliser notre référentiel .

在控制器中使用 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(&#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);
    }}

如你所见，控制器中的代码很简短，可读性非常的高。不需要十行代码就可以获取到所需的数据，多亏了 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 列表中。完成了这些后我们需要清空缓存：

'providers' => [
    //测试￥￥￥￥￥￥￥￥￥￥￥￥￥￥￥￥￥
  \App\Providers\RepositoryServiceProvider::class],

php artisan config:clear

就是这样

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

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

如果你喜欢这篇文章，或者它帮助你实现了 repository 设计模式，请确保你也查看了我的其他文章。如果你有任何反馈、疑问，或希望我撰写另一个有关 Laravel 的主题，请随时发表评论。

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!