Same name and namespace in other branches
  1. 5.x includes/common.inc \drupal_build_css_cache()
  2. 7.x includes/common.inc \drupal_build_css_cache()

Aggregate and optimize CSS files, putting them in the files directory.

Parameters

$types: An array of types of CSS files (e.g., screen, print) to aggregate and compress into one file.

$filename: The name of the aggregate CSS file.

Return value

The name of the CSS file.

1 call to drupal_build_css_cache()
drupal_get_css in includes/common.inc
Returns a themed representation of all stylesheets that should be attached to the page.

File

includes/common.inc, line 2001
Common functions that many Drupal modules will need to reference.

Code

function drupal_build_css_cache($types, $filename) {
  $data = '';

  // Create the css/ within the files folder.
  $csspath = file_create_path('css');
  file_check_directory($csspath, FILE_CREATE_DIRECTORY);
  if (!file_exists($csspath . '/' . $filename)) {

    // Build aggregate CSS file.
    foreach ($types as $type) {
      foreach ($type as $file => $cache) {
        if ($cache) {
          $contents = drupal_load_stylesheet($file, TRUE);

          // Return the path to where this CSS file originated from.
          $base = base_path() . dirname($file) . '/';
          _drupal_build_css_path(NULL, $base);

          // Prefix all paths within this CSS file, ignoring external and absolute paths.
          $data .= preg_replace_callback('/url\\([\'"]?(?![a-z]+:|\\/+)([^\'")]+)[\'"]?\\)/i', '_drupal_build_css_path', $contents);
        }
      }
    }

    // Per the W3C specification at http://www.w3.org/TR/REC-CSS2/cascade.html#at-import,
    // @import rules must proceed any other style, so we move those to the top.
    $regexp = '/@import[^;]+;/i';
    preg_match_all($regexp, $data, $matches);
    $data = preg_replace($regexp, '', $data);
    $data = implode('', $matches[0]) . $data;

    // Create the CSS file.
    file_save_data($data, $csspath . '/' . $filename, FILE_EXISTS_REPLACE);
  }
  return $csspath . '/' . $filename;
}