HEX
Server: LiteSpeed
System: Linux server315.web-hosting.com 4.18.0-553.54.1.lve.el8.x86_64 #1 SMP Wed Jun 4 13:01:13 UTC 2025 x86_64
User: globfdxw (6114)
PHP: 8.1.34
Disabled: NONE
Upload Files
File: /home/globfdxw/www/wp-content/plugins/give/src/Framework/PaymentGateways/PaymentGatewayRegister.php
<?php

namespace Give\Framework\PaymentGateways;

use Give\Container\Container;
use Give\Framework\Exceptions\Primitives\Exception;
use Give\Framework\Exceptions\Primitives\InvalidArgumentException;
use Give\Framework\PaymentGateways\Contracts\PaymentGatewaysIterator;
use Give\Framework\PaymentGateways\Exceptions\OverflowException;

/**
 * @since 2.18.0
 */
class PaymentGatewayRegister extends PaymentGatewaysIterator
{
    /**
     * @var string[]
     */
    protected $gateways = [];

    /**
     * Get Gateways
     *
     * @since 2.30.0 added $supportedFormVersion param to filter gateways by supported form version
     * @since 2.18.0
     */
    public function getPaymentGateways(int $supportedFormVersion = null): array
    {
        if (!$supportedFormVersion) {
            return $this->gateways;
        }

        return array_filter($this->gateways, static function (string $gatewayClass) use ($supportedFormVersion) {
            /** @var PaymentGateway $gateway */
            $gateway = give($gatewayClass);

            return in_array($supportedFormVersion, $gateway->supportsFormVersions(), true);
        });
    }

    /**
     * Get Gateway
     *
     * @since 2.18.0
     */
    public function getPaymentGateway(string $id): PaymentGateway
    {
        if (!$this->hasPaymentGateway($id)) {
            throw new InvalidArgumentException("No gateway exists with the ID {$id}");
        }

        /** @var PaymentGateway $gateway */
        $gateway = give($this->gateways[$id]);

        return $gateway;
    }

    /**
     * @since 2.18.0
     */
    public function hasPaymentGateway(string $id): bool
    {
        return isset($this->gateways[$id]);
    }

    /**
     * Register Gateway
     *
     * @since 2.18.0
     *
     * @throws OverflowException|InvalidArgumentException|Exception
     */
    public function registerGateway(string $gatewayClass)
    {
        if (!is_subclass_of($gatewayClass, PaymentGateway::class)) {
            throw new InvalidArgumentException(
                sprintf(
                    '%1$s must extend %2$s',
                    $gatewayClass,
                    PaymentGateway::class
                )
            );
        }

        $gatewayId = $gatewayClass::id();

        if ($this->hasPaymentGateway($gatewayId)) {
            throw new OverflowException("Cannot register a gateway with an id that already exists: $gatewayId");
        }


        $this->gateways[$gatewayId] = $gatewayClass;


        $this->registerGatewayWithServiceContainer($gatewayClass, $gatewayId);
    }

    /**
     * Unregister Gateway
     *
     * @since 2.18.0
     *
     * @param $gatewayId
     */
    public function unregisterGateway($gatewayId)
    {
        if (isset($this->gateways[$gatewayId])) {
            unset($this->gateways[$gatewayId]);
        }
    }

    /**
     *
     * Register Gateway with Service Container as Singleton
     * with option of adding Subscription Module through filter "give_gateway_{$gatewayId}_subscription_module"
     *
     * @since 2.18.0
     *
     * @return void
     */
    private function registerGatewayWithServiceContainer(string $gatewayClass, string $gatewayId)
    {
        give()->singleton($gatewayClass, function (Container $container) use ($gatewayClass, $gatewayId) {
            $subscriptionModule = apply_filters("givewp_gateway_{$gatewayId}_subscription_module", null);

            return new $gatewayClass($subscriptionModule ? $container->make($subscriptionModule) : null);
        });
    }
}