function module_set_weight

Same name and namespace in other branches
  1. 9 core/includes/ \module_set_weight()
  2. 10 core/includes/ \module_set_weight()
  3. 11.x core/includes/ \module_set_weight()

Sets weight of a particular module.

The weight of uninstalled modules cannot be changed.


string $module: The name of the module (without the .module extension).

int $weight: An integer representing the weight of the module.

12 calls to module_set_weight()
content_translation_install in core/modules/content_translation/content_translation.install
Implements hook_install().
forum_install in core/modules/forum/forum.install
Implements hook_install().
install_finished in core/includes/
Performs final installation steps and displays a 'finished' page.
KernelTestBaseTest::testEnableModulesFixedList in core/modules/simpletest/src/Tests/KernelTestBaseTest.php
Tests that the module list is retained after enabling/installing/disabling.
MenuLinkContentCacheabilityBubblingTest::setUp in core/modules/menu_link_content/tests/src/Kernel/MenuLinkContentCacheabilityBubblingTest.php

... See full list


core/includes/, line 183


function module_set_weight($module, $weight) {
    $extension_config = \Drupal::configFactory()->getEditable('core.extension');
    if ($extension_config->get("module.{$module}") !== NULL) {
        // Pre-cast the $weight to an integer so that we can save this without using
        // schema. This is a performance improvement for module installation.
        $extension_config->set("module.{$module}", (int) $weight)
            ->set('module', module_config_sort($extension_config->get('module')))
        // Prepare the new module list, sorted by weight, including filenames.
        // @see \Drupal\Core\Extension\ModuleInstaller::install()
        $module_handler = \Drupal::moduleHandler();
        $current_module_filenames = $module_handler->getModuleList();
        $current_modules = array_fill_keys(array_keys($current_module_filenames), 0);
        $current_modules = module_config_sort(array_merge($current_modules, $extension_config->get('module')));
        $module_filenames = [];
        foreach ($current_modules as $name => $weight) {
            $module_filenames[$name] = $current_module_filenames[$name];
        // Update the module list in the extension handler.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.