/** * Group the various assets together into an array. Determines which files * can be grouped together and the ordering. * * @param array $assets An array of file names * @param bool $combine (Optional) Whether to allow combining or * not. Default true. * @param mixed $groupsUse (Optional) A string or array of groups to * include or exclude. Null for this to be * ignored. Default null. * @param int $groupsUseType (Optional) The type of grouping either * sfCombineManager::GROUP_INCLUDE or * sfCombineManager::GROUP_EXCLUDE. * These dictate whether the group(s) in * the previous argument should be marked * as used or every group marked as used. * Default sfCombineManager::GROUP_INCLUDE * @param bool $onlyUnusedGroups (Optional) Only use unused groups. Default * true. * @param bool $markGroupsUsed (Optional) Mark the groups that are used * as used. Default true. * @return array An array of grouped files ready for combining. Array is in * the form of files => array of file names, options => array * of options for that grouping, combinable => bool (whether * to put the file through sfCombine (otherwise links * outside of sfCombine)) */ public function getAssetsByGroup($assets, $combine = true, $groupsUse = null, $groupsUseType = self::GROUP_INCLUDE, $onlyUnusedGroups = true, $markGroupsUsed = true, $assetPathMethod = null) { $groupData = $this->getGroups(); $notCombined = $combined = array(); foreach ($assets as $file => $options) { // check asset still needs to be added if (!array_key_exists($file, $assets)) { continue; } // get the group this file is in $group = array_key_exists($file, $groupData) ? $groupData[$file] : ''; if ($groupsUse !== null) { if (is_string($groupsUse)) { $groupsUse = array($groupsUse); } if ($groupsUseType === self::GROUP_INCLUDE) { // only allow specific groups if (!in_array($group, $groupsUse)) { // don't include this group continue; } } else { if ($groupsUseType === self::GROUP_EXCLUDE) { // only exclude specific groups if (in_array($group, $groupsUse)) { // don't include this group continue; } } } } // don't output a used group if ($onlyUnusedGroups && in_array($group, $this->getUsedGroups())) { continue; } $timestampConfig = sfConfig::get('app_sfCombinePlugin_timestamp', array()); $timestampEnabled = isset($timestampConfig['enabled']) && $timestampConfig['enabled']; if (!$combine || !sfCombineUtility::combinableFile($file, $this->getSkips())) { if ($timestampEnabled) { $timestamp = sfCombineUtility::getModifiedTimestamp($file, $assetPathMethod); } else { $timestamp = 0; } // file not combinable $notCombined[] = array('files' => $file, 'options' => $options, 'combinable' => false, 'timestamp' => $timestamp); unset($assets[$file]); } else { // get the group this file is in $group = array_key_exists($file, $groupData) ? $groupData[$file] : ''; $combinedFiles = array($file); // get timestamp if ($timestampEnabled) { $timestamp = sfCombineUtility::getModifiedTimestamp($file, $assetPathMethod); } else { $timestamp = 0; } unset($assets[$file]); foreach ($assets as $groupedFile => $groupedOptions) { if (!sfCombineUtility::combinableFile($groupedFile, $this->getSkips()) || $options != $groupedOptions) { continue; } $groupedFileGroup = array_key_exists($groupedFile, $groupData) ? $groupData[$groupedFile] : ''; // add this file to this combine if ($group == $groupedFileGroup) { if ($timestampEnabled) { $groupedTimestamp = sfCombineUtility::getModifiedTimestamp($groupedFile, $assetPathMethod); if ($groupedTimestamp > $timestamp) { $timestamp = $groupedTimestamp; } } $combinedFiles[] = $groupedFile; unset($assets[$groupedFile]); } } $combined[] = array('files' => $combinedFiles, 'options' => $options, 'combinable' => true, 'timestamp' => $timestamp); } } if ($markGroupsUsed) { $this->updateUsedGroups($groupsUse, $groupsUseType); } return array_merge($notCombined, $combined); }