Add validation constraints to field_ui.settings

Created on 27 January 2024, about 1 year ago
Updated 2 May 2024, 10 months ago

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.

📌 Task
Status

Fixed

Version

10.3

Component
Field UI 

Last updated 1 day ago

Created by

🇧🇪Belgium borisson_ Mechelen, 🇧🇪

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Merge Requests

Comments & Activities

  • Issue created by @borisson_
  • First commit to issue fork.
  • Merge request !7221Initial commit → (Open) created by narendraR
  • Pipeline finished with Success
    11 months ago
    Total: 494s
    #131220
  • Status changed to Needs review 11 months ago
  • 🇮🇳India narendraR Jaipur, India
  • 🇮🇳India narendraR Jaipur, India
  • Status changed to Needs work 11 months ago
  • 🇧🇪Belgium wim leers Ghent 🇧🇪🇪🇺

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

  • Status changed to Needs review 11 months ago
  • 🇮🇳India narendraR Jaipur, India
  • Pipeline finished with Success
    11 months ago
    Total: 550s
    #132374
  • Status changed to Needs work 11 months ago
  • 🇧🇪Belgium wim leers Ghent 🇧🇪🇪🇺
  • Pipeline finished with Success
    11 months ago
    Total: 594s
    #132615
  • Status changed to Needs review 11 months ago
  • 🇮🇳India narendraR Jaipur, India
  • Status changed to RTBC 11 months ago
  • 🇧🇪Belgium borisson_ Mechelen, 🇧🇪

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

  • Status changed to Needs review 11 months ago
  • 🇬🇧United Kingdom catch

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

  • 🇺🇸United States smustgrave

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

  • 🇮🇳India narendraR Jaipur, India

    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");
    }

  • Status changed to Needs work 11 months ago
  • 🇧🇪Belgium wim leers Ghent 🇧🇪🇪🇺

    #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 😅

  • Pipeline finished with Success
    11 months ago
    Total: 506s
    #135304
  • Pipeline finished with Failed
    11 months ago
    Total: 526s
    #135323
  • 🇮🇳India narendraR Jaipur, India

    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.

  • Status changed to Needs review 11 months ago
  • 🇮🇳India narendraR Jaipur, India
  • Pipeline finished with Success
    11 months ago
    Total: 522s
    #135341
  • Status changed to Needs work 11 months ago
  • 🇧🇪Belgium wim leers Ghent 🇧🇪🇪🇺

    #15: that's not what I meant — I meant disallowing the field name (and hence also the prefix) to start with [0-9].

  • 🇮🇳India narendraR Jaipur, India

    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.

  • 🇧🇪Belgium wim leers Ghent 🇧🇪🇪🇺

    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.

  • Pipeline finished with Success
    11 months ago
    Total: 493s
    #135581
  • Pipeline finished with Success
    11 months ago
    Total: 586s
    #135595
  • Status changed to Needs review 11 months ago
  • 🇮🇳India narendraR Jaipur, India
  • Status changed to RTBC 11 months ago
  • 🇧🇪Belgium wim leers Ghent 🇧🇪🇪🇺

    Looks good now!

  • 🇬🇧United Kingdom catch

    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).

  • Status changed to Needs review 11 months ago
  • 🇬🇧United Kingdom catch

    Back to needs review for #22.

  • Status changed to Needs work 11 months ago
  • 🇺🇸United States phenaproxima Massachusetts

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

  • Pipeline finished with Success
    11 months ago
    Total: 520s
    #138438
  • 🇮🇳India narendraR Jaipur, India
  • Status changed to Needs review 11 months ago
  • 🇮🇳India narendraR Jaipur, India
  • Status changed to Needs work 11 months ago
  • 🇬🇧United Kingdom catch

    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 <code>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.

  • 🇧🇪Belgium wim leers Ghent 🇧🇪🇪🇺

    #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.

  • Pipeline finished with Canceled
    10 months ago
    Total: 127s
    #149029
  • Pipeline finished with Success
    10 months ago
    Total: 1081s
    #149031
  • Status changed to Needs review 10 months ago
  • 🇮🇳India narendraR Jaipur, India

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

  • Status changed to RTBC 10 months ago
  • 🇧🇪Belgium wim leers Ghent 🇧🇪🇪🇺

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

  • Pipeline finished with Success
    10 months ago
    Total: 987s
    #149909
  • Status changed to Needs work 10 months ago
  • 🇬🇧United Kingdom alexpott 🇪🇺🌍

    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

  • Status changed to RTBC 10 months ago
  • 🇺🇸United States phenaproxima Massachusetts

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

  • Pipeline finished with Success
    10 months ago
    Total: 985s
    #150194
  • 🇬🇧United Kingdom alexpott 🇪🇺🌍

    Committed and pushed 6c6c22c36a 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:...
  • Status changed to Fixed 10 months ago
    • alexpott committed e63b0c22 on 11.x
      Issue #3417363 by narendraR, Wim Leers, catch, phenaproxima, alexpott:...
  • Automatically closed - issue fixed for 2 weeks with no activity.

Production build 0.71.5 2024