function module_disable

7.x module_disable($module_list, $disable_dependents = TRUE)

Disables a given set of modules.


$module_list: An array of module names.

$disable_dependents: If TRUE, dependent modules will automatically be added and disabled in the correct order. This incurs a significant performance cost, so use FALSE if you know $module_list is already complete and in the correct order.

12 calls to module_disable()
EnableDisableTestCase::testEntityInfoChanges in drupal/modules/system/system.test
Ensures entity info cache is updated after changes.
FieldCrudTestCase::_testActiveHelper in drupal/modules/field/tests/field.test
Helper function for testActive().
FieldInfoTestCase::testInstanceDisabledEntityType in drupal/modules/field/tests/field.test
Test that instances on disabled entity types are filtered out.
LocaleUninstallFunctionalTest::testUninstallProcess in drupal/modules/locale/locale.test
Check if the values of the Locale variables are correct after uninstall.
ModuleUninstallTestCase::testUserPermsUninstalled in drupal/modules/simpletest/tests/module.test
Tests the hook_modules_uninstalled() of the user module.

... See full list


drupal/includes/, line 515
API for loading and interacting with Drupal modules.


function module_disable($module_list, $disable_dependents = TRUE) {
  if ($disable_dependents) {
    // Get all module data so we can find dependents and sort.
    $module_data = system_rebuild_module_data();
    // Create an associative array with weights as values.
    $module_list = array_flip(array_values($module_list));

    $profile = drupal_get_profile();
    while (list($module) = each($module_list)) {
      if (!isset($module_data[$module]) || !$module_data[$module]->status) {
        // This module doesn't exist or is already disabled, skip it.
      $module_list[$module] = $module_data[$module]->sort;

      // Add dependent modules to the list, with a placeholder weight.
      // The new modules will be processed as the while loop continues.
      foreach ($module_data[$module]->required_by as $dependent => $dependent_data) {
        if (!isset($module_list[$dependent]) && $dependent != $profile) {
          $module_list[$dependent] = 0;

    // Sort the module list by pre-calculated weights.
    $module_list = array_keys($module_list);

  $invoke_modules = array();

  foreach ($module_list as $module) {
    if (module_exists($module)) {
      // Check if node_access table needs rebuilding.
      if (!node_access_needs_rebuild() && module_hook($module, 'node_grants')) {

      module_invoke($module, 'disable');
      db_update('system')->fields(array('status' => 0))->condition('type', 'module')->condition('name', $module)->execute();
      $invoke_modules[] = $module;
      watchdog('system', '%module module disabled.', array('%module' => $module), WATCHDOG_INFO);

  if (!empty($invoke_modules)) {
    // Refresh the module list to exclude the disabled modules.
    module_implements('', FALSE, TRUE);
    // Invoke hook_modules_disabled before disabling modules,
    // so we can still call module hooks to get information.
    module_invoke_all('modules_disabled', $invoke_modules);
    // Update the registry to remove the newly-disabled module.
    // Update the theme registry to remove the newly-disabled module.

  // If there remains no more node_access module, rebuilding will be
  // straightforward, we can do it right now.
  if (node_access_needs_rebuild() && count(module_implements('node_grants')) == 0) {