Problem/Motivation

field ui settings has 1 property path that is not yet validatable:

 ./vendor/bin/drush config:inspect --filter-keys=field_ui.settings --detail --list-constraints --fields=key,validatability,constraints 
➜  🤖 Analyzing…

 ---------------------------------------------- ------------- ------------------------------------------ 
  Key                                            Validatable   Validation constraints                    
 ---------------------------------------------- ------------- ------------------------------------------ 
  field_ui.settings                              75%           ValidKeys: '<infer>'                      
   field_ui.settings:                            Validatable   ValidKeys: '<infer>'                      
   field_ui.settings:_core                       Validatable   ValidKeys:                                
                                                                 - default_config_hash                   
   field_ui.settings:_core.default_config_hash   Validatable   NotNull: {  }                             
                                                               Regex: '/^[a-zA-Z0-9\-_]+$/'              
                                                               Length: 43                                
                                                               ↣ PrimitiveType: {  }                     
   field_ui.settings:field_prefix                NOT           ⚠️  @todo Add validation constraints here  
 ---------------------------------------------- ------------- ------------------------------------------ 

Steps to reproduce

  1. Get a local git clone of Drupal core 11.x.
  2. composer require drupal/config_inspector — or manually install https://www.drupal.org/project/config_inspector/releases/2.1.5 or newer (which supports Drupal 11!)
  3. composer require drush/drush
  4. vendor/bin/drush config:inspect --filter-keys=field_ui.settings --detail --list-constraints

Proposed resolution

Add validation constraints to:

  1. field_ui.settings:field_prefix

This requires looking at the existing code and admin UI (if any) to understand which values could be considered valid. Eventually this needs to be reviewed by the relevant subsystem maintainer.

For examples, search *.schema.yml files for the string constraints: 😊

Reach out to @borisson_ or @wimleers in the #distributions-and-recipes.

Remaining tasks

  1. field_ui.settings:field_prefix

User interface changes

None.

API changes

Data model changes

More validation 🚀

Release notes snippet

None.

Issue fork drupal-3417363

Command icon Show commands

Start within a Git clone of the project using the version control instructions.

Or, if you do not have SSH keys set up on git.drupalcode.org:

Comments

borisson_ created an issue. See original summary.

narendraR made their first commit to this issue’s fork.

narendrar’s picture

Status: Active » Needs review
Issue tags: +Configuration schema, +validation
narendrar’s picture

wim leers’s picture

Status: Needs review » Needs work

🏓 I don't think this is quite right yet.

narendrar’s picture

Status: Needs work » Needs review
wim leers’s picture

Status: Needs review » Needs work
narendrar’s picture

Status: Needs work » Needs review
borisson_’s picture

Status: Needs review » Reviewed & tested by the community

This looks good to me, i don't think we should decrease the size even further.

catch’s picture

Status: Reviewed & tested by the community » Needs review

What would happen if you had an existing field prefix that's invalid according to the new validation?

smustgrave’s picture

Is this something that can be fixed though after the field is created?

narendrar’s picture

I think that is already handled in core/modules/field/src/Entity/FieldStorageConfig::__construct

if (!preg_match('/^[_a-z]+[_a-z0-9]*$/', $values['field_name'])) {
throw new FieldException("Attempt to create a field storage {$values['field_name']} with invalid characters. Only lowercase alphanumeric characters and underscores are allowed, and only lowercase letters and underscore are allowed as the first character");
}

wim leers’s picture

Status: Needs review » Needs work

#11++ … and #13++ for answering it 😄

But … @narendraR, you literally quoted the code that proves that the validation constraints you added to the config schema are incorrect 😅

narendrar’s picture

Adding _ in the end of field prefix failed core/modules/field_ui/tests/src/Functional/ManageFieldsFunctionalTest::testFieldPrefix. Either that test needs to be adjusted as per new validation rule or _ in the end of field prefix is not necessary. For now, I am removing the _ from field prefix end.

narendrar’s picture

wim leers’s picture

Status: Needs review » Needs work

#15: that's not the difference between the two: the field name (and hence also the prefix) must start with [0-9].

narendrar’s picture

Sorry, but I don't get #17. As per #13, Only lowercase alphanumeric characters and underscores are allowed, and only lowercase letters and underscore are allowed as the first character.

wim leers’s picture

Ah, I see — I had only seen the two underscore-related commits (eafb29c0 and 5b82dd9a), not the one that fixed the regex (f7ea3188) — sorry about that! 🙈

Indeed, I don't think a trailing _ is required for the prefix — it could also be just foo as a prefix for example.

I think this looks ready now, except for one nit (left a suggestion for it) and one question/bit of ambiguity.

narendrar’s picture

Status: Needs work » Needs review
wim leers’s picture

Status: Needs review » Reviewed & tested by the community

Looks good now!

catch’s picture

With #11 I actually meant what happens if the field prefix is over 30 characters already (although glad my vague question found a real bug).

catch’s picture

Status: Reviewed & tested by the community » Needs review

Back to needs review for #22.

phenaproxima’s picture

Status: Needs review » Needs work
Issue tags: +Needs update path, +Needs update path tests

I'm guessing we need an update path to handle that case. :(

narendrar’s picture

narendrar’s picture

Status: Needs work » Needs review
catch’s picture

Status: Needs review » Needs work

Sorry I'm not sure about the update path either - this is silently updating someone's config and field names aren't changeable once they make a new field, which they might do without realising.

I don't really believe anyone has a 40 (or even 31) character field prefix, but if their field prefix was iloveantidisestablishmentarianismverymuch would we really want to shorten that to iloveantidisestablishmentarianismverymu.

If all that happens when the field prefix is too long, is they get a validation error if they try to save that form again, could we add a hook_requirements() warning, then they can fix it to a shorter string of their choosing? Or something like that seems OK as long as config import/export is unaffected.

wim leers’s picture

#27: a 40-character long prefix is impossible already thanks to \Drupal\field\Entity\FieldStorageConfig::preSaveNew() doing:

    // Field name cannot be longer than FieldStorageConfig::NAME_MAX_LENGTH
    // characters. We use mb_strlen() because the DB layer assumes that column
    // widths are given in characters rather than bytes.
    if (mb_strlen($this->getName()) > static::NAME_MAX_LENGTH) {
      throw new FieldException('Attempt to create a field storage with an name longer than ' . static::NAME_MAX_LENGTH . ' characters: ' . $this->getName());
    }

I agree that should be better documented though.

narendrar’s picture

Status: Needs work » Needs review

Not sure what next should be done in this issue, hence marking it for another review.

wim leers’s picture

Status: Needs review » Reviewed & tested by the community

Addressed @catch's review like I suggested in #28: with slightly expanded docs. I think this is ready now.

alexpott’s picture

Status: Reviewed & tested by the community » Needs work

Discussed with @catch - I don't think we should have an update path here. Because as wim points out on the less you’d already have problems if it was over 31 characters… and practically you do with the new limit of 30… every field name would have to only be 2 letters… so I just so think the upgrade path is worth it.

Also see #27

phenaproxima’s picture

Status: Needs work » Reviewed & tested by the community

Okay, I'm going to guess this is therefore RTBC once tests pass!

alexpott’s picture

Version: 11.x-dev » 10.3.x-dev
Status: Reviewed & tested by the community » Fixed

Committed and pushed e63b0c228a to 11.x and fb746dae75 to 10.3.x. Thanks!

  • alexpott committed fb746dae on 10.3.x
    Issue #3417363 by narendraR, Wim Leers, catch, phenaproxima, alexpott:...

  • alexpott committed e63b0c22 on 11.x
    Issue #3417363 by narendraR, Wim Leers, catch, phenaproxima, alexpott:...

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.