function module_config_sort

Sorts the configured list of enabled modules.

The list of enabled modules is expected to be ordered by weight and name. The list is always sorted on write to avoid the overhead on read.

Parameters

array $data: An array of module configuration data.

Return value

array An array of module configuration data sorted by weight and name.

4 calls to module_config_sort()
ModuleHandler::enable in drupal/core/lib/Drupal/Core/Extension/ModuleHandler.php
Enables or installs a given list of modules.
module_set_weight in drupal/core/includes/module.inc
Sets weight of a particular module.
update_fix_compatibility in drupal/core/includes/update.inc
Disables any extensions that are incompatible with the current core version.
update_prepare_d8_bootstrap in drupal/core/includes/update.inc
Performs extra steps required to bootstrap when using a Drupal 7 database.

File

drupal/core/includes/module.inc, line 369
API for loading and interacting with Drupal modules.

Code

function module_config_sort($data) {

  // PHP array sorting functions such as uasort() do not work with both keys and
  // values at the same time, so we achieve weight and name sorting by computing
  // strings with both information concatenated (weight first, name second) and
  // use that as a regular string sort reference list via array_multisort(),
  // compound of "[sign-as-integer][padded-integer-weight][name]"; e.g., given
  // two modules and weights (spaces added for clarity):
  // - Block with weight -5: 0 0000000000000000005 block
  // - Node  with weight  0: 1 0000000000000000000 node
  $sort = array();
  foreach ($data as $name => $weight) {

    // Prefix negative weights with 0, positive weights with 1.
    // +/- signs cannot be used, since + (ASCII 43) is before - (ASCII 45).
    $prefix = (int) ($weight >= 0);

    // The maximum weight is PHP_INT_MAX, so pad all weights to 19 digits.
    $sort[] = $prefix . sprintf('%019d', abs($weight)) . $name;
  }
  array_multisort($sort, SORT_STRING, $data);
  return $data;
}