Drupal 8エンティティの検証と入力データ：ディープダイブ

この記事では、Drupal 8のエンティティ検証APIと、Drupal 7のフォームベースのアプローチの制限を超えて移動するために、堅(jiān)牢なデータ検証のために型付けされたデータAPIに依存していることを調(diào)査します。 このシステムがプログラマティックデータの処理を強(qiáng)化し、さまざまなデータアクセス方法全體で一貫性を向上させる方法を調(diào)べます。

重要な概念：

データ検証の改善：
• DRUPAL 8エンティティ検証APIとタイプデータAPIをレバレッジして、データ検証を合理化し、プログラムの処理をフォームシステムとは獨(dú)立させます。 と入力されたデータAPI：
このAPIは、データとメタデータと対話するための標(biāo)準(zhǔn)化された方法を提供します。検証は、データ定義とデータタイププラグインを組み込んだ型付けられたデータオブジェクトで定義および実行されます。
• 制約：これらは検証プロセスに不可欠であり、データに適用される検証ルールを指定します。エンティティとフィールドの定義に追加できます。
• エンティティデータ構(gòu)造：DRUPAL 8は、エンティティプロパティとフィールドAPIフィールドを統(tǒng)合します。 ベースフィールドと構(gòu)成可能なフィールドはどちらも、
の実裝を使用してデータを管理します。
• より良いアプローチの必要性：FieldItemListInterface

Drupal 7は、検証のためにフォームAPIに大きく依存していたため、プログラマティックエンティティの検証が面倒でした。 検証ロジックの再実裝またはフォームの送信のシミュレーションは非効率的であり、フォームシステムとのデータ相互作用を緊密に結(jié)合しました。 Drupal 8のREST APIおよびその他のプログラマティックインターフェイスの出現(xiàn)は、より柔軟なソリューションを必要としました。 Drupal 8は、Symfony Validationコンポーネントを採用し、その上に構(gòu)築して、型付けされたデータおよびプラグインベースのエンティティシステムと統(tǒng)合しました。 これにより、すべての相互作用方法にわたって一貫した検証が保証されます

この記事とその続編は、Drupal 8エンティティ検証APIの実用的なアプリケーションと拡張を掘り下げます。 基礎(chǔ)となる型付けデータAPIを検討し、コードの例を提供します（この

gitリポジトリ內(nèi)のデモモジュールで使用できます

）。

型inpedデータAPIを理解：

タイプされたデータAPIは、データインタラクションのための一貫したインターフェイスを提供します。 その重要性は、型付けされたデータオブジェクトの検証を定義および呼び出すことにあります。 重要なコンポーネントには次のものがあります

データの定義：

データ構(gòu)造、相互作用方法、設(shè)定、および検証の制約を定義します。 Datatypeプラグイン：

データ型に基づいて値を取得および設(shè)定するためのメカニズムを提供します。 プラグインマネージャーが提供するデータ定義インスタンスを利用しています。

例：

• $definition = DataDefinition::create('string')
      ->addConstraint('Length', array('max' => 20));
  
  $string_typed_data = \Drupal::typedDataManager()->create($definition, 'my string');

  これにより、最大の長さの制約を備えた文字列データ定義が作成され、

  プラグインインスタンスを作成します。このインスタンスのTypedDataManagerメソッドは、定義された制約に対する検証をトリガーし、StringData。 validate()ConstraintViolationListと入力されたデータとコンテンツエンティティ：

  Drupal 8エンティティプロパティとフィールドAPIフィールドを統(tǒng)合します。 一部のフィールドはベースフィールド（基本的に古いエンティティプロパティ）ですが、他のフィールドは構(gòu)成可能です。 各フィールドは、の実裝を使用してデータを管理し、通常は

  プラグインを含み、それぞれがデータ型プラグインを拡張し、

  実裝（多くの場合FieldItemListInterface）を使用しています。 FieldItemDataDefinitionInterface制約の追加：FieldItemDataDefinition

  制約は、検証の詳細(xì)、エラーメッセージ、およびバリデーターオプションを含むプラグインです。 VALIDATORクラスは、実際の検証を?qū)g行します エンティティレベルの制約：エンティティクラスでの注釈を介して追加されました。 例：

  エンティティの制約を変更するには、

  ：

  を使用します

  フィールドレベルの制約：

  constraints = {
    "CommentName" = {}
  }

  メソッドは、エンティティタイプがカスタムかコアか、フィールドがベースか構(gòu)成かによって依存します。 カスタムエンティティの種類の場合、

  に制約を追加します。既存のエンティティタイプの場合、ベースフィールドにはhook_entity_type_alter()、構(gòu)成可能なフィールドには

  を使用します。 ベースフィールドの例：

  function demo_entity_type_alter(array &$entity_types) {
    $node = $entity_types['node'];
    $node->addConstraint('ConstraintPluginName', ['array', 'of', 'options']);
  }

  結(jié)論と次のステップ：baseFieldDefinitions()hook_entity_base_field_info_alter() hook_entity_bundle_field_info_alter()この記事は、Drupal 8のエンティティ検証とデータAPIと入力された型付けの基本的な理解を提供します。次の部分は、検証プロセス自體を掘り下げ、違反を処理し、カスタム制約とバリデーターを作成します。

  function demo_entity_base_field_info_alter(&$fields, EntityTypeInterface $entity_type) {
    if ($entity_type->id() === 'node') {
      $title = $fields['title'];
      $title->addPropertyConstraints('value', ['Length' => ['max' => 5]]);
    }
  }

  （長さの制約のために、提供されているFAQSセクションはここでは省略されていますが、別のセクションとして統(tǒng)合できます。）

以上がDrupal 8エンティティの検証とタイプされたデータが説明されましたの詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國語 Web サイトの他の関連記事を參照してください。