Skip to main content
Drupal API
User account menu
  • Log in

Breadcrumb

  1. Drupal Core 11.1.x
  2. CommonClassesStrategy.php

class CommonClassesStrategy

@internal

@author Tobias Nyholm <tobias.nyholm@gmail.com>

Don't miss updating src/Composer/Plugin.php when adding a new supported class.

Hierarchy

  • class \Http\Discovery\Strategy\CommonClassesStrategy implements \Http\Discovery\Strategy\DiscoveryStrategy

Expanded class hierarchy of CommonClassesStrategy

File

vendor/php-http/discovery/src/Strategy/CommonClassesStrategy.php, line 49

Namespace

Http\Discovery\Strategy
View source
final class CommonClassesStrategy implements DiscoveryStrategy {
    
    /**
     * @var array
     */
    private static $classes = [
        MessageFactory::class => [
            [
                'class' => NyholmHttplugFactory::class,
                'condition' => [
                    NyholmHttplugFactory::class,
                ],
            ],
            [
                'class' => GuzzleMessageFactory::class,
                'condition' => [
                    GuzzleRequest::class,
                    GuzzleMessageFactory::class,
                ],
            ],
            [
                'class' => DiactorosMessageFactory::class,
                'condition' => [
                    DiactorosRequest::class,
                    DiactorosMessageFactory::class,
                ],
            ],
            [
                'class' => SlimMessageFactory::class,
                'condition' => [
                    SlimRequest::class,
                    SlimMessageFactory::class,
                ],
            ],
        ],
        StreamFactory::class => [
            [
                'class' => NyholmHttplugFactory::class,
                'condition' => [
                    NyholmHttplugFactory::class,
                ],
            ],
            [
                'class' => GuzzleStreamFactory::class,
                'condition' => [
                    GuzzleRequest::class,
                    GuzzleStreamFactory::class,
                ],
            ],
            [
                'class' => DiactorosStreamFactory::class,
                'condition' => [
                    DiactorosRequest::class,
                    DiactorosStreamFactory::class,
                ],
            ],
            [
                'class' => SlimStreamFactory::class,
                'condition' => [
                    SlimRequest::class,
                    SlimStreamFactory::class,
                ],
            ],
        ],
        UriFactory::class => [
            [
                'class' => NyholmHttplugFactory::class,
                'condition' => [
                    NyholmHttplugFactory::class,
                ],
            ],
            [
                'class' => GuzzleUriFactory::class,
                'condition' => [
                    GuzzleRequest::class,
                    GuzzleUriFactory::class,
                ],
            ],
            [
                'class' => DiactorosUriFactory::class,
                'condition' => [
                    DiactorosRequest::class,
                    DiactorosUriFactory::class,
                ],
            ],
            [
                'class' => SlimUriFactory::class,
                'condition' => [
                    SlimRequest::class,
                    SlimUriFactory::class,
                ],
            ],
        ],
        HttpAsyncClient::class => [
            [
                'class' => SymfonyHttplug::class,
                'condition' => [
                    SymfonyHttplug::class,
                    Promise::class,
                    [
                        self::class,
                        'isPsr17FactoryInstalled',
                    ],
                ],
            ],
            [
                'class' => Guzzle7::class,
                'condition' => Guzzle7::class,
            ],
            [
                'class' => Guzzle6::class,
                'condition' => Guzzle6::class,
            ],
            [
                'class' => Curl::class,
                'condition' => Curl::class,
            ],
            [
                'class' => React::class,
                'condition' => React::class,
            ],
        ],
        HttpClient::class => [
            [
                'class' => SymfonyHttplug::class,
                'condition' => [
                    SymfonyHttplug::class,
                    [
                        self::class,
                        'isPsr17FactoryInstalled',
                    ],
                    [
                        self::class,
                        'isSymfonyImplementingHttpClient',
                    ],
                ],
            ],
            [
                'class' => Guzzle7::class,
                'condition' => Guzzle7::class,
            ],
            [
                'class' => Guzzle6::class,
                'condition' => Guzzle6::class,
            ],
            [
                'class' => Guzzle5::class,
                'condition' => Guzzle5::class,
            ],
            [
                'class' => Curl::class,
                'condition' => Curl::class,
            ],
            [
                'class' => Socket::class,
                'condition' => Socket::class,
            ],
            [
                'class' => Buzz::class,
                'condition' => Buzz::class,
            ],
            [
                'class' => React::class,
                'condition' => React::class,
            ],
            [
                'class' => Cake::class,
                'condition' => Cake::class,
            ],
            [
                'class' => Artax::class,
                'condition' => Artax::class,
            ],
            [
                'class' => [
                    self::class,
                    'buzzInstantiate',
                ],
                'condition' => [
                    \Buzz\Client\FileGetContents::class,
                    \Buzz\Message\ResponseBuilder::class,
                ],
            ],
        ],
        Psr18Client::class => [
            [
                'class' => [
                    self::class,
                    'symfonyPsr18Instantiate',
                ],
                'condition' => [
                    SymfonyPsr18::class,
                    Psr17RequestFactory::class,
                ],
            ],
            [
                'class' => GuzzleHttp::class,
                'condition' => [
                    self::class,
                    'isGuzzleImplementingPsr18',
                ],
            ],
            [
                'class' => [
                    self::class,
                    'buzzInstantiate',
                ],
                'condition' => [
                    \Buzz\Client\FileGetContents::class,
                    \Buzz\Message\ResponseBuilder::class,
                ],
            ],
        ],
    ];
    public static function getCandidates($type) {
        if (Psr18Client::class === $type) {
            return self::getPsr18Candidates();
        }
        return self::$classes[$type] ?? [];
    }
    
    /**
     * @return array The return value is always an array with zero or more elements. Each
     *               element is an array with two keys ['class' => string, 'condition' => mixed].
     */
    private static function getPsr18Candidates() {
        $candidates = self::$classes[Psr18Client::class];
        // HTTPlug 2.0 clients implements PSR18Client too.
        foreach (self::$classes[HttpClient::class] as $c) {
            if (!is_string($c['class'])) {
                continue;
            }
            try {
                if (ClassDiscovery::safeClassExists($c['class']) && is_subclass_of($c['class'], Psr18Client::class)) {
                    $candidates[] = $c;
                }
            } catch (\Throwable $e) {
                trigger_error(sprintf('Got exception "%s (%s)" while checking if a PSR-18 Client is available', get_class($e), $e->getMessage()), E_USER_WARNING);
            }
        }
        return $candidates;
    }
    public static function buzzInstantiate() {
        return new \Buzz\Client\FileGetContents(Psr17FactoryDiscovery::findResponseFactory());
    }
    public static function symfonyPsr18Instantiate() {
        return new SymfonyPsr18(null, Psr17FactoryDiscovery::findResponseFactory(), Psr17FactoryDiscovery::findStreamFactory());
    }
    public static function isGuzzleImplementingPsr18() {
        return defined('GuzzleHttp\\ClientInterface::MAJOR_VERSION');
    }
    public static function isSymfonyImplementingHttpClient() {
        return is_subclass_of(SymfonyHttplug::class, HttpClient::class);
    }
    
    /**
     * Can be used as a condition.
     *
     * @return bool
     */
    public static function isPsr17FactoryInstalled() {
        try {
            Psr17FactoryDiscovery::findResponseFactory();
        } catch (NotFoundException $e) {
            return false;
        } catch (\Throwable $e) {
            trigger_error(sprintf('Got exception "%s (%s)" while checking if a PSR-17 ResponseFactory is available', get_class($e), $e->getMessage()), E_USER_WARNING);
            return false;
        }
        return true;
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title
CommonClassesStrategy::$classes private static property
CommonClassesStrategy::buzzInstantiate public static function
CommonClassesStrategy::getCandidates public static function Find a resource of a specific type. Overrides DiscoveryStrategy::getCandidates
CommonClassesStrategy::getPsr18Candidates private static function
CommonClassesStrategy::isGuzzleImplementingPsr18 public static function
CommonClassesStrategy::isPsr17FactoryInstalled public static function Can be used as a condition.
CommonClassesStrategy::isSymfonyImplementingHttpClient public static function
CommonClassesStrategy::symfonyPsr18Instantiate public static function

API Navigation

  • Drupal Core 11.1.x
  • Topics
  • Classes
  • Functions
  • Constants
  • Globals
  • Files
  • Namespaces
  • Deprecated
  • Services
RSS feed
Powered by Drupal