キーポイント

Drupalのエンティティは、データを整理するための強(qiáng)力な方法であり、特定の種類の情報(bào)を表すようにカスタマイズできます。このチュートリアルでは、タイトル、説明、締め切りなどの屬性を含むプロジェクトと呼ばれるカスタムエンティティタイプを作成する方法を示しています。
新しいエンティティタイプを作成するには、スキーマ定義を宣言し、エンティティデータのデータベーステーブルを生成する必要があります。このチュートリアルには、4つの列（ID、名前、説明、および締め切り）を持つ「demo_projects」テーブルを作成するためのコード例を提供します。
エンティティAPIモジュールをサイトで有効にし、カスタムモジュールの依存関係として設(shè)定する必要があります。これは、Drupal Coreに欠けている多くのエンティティ処理機(jī)能を提供します。これには、新しいエンティティの作成、データベースへの保存、表示が含まれます。
• このチュートリアルでは、デフォルトのEntityApicOntrollerクラスのbuildContent（）メソッドをオーバーライドしてエンティティを表示する方法と、Entity_view（）ヘルパー関數(shù)を介してエンティティリストを作成する方法についても説明しています。チュートリアルの2番目の部分では、個(gè)々のプロジェクトエンティティを表示し、UIを介してフィールド可能にするページの作成を?qū)毪?、クエリおよびリスト表示のビューに公開します。
Drupalエンティティは、データを整理するための優(yōu)れた方法です。ノード、分類用語、コメント、またはユーザーに精通している場合は、Drupal 7以降、これらがエンティティであったことも知っておく必要があります。それらについてのもう1つの重要な側(cè)面は、フィールドAPIを通じてフィールド化できることです。

このチュートリアルでは、獨(dú)自のカスタムエンティティタイプを定義して開始する方法を紹介します。ノードを使用する代わりに、なぜ誰かがこれをしたいのですか？なぜなら、それらは素晴らしいですが、ノードは時(shí)々過度に複雑になることがあります。リビジョンやコメントなど、多くの機(jī)能を必要としない場合があります。

このチュートリアルでは、プロジェクトに関する簡単な情報(bào)（タイトル、説明、および締め切り）を表すために、「プロジェクト」と呼ばれる獨(dú)自のカスタムエンティティタイプを定義します。その後、このタイプのエンティティの使用について少し學(xué)びます。 學(xué)習(xí)を続けるために、基本的なカスタムモジュールの作成方法を知っていると思います（モジュールにはデモという名前です）。このトピックについては、優(yōu)れたチュートリアルをご覧ください。 .infoファイルの書き込みを続け、空の.moduleと.installファイルを作成します。また、このチュートリアルのすべてのソースコードを取得できるGitリポジトリを設(shè)定します（各セクションに1つのブランチ、2つのセクションが公開されます）。

さらに、サイト上のエンティティAPIコントリブモジュールを有効にし、カスタムモジュールの依存関係として設(shè)定する必要があります。エンティティAPIモジュールは、Drupal Coreに欠けている機(jī)能の多くを提供するため、エンティティを扱うときに非常に強(qiáng)力です。

獨(dú)自のDrupalエンティティタイプ

を定義します

新しいエンティティタイプを作成するには、最初にスキーマ定義を宣言する必要があります。つまり、エンティティデータデータベーステーブルを生成するコードを書き込みます。私のdemo.installファイルには、次のコードがあります。

/**
 * Implements hook_schema().
 */
function demo_schema() {

  $schema = array();

  $schema['demo_projects'] = array(
    'description' => 'The base table for the Project entity',
    'fields' => array(
      'id' => array(
        'description' => 'Primary key of the Project entity',
        'type' => 'serial',
        'unsigned' => TRUE,
        'not null' => TRUE,
      ),
      'name' => array(
        'description' => 'Project name.',
        'type' => 'varchar',
        'length' => 255,
        'not null' => FALSE,
      ),
      'description' => array(
        'description' => 'Project description.',
        'type' => 'text',
        'size' => 'big',
        'not null' => FALSE,
        'default' => NULL
      ),
      'deadline' => array(
        'description' => 'Project deadline.',
        'type' => 'int',
        'length' => 11,
        'not null' => FALSE,
      ),
    ),
    'primary key' => array('id'),
  );

  return $schema;
}

これは、fook_schema（）の単純な実裝です。大したことではありません。

次に、hook_entity_info（）を?qū)g裝する必要があります。このフックには多くのオプションを指定できますが、ここに最も基本的で必要なオプションがあります（これはdemo.moduleファイルにあります）：

/**
 * Implements hook_entity_info().
 */
function demo_entity_info() {

  $info = array();

  $info['project'] = array(
    'label' => t('Project'),
    'base table' => 'demo_projects',
    'entity keys' => array(
      'id' => 'id',
      'label' => 'name',
    ),
    'module' => 'demo',
    'entity class' => 'Entity',
    'controller class' => 'ProjectEntityController',
  );

  return $info;
}

このフックを使用すると、エンティティマシン名を表す$ info Arrayの新しいキーを返します。この配列では、オプションを指定します（このチュートリアル中にオプションを追加します）。次に、タグ（エンティティタイプの読み取り可能な名前）、エンティティデータを格納するベーステーブル、エンティティ識(shí)別子の屬性として機(jī)能するエンティティキー、およびエンティティタイプを定義するモジュールを指定するモジュールを使用します。最後のものは必須ではありませんが、推奨されます。

この方法では、Drupalに獨(dú)自の基本エンティティタイプを登録します。動(dòng)作するかどうかをテストするには、モジュールを初めて有効にし、データベースにテーブルが作成されているかどうかを確認(rèn)します。次に、使用するものがあるように、數(shù)行で記入してください。

最後に、hook_menu（）を使用して、Drupalを使用してパス（テスト用の任意のパスに対して）を登録し、次のコールバック関數(shù)に貼り付けます。

INSERT INTO `demo_projects` (`id`, `name`, `description`, `deadline`)
VALUES
    (1, 'Summer House', 'Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.', 1397501105),
    (2, 'Winter House', 'Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.', 1397501132);

最初に、Entity_load（）関數(shù)を使用してIDS 1と2のプロジェクトエンティティをロードし、Devel DPM（）関數(shù)（テストのためにサイトでDevelが有効になっていることを確認(rèn)してください）を使用して、スクリーン上のスクリーン。ページのコールバック関數(shù)が何かを返す必要があることを忘れないでください。そうしないと、構(gòu)築されません。

このページに移動(dòng)すると、Krumoのデータベースに2つのエンティティのデータが表示されます。

$projects = entity_load('project', array(1, 2));
dpm($projects);
return 'Some string';

または、EntityFieldQueryクラスを使用して、必要なプロパティ（IDだけでなく）に基づいて新しいエンティティを照會(huì)できます。これがどのように機(jī)能するかの詳細(xì)については、このSitePointチュートリアルをご覧ください。これにより、開始に役立ちます。

エンティティクラスとコントローラー

殘念ながら、Drupal Coreはエンティティを処理するためのあまり多くのヘルパー関數(shù)を提供しません（Entity_load（）はほとんど一意です）。ただし、エンティティAPIモジュールはこのギャップを埋めます。

その機(jī)能を使用するには、以前に宣言したエンティティ情報(bào)を変更し、エンティティの処理に使用できるPHPクラスを指定する必要があります。次に、hook_entity_info（）実裝で入力されたプロジェクトアレイにさらに2つのキーを追加します：

前述のコードにはすでに

が含まれています

EntityApicOntrollerクラス（ModuleのEntity.Controller.incファイルにあります）は、エンティティを処理するための合理的なデフォルト値を提供します。デフォルトのDrupal Core DrupaldeFaultentityControllerクラスを拡張し、（他の多くのことの中でも）CRUD操作を?qū)g行する責(zé)任があります。

'entity class' => 'Entity', 'controller class' => 'ProjectEntityController',両方のクラスをカスタムモジュールに拡張して、機(jī)能を調(diào)整できます（エンティティのクエリ、読み込み、表示など）。後でこれを行う方法を確認(rèn)します。

しかし、最初に、新しいエンティティを保存する方法をお見せしたいと思います?，F(xiàn)在、私のデータベースにはID 1と2の2つのレコードがあります。上記のテストページコールバック関數(shù)に書いたコードを調(diào)整して、ID 3の新しいエンティティを作成してください。このように見えるかもしれません：

/**
 * Implements hook_schema().
 */
function demo_schema() {

  $schema = array();

  $schema['demo_projects'] = array(
    'description' => 'The base table for the Project entity',
    'fields' => array(
      'id' => array(
        'description' => 'Primary key of the Project entity',
        'type' => 'serial',
        'unsigned' => TRUE,
        'not null' => TRUE,
      ),
      'name' => array(
        'description' => 'Project name.',
        'type' => 'varchar',
        'length' => 255,
        'not null' => FALSE,
      ),
      'description' => array(
        'description' => 'Project description.',
        'type' => 'text',
        'size' => 'big',
        'not null' => FALSE,
        'default' => NULL
      ),
      'deadline' => array(
        'description' => 'Project deadline.',
        'type' => 'int',
        'length' => 11,
        'not null' => FALSE,
      ),
    ),
    'primary key' => array('id'),
  );

  return $schema;
}

ご覧のとおり、3つのプロジェクトエンティティをロードし、3番目のエンティティが存在するかどうかを確認(rèn)しようとします。存在しない場合は、エンティティAPIによって提供されるentity_create（）ヘルパー関數(shù)を使用し、プロパティをランダム値に設(shè)定し、エンティティのsave（）メソッドを使用してデータベースに持続します。このメソッドはエンティティクラスによって提供され、そのジョブは、上記で定義したコントローラークラスのsave（）メソッドを呼び出すことです。この方法は、エンティティを持続するために必要なロジックを?qū)g行します。しかし、これらはすべて舞臺(tái)裏で起こりますが、心配する必要はありません。

ページをリロードすると、2つのプロジェクトエンティティのみが返される必要がありますが、2回目は3つのプロジェクトが必要です。

エンティティクラスをカバーします

このチュートリアルのこの部分であなたに紹介したい最後のことは、エンティティを表示する方法です。これを行うには、使用しているページコールバック関數(shù)に固執(zhí)し、実際のリストになります。

最初に、デフォルトのentitityApicontrollerクラスのbuildcontent（）メソッドをオーバーライドする必要があります。その理由は、コントローラーがデータについて仮定できないため、表示する方法に関する情報(bào)を提供する必要があるためです。まず、前のクラスを拡張するコントローラークラスを宣言しましょう。

/**
 * Implements hook_entity_info().
 */
function demo_entity_info() {

  $info = array();

  $info['project'] = array(
    'label' => t('Project'),
    'base table' => 'demo_projects',
    'entity keys' => array(
      'id' => 'id',
      'label' => 'name',
    ),
    'module' => 'demo',
    'entity class' => 'Entity',
    'controller class' => 'ProjectEntityController',
  );

  return $info;
}

クラス名ProjectentityControllerを選択しましたが、hook_entity_info（）実裝のコントローラークラスキーに設(shè)定した値を必ず置き換える必要があります。忘れないで。

このクラスでは、メソッド名を元のクラスからコピーして、親クラスが返すものを返すことができます。 このクラスでは、メソッド名を元のクラスからコピーして、親クラスが返すものを返すことができます?；镜膜?つの新しいアイテムを配列に追加しました。最初のものは説明を

で包み、2番目はパラグラフラベル間にフォーマットされた日付を出力します。これは基本的なDrupalのテーマです。ここで何が起こっているのかわからない場合は、レビューしてください。ただし、プロジェクト名が不足していることに気付くでしょう。 Drupalは、hook_entity_info（）によって実裝されたエンティティキーのタグとして指定するため、自動(dòng)的にレンダリングします。最後のステップは、ページコールバック関數(shù)に移動(dòng)し、エンティティを表示させることです。簡単な方法（デモンストレーションのみのため）：

前と同様に、最初に対応するIDをエンティティにロードします。次に、それらをentity_view（）ヘルパー関數(shù)を介して実行します。これにより、最終的に上書きされたbuildcontent（）メソッドを呼び出します。この関數(shù)は、各エンティティのレンダリングされた配列のリストを返します。それぞれをレンダリングし、結(jié)果を$ outputアレイに保存し、それを連結(jié)して返品します。 <div>

ページを更新でき、ロードしたすべてのエンティティのリストが表示されます。変更が表示されるように、キャッシュがクリアされていることを確認(rèn)してください。

INSERT INTO `demo_projects` (`id`, `name`, `description`, `deadline`)
VALUES
    (1, 'Summer House', 'Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.', 1397501105),
    (2, 'Winter House', 'Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.', 1397501132);

結(jié)論

このチュートリアルでは、コード內(nèi)の獨(dú)自のエンティティタイプを定義することにより、Drupalのエンティティについて學(xué)び始めます。私たちは、それらが表すデータのスキーマ定義を書く方法と、それらをDrupalに登録する方法を?qū)Wびました。次に、エンティティAPI Contribモジュールを使用して、オブジェクト指向の方法でエンティティを処理する力がわかります。

このチュートリアルの第2部では、3つの主要な側(cè)面について説明します。まず、個(gè)々のプロジェクトエンティティを表示するためのページを作成し、プロジェクトを管理するための管理インターフェイスを起動(dòng)します。第二に、UIを介してフィールド化可能にします。第三に、適切なクエリを?qū)g行してディスプレイをリストできるように、ビューに公開します。乞うご期待！

Drupalのカスタムエンティティの構(gòu)築に関する

FAQ

Drupalカスタムエンティティを作成するための前提條件は何ですか？

Drupalカスタムエンティティの作成を開始する前に、DrupalのエンティティAPIを基本的に理解する必要があります。また、PHPの概念とオブジェクト指向プログラミングに精通している必要があります。さらに、Drupal Development環(huán)境を設(shè)定する必要があります。これには、ローカルマシンまたはサーバーにDrupalのインストールと構(gòu)成が含まれます。

Drupalにバンドルを使用してカスタムコンテンツエンティティを作成する方法は？

Drupalにバンドルを使用してカスタムコンテンツエンティティを作成するには、複數(shù)のステップが含まれます。まず、カスタムモジュールでエンティティとそのプロパティを定義する必要があります。次に、エンティティを追加および編集するフォームを作成する必要があります。その後、エンティティの運(yùn)用のルートを定義する必要があります。最後に、エンティティを表示するためにビュービルダーを作成する必要があります。

Drupalのコンテンツエンティティと構(gòu)成エンティティの違いは何ですか？

Drupalでは、コンテンツエンティティは、ユーザーが作成、編集、削除できるコンテンツフラグメントです。例には、ノード、ユーザー、コメントが含まれます。一方、構(gòu)成エンティティは、データベースに保存されている構(gòu)成フラグメントであり、コードにエクスポートできます。例には、ビュー、畫像スタイル、ユーザーロールが含まれます。

Drupal 8でコンテンツエンティティタイプを作成する方法は？

Drupal 8でコンテンツエンティティタイプの作成には、カスタムモジュールでエンティティとそのプロパティを定義することが含まれます。また、エンティティを追加および編集し、エンティティオペレーションのルートを定義し、エンティティを表示するビュービルダーを作成するフォームを作成する必要があります。

エンティティAPIモジュールを使用してDrupalでカスタムエンティティを作成できますか？

はい、エンティティAPIモジュールを使用してDrupalでカスタムエンティティを作成できます。このモジュールは、エンティティとそのプロパティを処理する統(tǒng)一された方法を提供します。また、作成、読み取り、更新、削除などのエンティティで操作を?qū)g行するためのAPIを提供します。

Drupalカスタムエンティティを作成することの利點(diǎn)は何ですか？

Drupalカスタムエンティティの作成により、獨(dú)自のデータ構(gòu)造とビジネスロジックを定義できます。これにより、サイトがより効率的で管理しやすくなります。また、カスタムエンティティを使用すると、エンティティを処理するための強(qiáng)力なツールを提供するDrupalのエンティティAPIを利用できます。

Drupalのカスタムエンティティにフィールドを追加する方法は？

Drupalのカスタムエンティティにフィールドを追加するには、フィールドAPIを使用する必要があります。これには、エンティティのベースフィールド定義方法でフィールドを定義することが含まれます。また、フィールドUIモジュールを使用して、Drupal Managementインターフェイスを介してエンティティにフィールドを追加することもできます。

Drupalにカスタムエンティティを表示する方法は？

Drupalにカスタムエンティティを表示するには、エンティティ用のビュービルダーを作成する必要があります。これには、EntityViewBuilderクラスを拡張するクラスを定義し、ビューメソッドを?qū)g裝することが含まれます。ビューモジュールを使用して、エンティティのカスタムビューを作成することもできます。

Drupalでカスタムエンティティを追加および編集するためのフォームを作成する方法は？

カスタムエンティティを追加および編集するためのDrupalにフォームを作成するには、エンティティのフォームクラスを定義する必要があります。これには、エンティティフォームクラスを拡張し、フォームを?qū)g裝、検証、および送信することが含まれます。

Drupalでカスタムエンティティを削除する方法は？

Drupalでカスタムエンティティを削除するには、エンティティAPIの削除メソッドを使用する必要があります。これには、エンティティのロード、削除メソッドの呼び出し、エンティティの保存が含まれます。エンティティAPIのdeletemultipleメソッドを使用して、複數(shù)のエンティティを一度に削除することもできます。

以上がDrupal -setupで獨(dú)自のカスタムエンティティを構(gòu)築しますの詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國語 Web サイトの他の関連記事を參照してください。