web-dev-qa-db-ja.com

EntityFieldQueryの適切な使用法は何ですか？

Drupal 7では、node_load_multiple()のAPIドキュメントで_$conditions_パラメータの使用が指定されているため、EntityFieldQueryの使用が推奨されています。クラスを使用して、node_load_multiple()で使用するノードIDのリストを生成しますか？他のユースケースはありますか？

7database
37
user7

EntityFieldQueryは一連のフックを使用して、フィールドと他のノードプロパティを操作するために、フィールドSQLストレージなどのフィールドストレージモジュールとインターフェイスします。長期的には、EntityFieldQueryはあらゆるタイプのエンティティをクエリするためのはるかに信頼性の高い方法であり、一部の状況ではエンティティ間クエリを実行できます（ field_has_data または _ list_values_in_use（） を参照してください）例。

EntityFieldQueryを使用して、特定のタイムスタンプの前に公開されたすべてのノードのリストを取得する簡単な例を次に示します。

$query = new EntityFieldQuery();

$query
  ->entityCondition('entity_type', 'node', '=')
  ->propertyCondition('status', 1, '=')
  ->propertyCondition('created', '1294694496', '<');

$result = $query->execute();

そのクエリの$ resultsは次のようになります。

Array
(
    [node] => Array
        (
            [1] => stdClass Object
                (
                    [nid] => 1
                    [vid] => 49
                    [type] => article
                )

            [2] => stdClass Object
                (
                    [nid] => 2
                    [vid] => 2
                    [type] => page
                )

        )

)

次に、その配列をnode_load_multipleへの入力として使用できます。

$nodes = node_load_multiple(array_keys($result['node']));
36
Mikey P

DrupalでEntityFieldQueryの例を追加することについての問題を見つけました。これを例として使用したり、他の例の呼び出しについて私の意見を表明したりしています。

" EntityFieldQueryの例が必要ですか？ "

コメント＃11 は、以下のようにnode_load_multiple()の使用法を示しています。

$query = new EntityFieldQuery();
$entities = $query->entityCondition('entity_type', 'node')
                        ->entityCondition('bundle', 'event')
                        ->propertyCondition('status', 1)
                        ->fieldCondition('field_date', 'value', array('2011-03-01', '2011-03-31'), 'BETWEEN')
                        ->fieldOrderBy('field_date', 'value', 'ASC')
                        ->execute();

$nodes = entity_load('node', array_keys($entities['node']));
return node_view_multiple($nodes, 'teaser');
14
electblake

以下は、テストモジュールの1つからの例です。

http://api.drupal.org/api/drupal/modules--node--tests--node_access_test.module/function/node_access_entity_test_page/7

これにより、ボディフィールドが「A」で始まるノードが選択されます。返された結果の使用方法については、 EntityFieldQuery :: execute（） も参照してください。

多くの使用例がありますが、典型的な例は、最初の例に示すように、bodyフィールドのような特定のフィールド値についてエンティティをクエリすることです。

利点は、使用しているどのfield_storageでも機能することです。たとえば、MongoDBにフィールドを含めることができ、EntityQueryは引き続き機能しますが、field_data_bodyを手動でクエリすることはできません。

8
Berdir

EntityFieldQuery クラスを使用してデータベースにクエリを実行し、結果を node_load_multiple() のようなリスト形式でフェッチできます。

これは、クラスを作成し、条件を適用してクエリを実行することで実現できます。次に例を示します。

_<?php
$query = new EntityFieldQuery();
$query
  ->entityCondition('entity_type', 'TYPE') // E.g. node, entityform, taxonomy_term
  ->entityCondition('bundle', 'BUNDLE')
  ->fieldCondition('field_foo', 'value', 'STRING')
  ->range(0,10);
$result = $query->execute();
?>
_

これにより、次のような配列が生成されます。

_array (
  'TYPE' =>
  array (
    123 =>
    stdClass::__set_state(array(
       'nid' => '123', // Can be also tid when loading terms.
       'key' => 'value',
    )),
    456 =>
    stdClass::__set_state(array(
       'nid' => '456',
       'key' => 'value',
    )),
  ),
)
_

結果の配列からIDをフェッチするには、current(current($result))->tidを使用できます。

これはより高度な例です：

_<?php
$query = new EntityFieldQuery();

$query->entityCondition('entity_type', 'node')
  ->entityCondition('bundle', 'article')
  ->propertyCondition('status', NODE_PUBLISHED)
  ->fieldCondition('field_news_types', 'value', 'spotlight', '=')
  ->fieldCondition('field_photo', 'fid', 'NULL', '!=')
  ->fieldCondition('field_faculty_tag', 'tid', $value)
  ->fieldCondition('field_news_publishdate', 'value', $year . '%', 'like')
  ->fieldOrderBy('field_photo', 'fid', 'DESC')
  ->range(0, 10)
  ->addMetaData('account', user_load(1)); // Run the query as user 1.

$result = $query->execute();

if (isset($result['node'])) {
  $news_items_nids = array_keys($result['node']);
  $news_items = entity_load('node', $news_items_nids);
}
?>
_

詳細については、Drupal.orgの EntityFieldQueryの使用方法 を参照してください。

0
kenorb