En nuestra publicación anterior (Cómo agregar e implementar interfaces de procesamiento de pagos en Laravel 11: enlace codificado), exploramos el primer paso en la configuración de procesadores de pagos codificando el enlace entre PaymentProcessorInterface y una implementación específica, como StripePaymentProcessor.

Si bien este enfoque es simple y efectivo para aplicaciones pequeñas, carece de flexibilidad para escenarios más complejos en los que es posible que necesites manejar múltiples pasarelas de pago, pero al usar una interfaz, nos permitió desacoplar el código para que podamos extenderlo aún más. de acuerdo con el principio de apertura y cierre, para inyectar la funcionalidad adecuada:

• enlace contextual en tiempo de compilación, utilizando el mecanismo Laravel Service Container.
• usando el patrón de fábrica creando instancias de las clases requeridas en tiempo de ejecución.

En esta segunda parte, nos sumergiremos en el enlace contextual, una técnica más avanzada en el contenedor de servicios de Laravel que le permite inyectar diferentes implementaciones de una interfaz según el contexto específico. Esto es útil cuando la elección de un procesador de pagos depende del estado de la aplicación, como por ejemplo qué controlador maneja la solicitud.

Paso 1: comprender el enlace contextual

El enlace contextual en Laravel permite que el contenedor de servicios inyecte diferentes implementaciones de una interfaz dependiendo de la clase o contexto que la solicite. En lugar de depender de una implementación única codificada, podemos usar enlaces contextuales para resolver diferentes procesadores de pagos según el controlador o algún otro factor contextual.

Paso 2: enlace contextual en AppServiceProvider

Comencemos configurando enlaces contextuales en AppServiceProvider. Vincularemos diferentes procesadores de pagos según el controlador que los solicite. Por ejemplo, StripePaymentController utilizará StripePaymentProcessor y PayPalPaymentController utilizará PayPalPaymentProcessor.

Así es como puedes hacerlo:

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

public function register()
{
    $this->app->when(StripePaymentController::class)
              ->needs(PaymentProcessorInterface::class)
              ->give(StripePaymentProcessor::class);

    $this->app->when(PayPalPaymentController::class)
              ->needs(PaymentProcessorInterface::class)
              ->give(PayPalPaymentProcessor::class);
}

¿Qué está pasando aquí?

• $this->app->when(): Esto le dice a Laravel que vincule una implementación particular de una interfaz cuando una clase específica (en este caso, un controlador) lo necesita.
• .needs(): Esto especifica que la clase (StripePaymentController o PayPalPaymentController) necesita una instancia de PaymentProcessorInterface.
• .give(): Esto determina qué implementación concreta proporcionar. Por ejemplo, StripePaymentController obtiene StripePaymentProcessor y PayPalPaymentController obtiene PayPalPaymentProcessor. Este enlace le permite resolver dinámicamente el procesador de pagos correcto dependiendo de qué controlador esté manejando la solicitud.

Paso 3: Controladores separados para cada método de pago

Con el enlace contextual implementado, cada controlador ahora puede tener su procesador de pagos dedicado inyectado automáticamente. Así es como puedes configurar tus controladores:

Ejemplo: StripePaymentController

use App\Contracts\PaymentProcessorInterface;

class StripePaymentController extends Controller
{
    protected $paymentProcessor;

    public function __construct(PaymentProcessorInterface $paymentProcessor)
    {
        $this->paymentProcessor = $paymentProcessor;
    }

    // Methods to handle Stripe-specific payments...
}

Ejemplo: Controlador de pagos de PayPal

use App\Contracts\PaymentProcessorInterface;

class PayPalPaymentController extends Controller
{
    protected $paymentProcessor;

    public function __construct(PaymentProcessorInterface $paymentProcessor)
    {
        $this->paymentProcessor = $paymentProcessor;
    }

    // Methods to handle PayPal-specific payments...
}

En ambos ejemplos, Laravel inyecta automáticamente el procesador de pagos correcto según el contexto del controlador. Esto es gracias al enlace contextual configurado en AppServiceProvider.

¿Por qué utilizar el enlace contextual?

El enlace contextual es particularmente útil cuando sabes qué implementación de una interfaz usar en función de clases o contextos específicos, como controladores. Ayuda a mantener su código limpio y manejable, especialmente cuando se trata de múltiples pasarelas de pago, cada una con su propio controlador.

Conclusión

En esta publicación, exploramos cómo implementar el enlace contextual en Laravel 11 para el procesamiento de pagos. A continuación se ofrece un resumen rápido de los beneficios de este enfoque:

• Código más limpio: no es necesario utilizar lógica manual para elegir entre diferentes procesadores de pagos.
• Inyección automática: Laravel inyecta automáticamente el procesador correcto según el contexto (controlador).
• Flexibilidad: puede extender fácilmente este enfoque a otras partes de su aplicación, como diferentes servicios u otros contextos. Cuándo utilizar el enlace contextual frente al patrón de fábrica
• Enlace contextual: ideal cuando el procesador se puede seleccionar en función de clases específicas (como diferentes controladores) o contextos conocidos. Simplifica el código donde se conoce el contexto en el momento de la compilación.
• Patrón de fábrica: utilice el patrón de fábrica si desea seleccionar dinámicamente un procesador de pagos en función de los datos del tiempo de ejecución (por ejemplo, entrada del usuario, solicitud de API). Este enfoque ofrece más flexibilidad para seleccionar el procesador de pagos, en tiempo de ejecución, en función de datos que pueden no conocerse hasta que se procese la solicitud.

En la próxima publicación, exploraremos Factory Pattern, que permite la selección dinámica de procesadores de pagos en tiempo de ejecución, lo que brinda aún más flexibilidad para aplicaciones complejas.

¡Estén atentos a la siguiente parte, donde cubriremos cómo usar fábricas para el procesamiento de pagos en Laravel 11!