Das kürzlich beliebte Laravel-Repository-Muster (Repository)

Die folgende Tutorial-Kolumne von Das kürzlich beliebte Laravel-Repository-Muster (Repository) stellt Ihnen den Das kürzlich beliebte Laravel-Repository-Muster (Repository)-Repository-Modus vor (Repository). Ich hoffe, dass er für alle hilfreich ist!

                                                                                                                                       

• 1. Repository-Muster (Repository) in Das kürzlich beliebte Laravel-Repository-Muster (Repository)
• 2. Warum Repository-Muster (Repository) in Das kürzlich beliebte Laravel-Repository-Muster (Repository) verwenden?

In den meisten Webanwendungen macht der Zugriff auf die Datenbank einen großen Teil der Codebasis aus. Um unsere Anwendungslogik nicht mit SQL-Abfragen zu überladen, setzen wir auf Abstraktionen, die die Datenzugriffsmechanismen hinter PHP-Methoden verbergen.

Es gibt mehrere Modi für den strukturierten Datenzugriff, „Active Record“ und „Repository“ sind die beiden bekanntesten. In diesem Blogbeitrag werde ich sie speziell im Kontext des Das kürzlich beliebte Laravel-Repository-Muster (Repository)-Frameworks erläutern. Die Vor- und Nachteile der Verwendung des Repository-Musters werden in einem separaten Blogbeitrag erläutert.

Active Record

Standardmäßig verwendet Das kürzlich beliebte Laravel-Repository-Muster (Repository) den Active Record-Modus. Jeder Das kürzlich beliebte Laravel-Repository-Muster (Repository)-Programmierer verwendet es intuitiv, da es in der abstrakten Model-Basisklasse implementiert ist, von der Modelle normalerweise erben. Schauen wir uns ein Beispiel an:

use Illuminate\Database\Eloquent\Model;

/**
 * @property int    $id
 * @property string $first_name
 * @property string $last_name
 */
class Person extends Model {
}

// --- 使用：

$person = new Person();
$person->first_name = 'Jack';
$person->last_name = 'Smith';
$person->save();

Natürlich können Sie Eigenschaften lesen und schreiben, die Sie auf Person erstellen. Um das Modell zu speichern, können Sie aber auch Person 上创建的属性。 但是要保存模型，您也可以 直接在模型上调用方法。 不需要另一个对象——模型已经提供了访问相应数据库表的所有方法。

这意味着，域模型将您的自定义属性和方法与同一类中的所有数据访问方法相结合。 第二部分是通过继承 Model 来实现的。

要点：

• Active Record 结合 域模型与数据访问功能。
• Das kürzlich beliebte Laravel-Repository-Muster (Repository) 使用 Active Record 模式并通过 Model 类实现它。

Repository

Repository 模式是 Active Record 模式的替代方案。它还提供了处理数据访问的抽象。但更广泛地说，它可以被视为域对象的概念性存储库或集合。

与活动记录模式相反，存储模式将数据库访问与域模型分离。它提供了一个高级接口，你可以在其中创建、读取、更新和删除域模型，而不必考虑实际的底层数据存储。

底层的存储库可以通过构建和执行 SQL 查询访问数据库，通过 REST APIMethoden direkt auf dem Modell aufrufen

. Es ist kein weiteres Objekt erforderlich – das Modell stellt bereits alle Methoden bereit, um auf die entsprechende Datenbanktabelle zuzugreifen.

Das bedeutet, dass das Domänenmodell Ihre benutzerdefinierten Eigenschaften und Methoden mit allen Datenzugriffsmethoden in derselben Klasse kombiniert. Der zweite Teil wird durch die Vererbung von Model erreicht.

Wichtige Punkte:
• Active Record
• kombiniert Domänenmodell und Datenzugriffsfunktionen.

Das kürzlich beliebte Laravel-Repository-Muster (Repository) verwendet das Active Record-Muster und implementiert es über die Klasse Model.

Repository

Das Repository-Muster ist eine Alternative zum Active Record-Muster. Es bietet auch Abstraktionen für die Handhabung des Datenzugriffs.

Aber im weiteren Sinne kann es als konzeptionelles Repository oder als Sammlung von Domänenobjekten betrachtet werden.

Im Gegensatz zum aktiven Datensatzmuster trennt das Speichermuster den Datenbankzugriff vom Domänenmodell. Es bietet eine High-Level-Schnittstelle, über die Sie Domänenmodelle erstellen, lesen, aktualisieren und löschen können, ohne sich um den eigentlichen zugrunde liegenden Datenspeicher kümmern zu müssen.

Das zugrunde liegende Repository kann durch Erstellen und Ausführen von SQL-Abfragen auf Datenbanken zugreifen, über die REST-API auf Remote-Systeme zugreifen oder einfach In-Memory-Datenstrukturen verwalten, die alle Domänenmodelle enthalten. Dies ist zum Testen nützlich. Der wichtigste Teil des Repository-Musters ist die High-Level-Schnittstelle, die es zum Rest des Codes bereitstellt.

Wichtige Punkte:

• Repository stellt eine konzeptionelle Sammlung von Domänenobjekten dar.
• Es ist nur für die Kapselung des Datenzugriffs mit High-Level-Schnittstellen verantwortlich. Das kürzlich beliebte Laravel-Repository-Muster (Repository) stellt keine spezifischen Helfer für die Implementierung des Repository-Musters zur Verfügung.
• Wenn es um die Implementierung des Repository-Musters in Das kürzlich beliebte Laravel-Repository-Muster (Repository) geht, sehe ich hauptsächlich zwei Varianten.
Variante 1: Spezifische Methode

In der ersten Variante ist die Repository-Methode fokussiert und spezifisch. Der Name erklärt, was der Aufrufer erhält, und die Möglichkeiten zur Parametrisierung der zugrunde liegenden Abfrage sind begrenzt.

class InvoiceRepository {

    public function findAllOverdue(Carbon $since, int $limit = 10): Collection {
        return Invoice::where('overdue_since', '>=', $since)
            ->limit($limit)
            ->orderBy('overdue_since')
            ->get();
    }

    public function findInvoicedToCompany(string $companyId): Collection {
        return Invoice::where('company_id', $companyId)
            ->orderByDesc('created_at')
            ->get();
    }
}

Der Vorteil dieser Methode ist die Aussagekraft der Methode. Beim Lesen des Codes wird klar, was man von den Methoden erwarten kann und wie man sie aufruft. Dies führt zu weniger Fehlern. Repository-Methoden sind einfach zu testen, da sie über begrenzte Parameter verfügen. Ein Nachteil dieses Ansatzes besteht darin, dass Sie möglicherweise eine große Anzahl von Methoden im Repository verwenden. Da Methoden nicht einfach wiederverwendet werden können, müssen für neue Anwendungsfälle zusätzliche Methoden hinzugefügt werden.

Punkte:

🎜🎜Speicherschema kann durch Klassen implementiert werden, die spezifische Methoden bereitstellen🎜🎜Jede Methode umschließt eine Abfrage und stellt nur die notwendigen Parameter bereit🎜🎜🎜Vorteile:🎜Lesbarkeit und Testbarkeit🎜🎜🎜 Nachteile: 🎜 Mangelnde Flexibilität und geringere Wiederverwendbarkeit 🎜🎜🎜Variante 2: Allgemeine Methode 🎜🎜Ein Ansatz hingegen besteht darin, eine allgemeine Methode bereitzustellen. Dies führte zu einer Reduzierung der Methoden. 🎜Aber diese Methoden haben eine große API-Oberfläche🎜, da jede Methode mit unterschiedlichen Parameterkombinationen aufgerufen werden kann. 🎜🎜🎜Das zentrale Thema ist die Parameterdarstellung🎜. Diese Darstellung soll Aufrufern dabei helfen, Methodensignaturen zu verstehen und ungültige Eingaben zu vermeiden. Dazu können Sie eine spezielle Klasse einführen, beispielsweise mithilfe des Query Object-Musters. 🎜

但是我在实践中经常看到的是标量参数和 PHP 数组的混合。调用方可以传递完全无效的输入，仅类型数据并不能说明要传递什么。但是如果使用得当，这种轻量级的方法可以避免更繁琐的抽象。

class InvoiceRepository {

    public function find(array $conditions, string $sortBy = 'id', string $sortOrder = 'asc', int $limit = 10): Collection {
        return Invoice::where($conditions)
            ->orderBy($sortBy, $sortOrder)
            ->limit($limit)
            ->get();
    }
}

// --- 使用:

$repo = new InvoiceRepository();
$repo->find(['overdue_since', '>=', $since], 'overdue_since', 'asc');
$repo->find(['company_id', '=', $companyId], 'created_at', 'asc', 100);

这种方法减轻了第一种方法的问题：你可以得到更少的 Repository 方法，这些方法更灵活，并且可以更频繁地重用。

从消极的方面看，Repository 变得更加难以测试，因为有更多的案例需要覆盖。方法签名更难理解，正因为如此，调用者可能会犯更多错误。此外，还将引入某种查询对象表示形式。无论它是显式的还是隐式的（比如数组），您的 Repository 实现及其调用者都将与它耦合。

要点:

• 存储库模式可以通过提供通用方法的类实现。
• 难点在于方法参数的表示。
• 优点: 更大的灵活性和更高的可复用性。
• 缺点: 更难测试，可读性差，与参数表示耦合。

当然，这两种方法可以结合起来使用。也许你想要一些特定的方法用于复杂的查询，而一些通用的方法用于简单的 where 查询。

实现

现在，我们来谈谈如何实现方法体。

在上面的例子中，我使用了 Model 类的方法来获得对 Eloquent 查询构造器的访问。所以 Repository 的实现实际上使用了 Active Record 模式作为实现。

你不需要这样做。你可以使用 DB facade 来获得一个查询构建器，同时避免使用 Model 类。或者你可以直接编写 SQL 查询：

class InvoiceRepository {

    public function findAllOverdue(Carbon $since, int $limit = 10): Collection {
        return DB::table('invoices')
            ->where('overdue_since', '>=', $since)
            ->limit($limit)
            ->orderBy('overdue_since')
            ->get();
    }

    public function findInvoicedToCompany(string $companyId): Collection {
        return DB::select('SELECT * FROM invoices
                           WHERE company_id = ?
                           ORDER BY created_at
                           LIMIT 100', [$companyId]);
    }
}

存储模式的优点是，实现可以是任何东西，只要它满足接口。你还可以管理内存中的对象或者包（和缓存）一个 API。

但是最常见的是，底层数据存储是一个 SQL 数据库。要访问它，你可以根据每个方法选择最佳实现。对于性能关键的或者复杂的查询，你可能希望直接使用 SQL 语句。更简单的查询可以使用 Eloquent 查询生成器。

当你没有使用 模型 类来实现你的 Repository ，你可能会考虑在模型中不继承它。但是这个方法违反了很多内置的 Das kürzlich beliebte Laravel-Repository-Muster (Repository) 魔术方法，在我看来并不是一个好的方法。

要点:

• 存储库模式很灵活，允许使用各种实现技术。
• 在 Das kürzlich beliebte Laravel-Repository-Muster (Repository) 中，当访问数据库时，Eloquent 查询构建器是一个实用的选择。

接口

你的另一个选择是，是否要引入一个接口。上面的例子可以用一个接口和一个或多个实现来分隔：

// --- 接口:

public interface InvoiceRepositoryInterface {

    public function findAllOverdue(Carbon $since, int $limit = 10): Collection;

    public function findInvoicedToCompany(string $companyId): Collection;
}

// --- 具体的类，实现了该接口

class InvoiceRepository implements InvoiceRepositoryInterface {

    public function findAllOverdue(Carbon $since, int $limit = 10): Collection {
        // 实现
    }

    public function findInvoicedToCompany(string $companyId): Collection {
        // 实现
    }
}

添加接口是一种额外的间接方法，并不一定是好的。如果您的应用程序是 Repository 的唯一用户，并且您不希望它有多个实现，那么我不认为引入接口有什么意义。对于测试，Repository 可以用 PHPUnit 模拟，只要它不被标记为 final。

如果你知道你将有多个实现，你应该使用一个接口。如果你正在编写一个将在多个项目中使用的 包。或者你想要测试一个特殊的 Repository 实现，那么可能会发生不同的实现。

为了从 Das kürzlich beliebte Laravel-Repository-Muster (Repository) 的依赖注入中获益，你必须将具体的实现绑定到接口上。这必须在服务提供者的注册方法中完成。

use Illuminate\Support\ServiceProvider;

class RepositoryServiceProvider extends ServiceProvider {

    public function register(): void {
        $this->app->bind(InvoiceRepositoryInterface::class, InvoiceRepository::class);
    }
}

要点:

• 一个接口可以进一步 解耦 从代码的其余部分获取代码库。
•  当您期望有多个具体类实现它时，使用 Repository 接口。
• 在 Das kürzlich beliebte Laravel-Repository-Muster (Repository) 中，将具体类绑定到服务提供者中的接口。

原文地址：https://dev.to/davidrjenni/repository-pattern-in-laravel-1pph

译文地址：https://learnku.com/laravel/t/62587

Das obige ist der detaillierte Inhalt vonDas kürzlich beliebte Laravel-Repository-Muster (Repository). Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!