ファクトリパターンを使用したLaravelでの動的支払プロセッサの選択

前の投稿では、Laravel で支払い処理を処理するための 2 つの異なる方法を検討しました。

• ハードコードされたサービス バインディング
• コンテキストバインディング。

どちらの方法も効果的ではありますが、実行時の条件 (ユーザー入力、構成設定など) に基づいて支払い処理業者を動的に選択する場合には制限があります。

この 3 番目の最後のパートでは、より柔軟なアプローチ、つまりファクトリー パターンの使用について見ていきます。この設計パターンにより、コンテキストに基づいて PaymentProcessorInterface の適切な実装を選択することができます (リクエストに応じて Stripe か PayPal を選択するなど)。

ファクトリ パターンの実装

ファクトリ パターンは、実行時にさまざまな実装を動的に解決するためのスケーラブルなソリューションを提供します。設定方法を段階的に説明します。

ステップ 1: ファクトリ インターフェイスを作成する

まず、さまざまな支払いプロセッサを解決する方法の概要を説明する PaymentProcessorFactoryInterface を定義しましょう。

<?php

namespace App\Contracts;

interface PaymentProcessorFactoryInterface
{
    public function getProcessor(string $provider): PaymentProcessorInterface;
}

このインターフェイスにより、作成するファクトリには getProcessor メソッドが追加され、指定された引数 (例: 'ストライプ' または 'ペイパル') に基づいて適切な支払いプロセッサを返す役割を果たします。

ステップ 2: ファクトリ実装を作成する

次に、プロバイダーの入力に基づいて適切な支払いプロセッサを解決するファクトリを実装します。

<?php

namespace App\Services;

use App\Contracts\PaymentProcessorInterface;
use App\Contracts\PaymentProcessorFactoryInterface;
use App\Services\StripePaymentProcessor;
use App\Services\PayPalPaymentProcessor;

class PaymentProcessorFactory implements PaymentProcessorFactoryInterface
{
    public function getProcessor(string $provider): PaymentProcessorInterface
    {
        switch ($provider) {
            case 'stripe':
                return new StripePaymentProcessor(); // Can be resolved via the container if needed
            case 'paypal':
                return new PayPalPaymentProcessor(); // Can also be resolved via the container
            default:
                throw new \Exception("Unsupported payment provider: $provider");
        }
    }
}

このファクトリは、実行時に提供された入力に基づいて正しい支払いプロセッサを動的に選択します。この例では、StripePaymentProcessor と PayPalPaymentProcessor の新しいインスタンスを直接返します。必要に応じて、管理を改善するために、これらのクラスを Laravel のサービス コンテナから解決することもできます。

ステップ 3: Stripe および PayPal プロセッサを実装する

PaymentProcessorInterface を実装する StripePaymentProcessor クラスと PayPalPaymentProcessor クラスの両方があることを確認してください。

例: StripePaymentProcessor

<?php

namespace App\Services;

use App\Contracts\PaymentProcessorInterface;

class StripePaymentProcessor implements PaymentProcessorInterface
{
    public function createPayment(float $amount, string $currency, array $paymentDetails): array
    {
        // Stripe-specific implementation
    }

    public function processPayment(array $paymentData): array
    {
        // Stripe-specific implementation
    }

    public function refundPayment(string $transactionId, float $amount): bool
    {
        // Stripe-specific implementation
    }
}

例: PayPalPaymentProcessor

同様に、StripePaymentProcessor と同じパターンに従って PayPalPaymentProcessor クラスを実装します。

ステップ 4: サービス コンテナでファクトリをバインドする

Laravel アプリケーション全体でファクトリーを利用できるようにするには、PaymentProcessorFactory を Laravel のサービスコンテナにバインドする必要があります。これは AppServiceProvider で行うことができます。

AppProvidersAppServiceProvider.php の register メソッド内に次のコードを追加します。

public function register()
{
    $this->app->singleton(\App\Contracts\PaymentProcessorFactoryInterface::class, \App\Services\PaymentProcessorFactory::class);
}

このバインディングは、PaymentProcessorFactoryInterface がリクエストされるたびに PaymentProcessorFactory を使用するように Laravel に指示し、アプリケーション全体でファクトリのインスタンスが 1 つだけ存在するようにします。

ステップ 5: コントローラーでのファクトリーの使用

ファクトリが設定されたので、それをコントローラーに挿入して、リクエスト入力などの実行時データに基づいて適切な支払いプロセッサを動的に選択できます。

例: PaymentController

<?php

namespace App\Http\Controllers;

use App\Contracts\PaymentProcessorFactoryInterface;
use Illuminate\Http\Request;

class PaymentController extends Controller
{
    protected $paymentProcessorFactory;

    public function __construct(PaymentProcessorFactoryInterface $paymentProcessorFactory)
    {
        $this->paymentProcessorFactory = $paymentProcessorFactory;
    }

    public function makePayment(Request $request)
    {
        $provider = $request->input('provider'); // E.g., 'stripe' or 'paypal'
        $amount = $request->input('amount');
        $currency = $request->input('currency');
        $paymentDetails = $request->input('details');

        // Get the appropriate payment processor based on the provider
        $paymentProcessor = $this->paymentProcessorFactory->getProcessor($provider);

        // Use the selected payment processor to create a payment
        $response = $paymentProcessor->createPayment($amount, $currency, $paymentDetails);

        return response()->json($response);
    }
}

このコントローラーでは、依存関係注入を通じて PaymentProcessorFactoryInterface を注入します。支払いがリクエストされると、リクエストから支払いプロバイダー (Stripe や PayPal など) を特定し、それを工場に渡し、適切な支払いプロセッサを動的に解決します。

ステップ 6: さまざまな決済プロバイダーの処理

この設定では、コントローラーはリクエスト内のプロバイダー名を切り替えるだけで、さまざまな支払いプロバイダーを動的に処理できるようになりました。この方法は、ロジックを重複させたり、コードを特定の実装に緊密に結合したりせずに、複数の支払いゲートウェイを処理する必要がある場合に特に強力です。

結論

Laravel 11 でファクトリー パターンを使用すると、実行時にさまざまな支払いプロセッサを選択するための非常に柔軟なアプローチが提供されます。ここで説明した手順の概要は次のとおりです。

• Interface et implémentation d'usine : création d'une usine qui résout dynamiquement le processeur de paiement correct en fonction d'une entrée de chaîne.
• Implémentations du processeur : garantie que les classes StripePaymentProcessor et PayPalPaymentProcessor implémentent PaymentProcessorInterface.
• Liaison du conteneur de service : reliez l'usine dans le conteneur de service pour permettre une injection facile tout au long de l'application. Sélection dynamique dans les contrôleurs : utilisation de l'usine à l'intérieur d'un contrôleur pour sélectionner et utiliser dynamiquement le processeur de paiement approprié en fonction des données d'exécution.

Principes de conception de logiciels et modèles de conception

Nous avons commencé ce tutoriel en 3 parties en utilisant un seul processeur de paiement, avec une sélection codée en dur, puis nous avons utilisé une configuration dans le code ("temps de compilation") en utilisant Laravel Service Container Binding, puis dans cette partie nous avons continué à refactoriser avec le design principes et modèles de conception à l'esprit, ce qui nous a permis de refactoriser le code, obtenant :

• Flexibilité dynamique : le modèle d'usine permet la sélection de différents processeurs de paiement au moment de l'exécution, ce qui rend votre application plus flexible et évolutive.
• Couplage lâche : en injectant l'usine, vos contrôleurs sont faiblement couplés aux processeurs de paiement, ce qui facilite l'ajout ou le remplacement de passerelles de paiement à l'avenir.
• Maintenabilité : cette approche fournit une base de code plus propre et plus maintenable, en particulier lorsqu'il s'agit de plusieurs options de paiement.

Avec cette configuration, nous disposons désormais d'un système puissant et flexible pour gérer les paiements dans Laravel. Si nous avons besoin de prendre en charge des processeurs supplémentaires, nous pouvons facilement étendre l'usine pour prendre en charge et modifier la logique de sélection des fournisseurs, et gérer différents scénarios de logique métier.

以上がファクトリパターンを使用したLaravelでの動的支払プロセッサの選択の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。