function update_get_available

Same name in other branches
  1. 7.x modules/update/update.module \update_get_available()
  2. 9 core/modules/update/update.module \update_get_available()
  3. 8.9.x core/modules/update/update.module \update_get_available()
  4. 11.x core/modules/update/update.module \update_get_available()

Tries to get update information and refreshes it when necessary.

In addition to checking the lifetime, this function also ensures that there are no .info.yml files for installed modules or themes that have a newer modification timestamp than the last time we checked for available update data. If any .info.yml file was modified, it almost certainly means a new version of something was installed. Without fresh available update data, the logic in update_calculate_project_data() will be wrong and produce confusing, bogus results.

Parameters

$refresh: (optional) Boolean to indicate if this method should refresh automatically if there's no data. Defaults to FALSE.

Return value

array Array of data about available releases, keyed by project shortname.

See also

update_refresh()

\Drupal\update\UpdateManager::getProjects()

8 calls to update_get_available()
DevReleaseTest::getProjectData in core/modules/update/tests/src/Kernel/DevReleaseTest.php
Gets project data from update_calculate_project_data().
UpdateCalculateProjectDataTest::testProjectStatus in core/modules/update/tests/src/Kernel/UpdateCalculateProjectDataTest.php
Tests the project_status of the project.
UpdateContribTest::testNoReleasesAvailable in core/modules/update/tests/src/Functional/UpdateContribTest.php
Tests when there is no available release data for a contrib module.
UpdateController::updateStatus in core/modules/update/src/Controller/UpdateController.php
Returns a page about the update status of projects.
UpdateManagerUpdate::buildForm in core/modules/update/src/Form/UpdateManagerUpdate.php
Form constructor.

... See full list

File

core/modules/update/update.module, line 272

Code

function update_get_available($refresh = FALSE) {
    \Drupal::moduleHandler()->loadInclude('update', 'inc', 'update.compare');
    $needs_refresh = FALSE;
    // Grab whatever data we currently have.
    $available = \Drupal::keyValueExpirable('update_available_releases')->getAll();
    $projects = \Drupal::service('update.manager')->getProjects();
    foreach ($projects as $key => $project) {
        // If there's no data at all, we clearly need to fetch some.
        if (empty($available[$key])) {
            // update_create_fetch_task($project);
            \Drupal::service('update.processor')->createFetchTask($project);
            $needs_refresh = TRUE;
            continue;
        }
        // See if the .info.yml file is newer than the last time we checked for
        // data, and if so, mark this project's data as needing to be re-fetched.
        // Any time an admin upgrades their local installation, the .info.yml file
        // will be changed, so this is the only way we can be sure we're not showing
        // bogus information right after they upgrade.
        if ($project['info']['_info_file_ctime'] > $available[$key]['last_fetch']) {
            $available[$key]['fetch_status'] = UpdateFetcherInterface::FETCH_PENDING;
        }
        // If we have project data but no release data, we need to fetch. This
        // can be triggered when we fail to contact a release history server.
        if (empty($available[$key]['releases']) && !$available[$key]['last_fetch']) {
            $available[$key]['fetch_status'] = UpdateFetcherInterface::FETCH_PENDING;
        }
        // If we think this project needs to fetch, actually create the task now
        // and remember that we think we're missing some data.
        if (!empty($available[$key]['fetch_status']) && $available[$key]['fetch_status'] == UpdateFetcherInterface::FETCH_PENDING) {
            \Drupal::service('update.processor')->createFetchTask($project);
            $needs_refresh = TRUE;
        }
    }
    if ($needs_refresh && $refresh) {
        // Attempt to drain the queue of fetch tasks.
        update_fetch_data();
        // After processing the queue, we've (hopefully) got better data, so pull
        // the latest data again and use that directly.
        $available = \Drupal::keyValueExpirable('update_available_releases')->getAll();
    }
    return $available;
}

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