ProviderRegistry

31class ProviderRegistry implements WithHttpTransporterInterface32{33    use WithHttpTransporterTrait {34        setHttpTransporter as setHttpTransporterOriginal;35    }36    /**37     * @var array<string, class-string<ProviderInterface>> Mapping of provider IDs to class names.38     */39    private array $registeredIdsToClassNames = [];40    /**41     * @var array<class-string<ProviderInterface>, string> Mapping of provider class names to IDs.42     */43    private array $registeredClassNamesToIds = [];44    /**45     * @var array<class-string<ProviderInterface>, RequestAuthenticationInterface> Mapping of provider class names to46     *                                                                             authentication instances.47     */48    private array $providerAuthenticationInstances = [];49    /**50     * Registers a provider class with the registry.51     *52     * @since 0.1.053     *54     * @param class-string<ProviderInterface> $className The fully qualified provider class name implementing the55     * ProviderInterface56     * @throws InvalidArgumentException If the class doesn't exist or implement the required interface.57     */58    public function registerProvider(string $className): void59    {60        if (!class_exists($className)) {61            throw new InvalidArgumentException(sprintf('Provider class does not exist: %s', $className));62        }63        // Validate that class implements ProviderInterface64        if (!is_subclass_of($className, ProviderInterface::class)) {65            throw new InvalidArgumentException(sprintf('Provider class must implement %s: %s', ProviderInterface::class, $className));66        }67        $metadata = $className::metadata();68        if (!$metadata instanceof ProviderMetadata) {69            throw new InvalidArgumentException(sprintf('Provider must return ProviderMetadata from metadata() method: %s', $className));70        }71        // If there is already a HTTP transporter instance set, hook it up to the provider as needed.72        try {73            $httpTransporter = $this->getHttpTransporter();74        } catch (RuntimeException $e) {75            /*76             * If this fails, it's okay. There is no defined sequence between setting the HTTP transporter in the77             * registry and registering providers in it, so it might be that the transporter is set later. It will be78             * hooked up then.79             * But for now we can ignore this exception and attempt to set the default HTTP transporter, if possible.80             */81            try {82                $this->setHttpTransporter(HttpTransporterFactory::createTransporter());83                $httpTransporter = $this->getHttpTransporter();84            } catch (DiscoveryNotFoundException $e) {85                /*86                 * If no HTTP client implementation can be discovered yet, we can ignore this for now.87                 * It might be set later, so it's not a hard error at this point.88                 * We'll try again the next time a provider is registered, or maybe by that time an explicit89                 * HTTP transporter will have been set.90                 */91            }92        }93        if (isset($httpTransporter)) {94            $this->setHttpTransporterForProvider($className, $httpTransporter);95        }96        // Hook up the request authentication instance, using a default if not set.97        if (!isset($this->providerAuthenticationInstances[$className])) {98            $defaultProviderAuthentication = $this->createDefaultProviderRequestAuthentication($className);99            if ($defaultProviderAuthentication !== null) {100                $this->providerAuthenticationInstances[$className] = $defaultProviderAuthentication;101            }102        }103        if (isset($this->providerAuthenticationInstances[$className])) {104            $this->setRequestAuthenticationForProvider($className, $this->providerAuthenticationInstances[$className]);105        }106        $this->registeredIdsToClassNames[$metadata->getId()] = $className;107        $this->registeredClassNamesToIds[$className] = $metadata->getId();108    }109    /**110     * Gets a list of all registered provider IDs.