node_save

• Drupal 4.6
• Drupal 4.7
• Drupal 5
• Drupal 6
• Drupal 7

Versions

4.6

node_save($node)

4.7 – 6

node_save(&$node)

7

node_save($node)

Save changes to a node or add a new node.

Parameters

$node The $node object to be saved. If $node->nid is omitted (or $node->is_new is TRUE), a new node will be added.

Code

modules/node/node.module, line 934

<?php
function node_save($node) {
  $transaction = db_transaction();

  try {
    field_attach_presave('node', $node);
    // Let modules modify the node before it is saved to the database.
    module_invoke_all('node_presave', $node);
    global $user;

    if (!isset($node->is_new)) {
      $node->is_new = empty($node->nid);
    }

    // Apply filters to some default node fields:
    if ($node->is_new) {
      // Insert a new node.
      $node->is_new = TRUE;

      // When inserting a node, $node->log must be set because
      // {node_revision}.log does not (and cannot) have a default
      // value. If the user does not have permission to create
      // revisions, however, the form will not contain an element for
      // log so $node->log will be unset at this point.
      if (!isset($node->log)) {
        $node->log = '';
      }
    }
    elseif (!empty($node->revision)) {
      $node->old_vid = $node->vid;
      unset($node->vid);
    }
    else {
      // When updating a node, avoid clobbering an existing log entry with an empty one.
      if (empty($node->log)) {
        unset($node->log);
      }
    }

    // Set some required fields:
    if (empty($node->created)) {
      $node->created = REQUEST_TIME;
    }
    // The changed timestamp is always updated for bookkeeping purposes (revisions, searching, ...)
    $node->changed = REQUEST_TIME;
  
    $node->timestamp = REQUEST_TIME;
    $update_node = TRUE;

    // When converting the title property to fields we preserved the {node}.title
    // db column for performance, setting the default language value into this
    // column. After this we restore the field data structure to the previous node
    // title field.
    $title_field = $node->title;
    $langcode = FIELD_LANGUAGE_NONE;
    $node->title = $title_field[$langcode][0]['value'];

    // Generate the node table query and the node_revisions table query.
    if ($node->is_new) {
      drupal_write_record('node', $node);
      _node_save_revision($node, $user->uid);
      $op = 'insert';
    }
    else {
      drupal_write_record('node', $node, 'nid');
      if (!empty($node->revision)) {
        _node_save_revision($node, $user->uid);
      }
      else {
        _node_save_revision($node, $user->uid, 'vid');
        $update_node = FALSE;
      }
      $op = 'update';
    }
    if ($update_node) {
      db_update('node')
        ->fields(array('vid' => $node->vid))
        ->condition('nid', $node->nid)
        ->execute();
    }
  
    // Restore the title field data structure after db storage.
    $node->title = $title_field;
  
    // Call the node specific callback (if any). This can be
    // node_invoke($node, 'insert') or
    // node_invoke($node, 'update').
    node_invoke($node, $op);
  
    // Save fields.
    $function = "field_attach_$op";
    $function('node', $node);
  
    module_invoke_all('node_' . $op, $node);
  
    // Update the node access table for this node.
    node_access_acquire_grants($node);
  
    // Clear internal properties.
    unset($node->is_new);
  
    // Clear the page and block caches.
    cache_clear_all();
  
    // Ignore slave server temporarily to give time for the
    // saved node to be propagated to the slave.
    db_ignore_slave();
  }
  catch (Exception $e) {
    $transaction->rollback('node', $e->getMessage(), array(), WATCHDOG_ERROR);
  }
}
?>

Login or register to post comments