function update_project_storage

Retrieves update storage data or empties it.

Two very expensive arrays computed by this module are the list of all installed modules and themes (and .info.yml data, project associations, etc), and the current status of the site relative to the currently available releases. These two arrays are stored and used whenever possible. The data is cleared whenever the administrator visits the status report, available updates report, or the module or theme administration pages, since we should always recompute the most current values on any of those pages.

Note: while both of these arrays are expensive to compute (in terms of disk I/O and some fairly heavy CPU processing), neither of these is the actual data about available updates that we have to fetch over the network from updates.drupal.org. That information is stored in the 'update_available_releases' collection -- it needs to persist longer than 1 hour and never get invalidated just by visiting a page on the site.

Parameters

$key: The key of data to return. Valid options are 'update_project_data' and 'update_project_projects'.

Return value

The stored value of the $projects array generated by update_calculate_project_data() or update_get_projects(), or an empty array when the storage is cleared.

File

drupal/core/modules/update/update.compare.inc, line 779

Code required only when comparing available updates to existing data.

Code

function update_project_storage($key) {
  $projects = array();

  // On certain paths, we should clear the data and recompute the projects for
  // update status of the site to avoid presenting stale information.
  $paths = array(
    'admin/modules',
    'admin/modules/update',
    'admin/appearance',
    'admin/appearance/update',
    'admin/reports',
    'admin/reports/updates',
    'admin/reports/updates/update',
    'admin/reports/status',
    'admin/reports/updates/check',
  );
  if (in_array(current_path(), $paths)) {
    Drupal::keyValueExpirable('update')
      ->delete($key);
  }
  else {
    $projects = Drupal::keyValueExpirable('update')
      ->get($key);
  }
  return $projects;
}