class UpdateFetcher
Same name in other branches
- 9 core/modules/update/src/UpdateFetcher.php \Drupal\update\UpdateFetcher
- 8.9.x core/modules/update/src/UpdateFetcher.php \Drupal\update\UpdateFetcher
- 10 core/modules/update/src/UpdateFetcher.php \Drupal\update\UpdateFetcher
Fetches project information from remote locations.
Hierarchy
- class \Drupal\update\UpdateFetcher implements \Drupal\update\UpdateFetcherInterface uses \Drupal\Core\DependencyInjection\DependencySerializationTrait
Expanded class hierarchy of UpdateFetcher
1 file declares its use of UpdateFetcher
- UpdateFetcherTest.php in core/
modules/ update/ tests/ src/ Unit/ UpdateFetcherTest.php
1 string reference to 'UpdateFetcher'
- update.services.yml in core/
modules/ update/ update.services.yml - core/modules/update/update.services.yml
1 service uses UpdateFetcher
- update.fetcher in core/
modules/ update/ update.services.yml - Drupal\update\UpdateFetcher
File
-
core/
modules/ update/ src/ UpdateFetcher.php, line 16
Namespace
Drupal\updateView source
class UpdateFetcher implements UpdateFetcherInterface {
use DependencySerializationTrait;
/**
* URL to check for updates, if a given project doesn't define its own.
*/
const UPDATE_DEFAULT_URL = 'https://updates.drupal.org/release-history';
/**
* The fetch URL configured in the update settings.
*
* @var string
*/
protected $fetchUrl;
/**
* The update settings.
*
* @var \Drupal\Core\Config\Config
*/
protected $updateSettings;
/**
* The HTTP client to fetch the feed data with.
*
* @var \GuzzleHttp\ClientInterface
*/
protected $httpClient;
/**
* Whether to use HTTP fallback if HTTPS fails.
*
* @var bool
*/
protected $withHttpFallback;
/**
* Constructs an UpdateFetcher.
*
* @param \Drupal\Core\Config\ConfigFactoryInterface $config_factory
* The config factory.
* @param \GuzzleHttp\ClientInterface $http_client
* A Guzzle client object.
* @param \Drupal\Core\Site\Settings $settings
* The settings instance.
* @param \Psr\Log\LoggerInterface $logger
* The logger.
*/
public function __construct(ConfigFactoryInterface $config_factory, ClientInterface $http_client, Settings $settings, LoggerInterface $logger) {
$this->fetchUrl = $config_factory->get('update.settings')
->get('fetch.url');
$this->httpClient = $http_client;
$this->updateSettings = $config_factory->get('update.settings');
$this->withHttpFallback = $settings->get('update_fetch_with_http_fallback', FALSE);
}
/**
* {@inheritdoc}
*/
public function fetchProjectData(array $project, $site_key = '') {
$url = $this->buildFetchUrl($project, $site_key);
return $this->doRequest($url, [
'headers' => [
'Accept' => 'text/xml',
],
], $this->withHttpFallback);
}
/**
* Applies a GET request with a possible HTTP fallback.
*
* This method falls back to HTTP in case there was some certificate
* problem.
*
* @param string $url
* The URL.
* @param array $options
* The guzzle client options.
* @param bool $with_http_fallback
* Should the function fall back to HTTP.
*
* @return string
* The body of the HTTP(S) request, or an empty string on failure.
*/
protected function doRequest(string $url, array $options, bool $with_http_fallback) : string {
$data = '';
try {
$data = (string) $this->httpClient
->get($url, [
'headers' => [
'Accept' => 'text/xml',
],
])
->getBody();
} catch (ClientExceptionInterface $exception) {
Error::logException($this->logger, $exception);
if ($with_http_fallback && !str_contains($url, "http://")) {
$url = str_replace('https://', 'http://', $url);
return $this->doRequest($url, $options, FALSE);
}
}
return $data;
}
/**
* {@inheritdoc}
*/
public function buildFetchUrl(array $project, $site_key = '') {
$name = $project['name'];
$url = $this->getFetchBaseUrl($project);
$url .= '/' . $name . '/current';
// Only append usage information if we have a site key and the project is
// installed. We do not want to record usage statistics for uninstalled
// projects.
if (!empty($site_key) && !str_contains($project['project_type'], 'disabled')) {
// Append the site key.
$url .= str_contains($url, '?') ? '&' : '?';
$url .= 'site_key=';
$url .= rawurlencode($site_key);
// Append the version.
if (!empty($project['info']['version'])) {
$url .= '&version=';
$url .= rawurlencode($project['info']['version']);
}
// Append the list of modules or themes installed.
$list = array_keys($project['includes']);
$url .= '&list=';
$url .= rawurlencode(implode(',', $list));
}
return $url;
}
/**
* {@inheritdoc}
*/
public function getFetchBaseUrl($project) {
if (isset($project['info']['project status url'])) {
$url = $project['info']['project status url'];
}
else {
$url = $this->fetchUrl;
if (empty($url)) {
$url = static::UPDATE_DEFAULT_URL;
}
}
return $url;
}
}
Members
Title Sort descending | Modifiers | Object type | Summary | Overrides |
---|---|---|---|---|
DependencySerializationTrait::$_entityStorages | protected | property | ||
DependencySerializationTrait::$_serviceIds | protected | property | ||
DependencySerializationTrait::__sleep | public | function | 1 | |
DependencySerializationTrait::__wakeup | public | function | 2 | |
UpdateFetcher::$fetchUrl | protected | property | The fetch URL configured in the update settings. | |
UpdateFetcher::$httpClient | protected | property | The HTTP client to fetch the feed data with. | |
UpdateFetcher::$updateSettings | protected | property | The update settings. | |
UpdateFetcher::$withHttpFallback | protected | property | Whether to use HTTP fallback if HTTPS fails. | |
UpdateFetcher::buildFetchUrl | public | function | ||
UpdateFetcher::doRequest | protected | function | Applies a GET request with a possible HTTP fallback. | |
UpdateFetcher::fetchProjectData | public | function | ||
UpdateFetcher::getFetchBaseUrl | public | function | ||
UpdateFetcher::UPDATE_DEFAULT_URL | constant | URL to check for updates, if a given project doesn't define its own. | ||
UpdateFetcher::__construct | public | function | Constructs an UpdateFetcher. |
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.