1. drupal
    1. 5
    2. 6
    3. 7
    4. 8
5 node_access_rebuild()
6 – 7 node_access_rebuild($batch_mode = FALSE)

Rebuild the node access database. This is occasionally needed by modules that make system-wide changes to access levels.

When the rebuild is required by an admin-triggered action (e.g module settings form), calling node_access_needs_rebuild(TRUE) instead of node_access_rebuild() lets the user perform his changes and actually rebuild only once he is done.

Note : As of Drupal 6, node access modules are not required to (and actually should not) call node_access_rebuild() in hook_enable/disable anymore.


$batch_mode Set to TRUE to process in 'batch' mode, spawning processing over several HTTP requests (thus avoiding the risk of PHP timeout if the site has a large number of nodes). hook_update_N and any form submit handler are safe contexts to use the 'batch mode'. Less decidable cases (such as calls from hook_user, hook_taxonomy, hook_node_type...) might consider using the non-batch mode.

See also


Related topics


modules/node/node.module, line 2324

function node_access_rebuild($batch_mode = FALSE) {
  db_query("DELETE FROM {node_access}");
  // Only recalculate if the site is using a node_access module.
  if (count(module_implements('node_grants'))) {
    if ($batch_mode) {
      $batch = array(
        'title' => t('Rebuilding content access permissions'), 
        'operations' => array(
          array('_node_access_rebuild_batch_operation', array()),
        'finished' => '_node_access_rebuild_batch_finished',
    else {
      // Try to allocate enough time to rebuild node grants
      if (function_exists('set_time_limit')) {
      $result = db_query("SELECT nid FROM {node}");
      while ($node = db_fetch_object($result)) {
        $loaded_node = node_load($node->nid, NULL, TRUE);
        // To preserve database integrity, only aquire grants if the node
        // loads successfully.
        if (!empty($loaded_node)) {
  else {
    // Not using any node_access modules. Add the default grant.
    db_query("INSERT INTO {node_access} VALUES (0, 0, 'all', 1, 0, 0)");

  if (!isset($batch)) {
    drupal_set_message(t('Content permissions have been rebuilt.'));