public function BackendChain::getMultiple

public BackendChain::getMultiple(&$cids, $allow_invalid = FALSE)

Returns data from the persistent cache when given an array of cache IDs.

Parameters

array $cids: An array of cache IDs for the data to retrieve. This is passed by reference, and will have the IDs successfully returned from cache removed.

bool $allow_invalid: (optional) If TRUE, cache items may be returned even if they have expired or been invalidated. Such items may sometimes be preferred, if the alternative is recalculating the value stored in the cache, especially if another concurrent thread is already recalculating the same value. The "valid" property of the returned objects indicates whether the items are valid or not. Defaults to FALSE.

Return value

array An array of cache item objects indexed by cache ID.

Overrides CacheBackendInterface::getMultiple

See also

\Drupal\Core\Cache\CacheBackendInterface::get()

File

core/lib/Drupal/Core/Cache/BackendChain.php, line 93

Class

BackendChain
Defines a chained cache implementation for combining multiple cache backends.

Namespace

Drupal\Core\Cache

Code

public function getMultiple(&$cids, $allow_invalid = FALSE) {
  $return = array();

  foreach ($this->backends as $index => $backend) {
    $items = $backend->getMultiple($cids, $allow_invalid);

    // Propagate the values that could be retrieved from the current cache
    // backend to all missed backends.
    if ($index > 0 && !empty($items)) {
      for ($i = ($index - 1); 0 <= $i; --$i) {
        foreach ($items as $cached) {
          $this->backends[$i]->set($cached->cid, $cached->data, $cached->expire, $cached->tags);
        }
      }
    }

    // Append the values to the previously retrieved ones.
    $return += $items;

    if (empty($cids)) {
      // No need to go further if we don't have any cid to fetch left.
      break;
    }
  }

  return $return;
}

© 2001–2016 by the original authors
Licensed under the GNU General Public License, version 2 and later.
Drupal is a registered trademark of Dries Buytaert.
https://api.drupal.org/api/drupal/core!lib!Drupal!Core!Cache!BackendChain.php/function/BackendChain::getMultiple/8.1.x