Il y a quelques jours, je réparais un test instable, et il s'est avéré que j'avais besoin de valeurs et au sein de mon usine. Laravel enveloppe FakerPHP, auquel nous accédons habituellement via l'assistant . FakerPHP est livré avec des modificateurs comme et , mais vous ne pouvez en utiliser qu'un seul à la fois, vous ne pouvez donc pas faire , ce qui est exactement ce dont j'avais besoin. uniques valides fake() valid() unique() fake()->unique()->valid() Cela m'a fait réfléchir : et si nous voulions créer notre propre modificateur ? Par exemple, ou tout autre modificateur. Comment pouvons-nous le cadre ? uniqueAndValid() étendre Penser a voix haute Je vais abandonner le fil de mes pensées. Avant de me lancer dans une solution trop sophistiquée, je veux toujours vérifier s'il existe une option plus simple et comprendre à quoi j'ai affaire. Jetons donc un coup d'œil à l'assistant : fake() function fake($locale = null) { if (app()->bound('config')) { $locale ??= app('config')->get('app.faker_locale'); } $locale ??= 'en_US'; $abstract = \Faker\Generator::class.':'.$locale; if (! app()->bound($abstract)) { app()->singleton($abstract, fn () => \Faker\Factory::create($locale)); } return app()->make($abstract); } En lisant le code, nous pouvons voir que Laravel lie un singleton au conteneur. Cependant, si nous inspectons le résumé, il s'agit d'une classe normale qui n'implémente aucune interface et l'objet est créé via une usine. Cela complique les choses. Pourquoi? Parce que s'il s'agissait d'une interface, nous pourrions simplement créer une nouvelle classe qui étend la classe de base , ajouter de nouvelles fonctionnalités et la relier au conteneur. Mais nous n'avons pas ce luxe. \Faker\Generator Il y a une usine impliquée. Cela signifie qu'il ne s'agit pas d'une simple instanciation ; il y a une certaine logique en cours. Dans ce cas, l'usine ajoute quelques fournisseurs (PhoneNumber, Text, UserAgent, etc.). Ainsi, même si nous essayons de relier à nouveau, nous devrons utiliser l'usine, qui renverra le original. \Faker\Generator Des solutions 🤔 ? On pourrait se demander : « Qu'est-ce qui nous empêche de créer notre propre usine qui retourne le nouveau générateur comme indiqué au point 1 ? Eh bien, rien, nous pouvons faire ça, mais nous ne le ferons pas ! Nous utilisons un framework pour plusieurs raisons, l'une d'entre elles étant les mises à jour. Que se passera-t-il si FakerPHP ajoute un nouveau fournisseur ou propose une mise à niveau majeure ? Laravel ajustera le code et les personnes qui n'ont apporté aucune modification ne remarqueront rien. Cependant, nous serions exclus et notre code pourrait même se briser (très probablement). Alors oui, nous ne voulons pas aller aussi loin. Alors que faisons-nous? Maintenant que nous avons exploré les options de base, nous pouvons commencer à penser à des options plus avancées, comme les modèles de conception. Nous n'avons pas besoin d'une implémentation exacte, juste de quelque chose de familier avec notre problème. C'est pourquoi je dis toujours qu'il est bon de les connaître. Dans ce cas, on peut « décorer » la classe en ajoutant de nouvelles fonctionnalités tout en conservant les anciennes. Ça a l'air bien? Voyons comment ! Generator Tout d'abord, créons une nouvelle classe, : FakerGenerator <?php namespace App\Support; use Closure; use Faker\Generator; use Illuminate\Support\Traits\ForwardsCalls; class FakerGenerator { use ForwardsCalls; public function __construct(private readonly Generator $generator) { } public function uniqueAndValid(Closure $validator = null): UniqueAndValidGenerator { return new UniqueAndValidGenerator($this->generator, $validator); } public function __call($method, $parameters): mixed { return $this->forwardCallTo($this->generator, $method, $parameters); } } Ce sera notre "décorateur" (un peu). Il s'agit d'une classe simple qui attend le de base comme dépendance et introduit un nouveau modificateur, . Il utilise également le trait de Laravel, qui lui permet de transmettre des appels proxy à l'objet de base. Generator uniqueAndValid() ForwardsCalls Ce trait a deux méthodes : et . Utilisez ce dernier lorsque vous souhaitez enchaîner des méthodes sur l'objet décoré. Dans notre cas, nous aurons toujours un seul appel. forwardCallTo forwardDecoratedCallTo Nous devons également implémenter , qui est le modificateur personnalisé, mais ce n'est pas le but de l'article. Si vous êtes intéressé par l'implémentation, cette classe est essentiellement un mélange de et fournis avec FakerPHP, vous pouvez la trouver . UniqueAndValidGenerator ValidGenerator UniqueGenerator ici Maintenant, le framework, dans : étendons AppServiceProvider <?php namespace App\Providers; use Closure; use Faker\Generator; use App\Support\FakerGenerator; use Illuminate\Support\ServiceProvider; class AppServiceProvider extends ServiceProvider { public function register(): void { $this->app->extend( $this->fakerAbstractName(), fn (Generator $base) => new FakerGenerator($base) ); } private function fakerAbstractName(): string { // This is important, it matches the name bound by the fake() helper return Generator::class . ':' . app('config')->get('app.faker_locale'); } } La méthode vérifie si un résumé correspondant au nom donné a été lié au conteneur. Si tel est le cas, il remplace sa valeur par le résultat de la fermeture, jetez un œil : extend() // Laravel: src/Illuminate/Container/Container.php public function extend($abstract, Closure $closure) { $abstract = $this->getAlias($abstract); if (isset($this->instances[$abstract])) { // You are interested here $this->instances[$abstract] = $closure($this->instances[$abstract], $this); $this->rebound($abstract); } else { $this->extenders[$abstract][] = $closure; if ($this->resolved($abstract)) { $this->rebound($abstract); } } } C'est pourquoi nous avons défini la méthode , qui génère le même nom que la liaison d'assistance dans le conteneur. fakerAbstractName() fake() Revérifiez le code ci-dessus si vous l'avez manqué, j'ai laissé un commentaire. Désormais, chaque fois que nous appellerons , une instance de sera renvoyée et nous aurons accès au modificateur personnalisé que nous avons introduit. Chaque fois que nous invoquons un appel qui n'existe pas sur la classe , sera déclenché et il le transmettra au de base en utilisant la méthode . fake() FakerGenerator FakerGenerator __call() Generator forwardCallTo() C'est ça! Je peux enfin faire , et ça fonctionne à merveille ! fake()->uniqueAndValid()->randomElement() Avant de conclure, je tiens à souligner qu’il ne s’agit pas d’un pur motif de décorateur. Cependant, les modèles ne sont pas des textes sacrés ; ajustez-les pour les adapter à vos besoins et résoudre le problème. Conclusion Les frameworks sont incroyablement utiles et Laravel est livré avec de nombreuses fonctionnalités intégrées. Cependant, ils ne peuvent pas couvrir tous les cas extrêmes de vos projets et vous risquez parfois de vous retrouver dans une impasse. Lorsque cela se produit, vous pouvez toujours étendre le framework. Nous avons vu à quel point c'est simple, et j'espère que vous avez compris l'idée principale, qui s'applique au-delà de cet exemple Faker. Commencez toujours simplement et recherchez la solution la plus simple au problème. La complexité viendra quand cela sera nécessaire, donc si l'héritage de base fait l'affaire, il n'est pas nécessaire d'implémenter un décorateur ou quoi que ce soit d'autre. Lorsque vous étendez le cadre, assurez-vous de ne pas aller trop loin, où la perte l'emporte sur le gain. Vous ne voulez pas finir par gérer vous-même une partie du framework.
