public function FieldInfo::getFieldById

public FieldInfo::getFieldById($field_id)

Returns a field definition from a field ID.

This method only retrieves active fields, deleted or not.

Parameters

$field_id: The field ID.

Return value

The field definition, or NULL if no field was found.

File

modules/field/field.info.class.inc, line 306

Class

FieldInfo

Provides field and instance definitions for the current runtime environment.

Code

public function getFieldById($field_id) {
  // Read from the "static" cache.
  if (isset($this->fieldsById[$field_id])) {
    return $this->fieldsById[$field_id];
  }
  if (isset($this->unknownFields[$field_id])) {
    return;
  }

  // No persistent cache, fields are only persistently cached as part of a
  // bundle.

  // Cache miss: read from definition.
  if ($fields = field_read_fields(array('id' => $field_id), array('include_deleted' => TRUE))) {
    $field = current($fields);
    $field = $this->prepareField($field);

    // Store in the static cache.
    $this->fieldsById[$field['id']] = $field;
    if (!$field['deleted']) {
      $this->fieldIdsByName[$field['field_name']] = $field['id'];
    }

    return $field;
  }
  else {
    $this->unknownFields[$field_id] = TRUE;
  }
}