hook_uninstall

5 install.php hook_uninstall()
6 install.php hook_uninstall()
7 system.api.php hook_uninstall()
8 system.api.php hook_uninstall()

Remove any information that the module sets.

The information that the module should remove includes:

The module should not remove its entry from the {system} table. Database tables defined by hook_schema() will be removed automatically.

The uninstall hook must be implemented in the module's .install file. It will fire when the module gets uninstalled but before the module's database tables are removed, allowing your module to query its own tables during this routine.

When hook_uninstall() is called, your module will already be disabled, so its .module file will not be automatically included. If you need to call API functions from your .module file in this hook, use drupal_load() to make them available. (Keep this usage to a minimum, though, especially when calling API functions that invoke hooks, or API functions from modules listed as dependencies, since these may not be available or work as expected when the module is disabled.)

See also

hook_install()

hook_schema()

hook_disable()

hook_modules_uninstalled()

Related topics

22 functions implement hook_uninstall()

1 invocation of hook_uninstall()

File

modules/system/system.api.php, line 3433
Hooks provided by Drupal core and the System module.

Code

function hook_uninstall() {
  variable_del('upload_file_types');
}

Comments

Do not use API functions supplied by .module files

The code inside a hook_uninstall() implementation should not call any API functions that are provided by any .module file, including its own, unless:

  1. The uninstall code explicitly loads the module file, e.g., by calling drupal_load().
  2. It is absolutely certain that the called API function does not rely on other API functions which may not be available.

See also:

Common Knowledge

This is sort of assumed knowledge but, like hook_install and hook_update_N, this function should live in a .install file.

Login or register to post comments