function UserStorageSchema::getSharedTableFieldSchema

Same name and namespace in other branches
  1. 8.9.x core/modules/user/src/UserStorageSchema.php \Drupal\user\UserStorageSchema::getSharedTableFieldSchema()
  2. 10 core/modules/user/src/UserStorageSchema.php \Drupal\user\UserStorageSchema::getSharedTableFieldSchema()
  3. 11.x core/modules/user/src/UserStorageSchema.php \Drupal\user\UserStorageSchema::getSharedTableFieldSchema()

Gets the schema for a single field definition.

Entity types may override this method in order to optimize the generated schema for given field. While all optimizations that apply to a single field have to be added here, all cross-field optimizations should be via SqlContentEntityStorageSchema::getEntitySchema() instead; e.g., an index spanning multiple fields.

Parameters

\Drupal\Core\Field\FieldStorageDefinitionInterface $storage_definition: The storage definition of the field whose schema has to be returned.

string $table_name: The name of the table columns will be added to.

string[] $column_mapping: A mapping of field column names to database column names.

Return value

array The schema definition for the table with the following keys:

  • fields: The schema definition for the each field columns.
  • indexes: The schema definition for the indexes.
  • unique keys: The schema definition for the unique keys.
  • foreign keys: The schema definition for the foreign keys.

Overrides SqlContentEntityStorageSchema::getSharedTableFieldSchema

File

core/modules/user/src/UserStorageSchema.php, line 32

Class

UserStorageSchema
Defines the user schema handler.

Namespace

Drupal\user

Code

protected function getSharedTableFieldSchema(FieldStorageDefinitionInterface $storage_definition, $table_name, array $column_mapping) {
    $schema = parent::getSharedTableFieldSchema($storage_definition, $table_name, $column_mapping);
    $field_name = $storage_definition->getName();
    if ($table_name == 'users_field_data') {
        switch ($field_name) {
            case 'name':
                // Improves the performance of the user__name index defined
                // in getEntitySchema().
                $schema['fields'][$field_name]['not null'] = TRUE;
                // Make sure the field is no longer than 191 characters so we can
                // add a unique constraint in MySQL.
                $schema['fields'][$field_name]['length'] = UserInterface::USERNAME_MAX_LENGTH;
                break;
            case 'mail':
                $this->addSharedTableFieldIndex($storage_definition, $schema);
                break;
            case 'access':
            case 'created':
                $this->addSharedTableFieldIndex($storage_definition, $schema, TRUE);
                break;
        }
    }
    return $schema;
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.