field_attach_insert

Versions
7: field_attach_insert($obj_type, $object)

Save field data for a new object.

The passed in object must already contain its id and (if applicable) revision id attributes. Default values (if any) will be saved for fields not present in the $object.

Parameters

$obj_type The type of $object; e.g. 'node' or 'user'.

$object The object with fields to save.

Return value

Default values (if any) will be added to the $object parameter for fields it leaves unspecified.

▸ 3 functions call field_attach_insert()

▾ 3 functions call field_attach_insert()

comment_save in modules/comment/comment.module: Accepts a submission of new or changed comment content.
taxonomy_term_save in modules/taxonomy/taxonomy.module: Save a term object to the database.
user_save in modules/user/user.module: Save changes to a user account or add a new user.

Code

modules/field/field.attach.inc, line 814

<?php
function field_attach_insert($obj_type, $object) {
  _field_invoke_default('insert', $obj_type, $object);
  _field_invoke('insert', $obj_type, $object);

  list($id, $vid, $bundle, $cacheable) = entity_extract_ids($obj_type, $object);

  // Let any module insert field data before the storage engine, accumulating
  // saved fields along the way.
  $skip_fields = array();
  foreach (module_implements('field_storage_pre_insert') as $module) {
    $function = $module . '_field_storage_pre_insert';
    $function($obj_type, $object, $skip_fields);
  }

  // Collect the storage backends used by the remaining fields in the objects.
  $storages = array();
  foreach (field_info_instances($obj_type, $bundle) as $instance) {
    $field = field_info_field_by_id($instance['field_id']);
    $field_id = $field['id'];
    $field_name = $field['field_name'];
    if (!empty($object->$field_name)) {
      // Collect the storage backend if the field has not been written yet.
      if (!isset($skip_fields[$field_id])) {
        $storages[$field['storage']['type']][$field_id] = $field_id;
      }
    }
  }

  // Field storage backends save any remaining unsaved fields.
  foreach ($storages as $storage => $fields) {
    $storage_info = field_info_storage_types($storage);
    module_invoke($storage_info['module'], 'field_storage_write', $obj_type, $object, FIELD_STORAGE_INSERT, $fields);
  }

  // Let other modules act on inserting the object.
  module_invoke_all('field_attach_insert', $obj_type, $object);

  if ($cacheable) {
    cache_clear_all("field:$obj_type:$id", 'cache_field');
  }
}
?>