La colonne tutorielle suivante de Le modèle de référentiel Laravel récemment populaire (Repository) vous présentera le mode référentiel Le modèle de référentiel Laravel récemment populaire (Repository) (Repository).
- 1. Modèle de référentiel (Référentiel) dans Le modèle de référentiel Laravel récemment populaire (Repository)
- 2. Pourquoi utiliser le modèle de référentiel (Référentiel) dans Le modèle de référentiel Laravel récemment populaire (Repository) ?
Dans la plupart des applications Web, l'accès à la base de données représente une grande partie de la base de code. Pour éviter d'encombrer notre logique applicative avec des requêtes SQL, nous nous appuyons sur des abstractions, qui cachent les mécanismes d'accès aux données derrière les méthodes PHP.
Il existe plusieurs modes d'accès structuré aux données, "Active Record" et "Repository" sont les deux plus connus. Dans cet article de blog, je les expliquerai spécifiquement dans le contexte du framework Le modèle de référentiel Laravel récemment populaire (Repository). La discussion sur les avantages et les inconvénients de l’utilisation du modèle Repository sera abordée dans un article de blog séparé.
Par défaut, Le modèle de référentiel Laravel récemment populaire (Repository) utilise le mode Active Record. Chaque programmeur Le modèle de référentiel Laravel récemment populaire (Repository) l'utilise de manière intuitive car il est implémenté dans la classe de base abstraite Model, dont les modèles héritent généralement. Regardons un exemple :
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(); Bien sûr, vous pouvez lire et écrire les propriétés que vous créez sur Person. Mais pour sauvegarder le modèle, vous pouvez aussi Person 上创建的属性。 但是要保存模型，您也可以 直接在模型上调用方法。 不需要另一个对象——模型已经提供了访问相应数据库表的所有方法。
这意味着，域模型将您的自定义属性和方法与同一类中的所有数据访问方法相结合。 第二部分是通过继承 Model 来实现的。
要点：
Model 类实现它。Repository 模式是 Active Record 模式的替代方案。它还提供了处理数据访问的抽象。但更广泛地说，它可以被视为域对象的概念性存储库或集合。
与活动记录模式相反，存储模式将数据库访问与域模型分离。它提供了一个高级接口，你可以在其中创建、读取、更新和删除域模型，而不必考虑实际的底层数据存储。
底层的存储库可以通过构建和执行 SQL 查询访问数据库，通过 REST APIappeler des méthodes directement sur le modèle
Cela signifie que le modèle de domaine combine vos propriétés et méthodes personnalisées avec toutes les méthodes d'accès aux données de la même classe. La deuxième partie est réalisée en héritant du Model.
Le modèle de référentiel Laravel récemment populaire (Repository) utilise le modèle Active Record et l'implémente via la classe Model.
Mais plus largement, il peut être considéré comme un référentiel conceptuel ou une collection d'objets de domaine.
Contrairement au modèle d'enregistrement actif, le modèle de stockage sépare l'accès à la base de données du modèle de domaine. Il fournit une interface de haut niveau dans laquelle vous pouvez créer, lire, mettre à jour et supprimer des modèles de domaine sans avoir à vous soucier du magasin de données sous-jacent réel.Le référentiel sous-jacent peut accéder aux bases de données en créant et en exécutant des requêtes SQL, accéder aux systèmes distants via l'API REST ou simplement gérer les structures de données en mémoire qui contiennent tous les modèles de domaine. Ceci est utile pour les tests. L'élément clé du modèle de référentiel est l'interface de haut niveau qu'il fournit au reste du code.
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();
}
}Points :
🎜🎜🎜Le schéma de stockage peut être implémenté par des classes qui fournissent des méthodes spécifiques🎜🎜Chaque méthode encapsule une requête, exposant uniquement les paramètres nécessaires🎜🎜🎜Avantages :🎜Lisibilité et testabilité🎜🎜🎜 Inconvénients : 🎜 Manque de flexibilité et réutilisabilité moindre 🎜🎜🎜Variation 2 : Méthode générale 🎜🎜Une approche, en revanche, consiste à fournir une méthode générale. Cela a entraîné une réduction des méthodes. 🎜Mais ces méthodes ont une grande surface API🎜, puisque chaque méthode peut être appelée avec différentes combinaisons de paramètres. 🎜🎜🎜Le problème clé est la représentation des paramètres🎜. Cette représentation doit guider les appelants dans la compréhension des signatures de méthode et éviter les entrées non valides. Pour ce faire, vous pouvez introduire une classe spéciale, par exemple en utilisant le modèle Query Object. 🎜但是我在实践中经常看到的是标量参数和 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 ，你可能会考虑在模型中不继承它。但是这个方法违反了很多内置的 Le modèle de référentiel Laravel récemment populaire (Repository) 魔术方法，在我看来并不是一个好的方法。
要点:
你的另一个选择是，是否要引入一个接口。上面的例子可以用一个接口和一个或多个实现来分隔：
// --- 接口:
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 实现，那么可能会发生不同的实现。
为了从 Le modèle de référentiel Laravel récemment populaire (Repository) 的依赖注入中获益，你必须将具体的实现绑定到接口上。这必须在服务提供者的注册方法中完成。
use Illuminate\Support\ServiceProvider;
class RepositoryServiceProvider extends ServiceProvider {
public function register(): void {
$this->app->bind(InvoiceRepositoryInterface::class, InvoiceRepository::class);
}
}要点:
原文地址：https://dev.to/davidrjenni/repository-pattern-in-laravel-1pph
译文地址：https://learnku.com/laravel/t/62587
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!
Introduction aux composants Laravel
Introduction au middleware Laravel
Quels sont les modèles de conception utilisés par Laravel ?
Lequel est le plus simple, thinkphp ou laravel ?
Tutoriel Laravel
La différence entre * et & en langage C
Programmation en langage de haut niveau
Qu'est-ce que le routage logiciel
![[Web front-end] Démarrage rapide de Node.js](https://img.php.cn/upload/course/000/000/067/662b5d34ba7c0227.png)
