function ClientFactory::fromOptions

Same name in other branches
  1. 8.9.x core/lib/Drupal/Core/Http/ClientFactory.php \Drupal\Core\Http\ClientFactory::fromOptions()
  2. 10 core/lib/Drupal/Core/Http/ClientFactory.php \Drupal\Core\Http\ClientFactory::fromOptions()
  3. 11.x core/lib/Drupal/Core/Http/ClientFactory.php \Drupal\Core\Http\ClientFactory::fromOptions()

Constructs a new client object from some configuration.

Parameters

array $config: The config for the client.

Return value

\GuzzleHttp\Client The HTTP client.

File

core/lib/Drupal/Core/Http/ClientFactory.php, line 41

Class

ClientFactory
Helper class to construct a HTTP client with Drupal specific config.

Namespace

Drupal\Core\Http

Code

public function fromOptions(array $config = []) {
    $default_config = [
        // Security consideration: we must not use the certificate authority
        // file shipped with Guzzle because it can easily get outdated if a
        // certificate authority is hacked. Instead, we rely on the certificate
        // authority file provided by the operating system which is more likely
        // going to be updated in a timely fashion. This overrides the default
        // path to the pem file bundled with Guzzle.
'verify' => TRUE,
        'timeout' => 30,
        'headers' => [
            'User-Agent' => 'Drupal/' . \Drupal::VERSION . ' (+https://www.drupal.org/) ' . \GuzzleHttp\default_user_agent(),
        ],
        'handler' => $this->stack,
        // Security consideration: prevent Guzzle from using environment variables
        // to configure the outbound proxy.
'proxy' => [
            'http' => NULL,
            'https' => NULL,
            'no' => [],
        ],
    ];
    $config = NestedArray::mergeDeep($default_config, Settings::get('http_client_config', []), $config);
    return new Client($config);
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.