function backdrop_render_cid_create

Creates the cache ID for a renderable element.

This creates the cache ID string, either by returning the #cache['cid'] property if present or by building the cache ID out of the #cache['keys'] and, optionally, the #cache['granularity'] properties.

Parameters

array $elements: A renderable array.

Return value

string|false: The cache ID string, or FALSE if the element may not be cached.

File

core/includes/common.inc, line 7527

Common functions that many Backdrop modules will need to reference.

Code

function backdrop_render_cid_create(array $elements) {
  if (isset($elements['#cache']['cid'])) {
    return $elements['#cache']['cid'];
  }
  elseif (isset($elements['#cache']['keys'])) {
    $granularity = isset($elements['#cache']['granularity']) ? $elements['#cache']['granularity'] : NULL;
    // Merge in additional cache ID parts based provided by
    // backdrop_render_cid_parts().
    $cid_parts = array_merge($elements['#cache']['keys'], backdrop_render_cid_parts($granularity));
    return implode(':', $cid_parts);
  }
  return FALSE;
}