クエリは、単語と演算子から成り立ちます。単語には三種類の形式があります。 単一の単語、フレーズ、そしてサブクエリです。

単一の単語とは、"test" や "hello" のようなひとつの単語です。

フレーズとは、ダブルクォートで囲まれた複数の単語のグループ、たとえば "hello dolly" です。

サブクエリとは、括弧で囲まれたクエリ、たとえば "(hello dolly)" です。

複数の単語を論理演算子で組み合わせることで、より複雑なクエリを作成できます (以下を参照ください)。

Lucene は、フィールド指定したデータをサポートしています。 検索を行う際には、クエリを指定することもできますし、 デフォルトのフィールドを使用することもできます。 フィールド名はインデックス化されたデータに依存します。また、 デフォルトのフィールドは現在の設定によって決まります。

Java Lucene との最初の (そして大きな) 違いは、デフォルトでは すべてのフィールド が検索の対象になるということです。

Zend_Search_Lucene クラスにはふたつの静的メソッドがあり、 この設定を操作することができます。

<?php
$defaultSearchField = Zend_Search_Lucene::getDefaultSearchField();
...
Zend_Search_Lucene::setDefaultSearchField('contents');

null 値は、すべてのフィールドを検索の対象とすることを意味します。 これがデフォルトの設定です。

フィールドを指定するには、まずフィールド名をタイプし、その後にコロン ":" を続け、探したい単語を指定します。

例を見てみましょう。Lucene インデックスにはふたつのフィールド title および text があり、text がデフォルトのフィールドであるとします。 タイトルが "The Right Way" で本文に "don't go this way" が含まれるドキュメントを探したいなら、

title:"The Right Way" AND text:go

あるいは

title:"Do it right" AND go

とします。"text" がデフォルトのフィールドなら、フィールドの指定は必須ではなくなります。

注意: フィールドが有効なのは、その直後にある単語、 フレーズあるいはサブクエリだけであることに注意しましょう。つまり、クエリ

title:Do it right

は "Do" だけを title フィールドから探し、"it" や "right" はデフォルトのフィールドから探します。デフォルトのフィールドが null に設定されている場合は、"it" や "right" はすべてのフィールドから探します。

Lucene は、クエリの単語を修飾して幅広い検索オプションを指定することをサポートしています。

Zend_Search_Lucene では、現在は "~" 修正子をフレーズについてのみサポートしています。 ^[9]

Lucene は、複数の単語が指定した範囲内にあらわれる状態の検索をサポートしています。 近接検索を行うには、チルダ記号 "~" をフレーズの最後に指定します。 たとえば、"Zend" と "Framework" がお互い 10 ワードの範囲内にあらわれるドキュメントを検索するには

"Zend Framework"~10

とします。

Java Lucene および Zend_Search_Lucene は、 見つかった単語にもとづいてドキュメントの関連度を提供します。 ある単語の関連性を高くするには、キャレット記号 "^" に強調度 (数値) をあわせたものを、検索する単語の最後につなげます。 強調度を高くするほど、その単語の関連性が高くなります。

この機能を使用すると、単語の強調度によってドキュメントの関連性を制御できるようになります。 たとえば

PHP framework

を検索しようとしており、単語 "PHP" をより重視したいとしましょう。 そんな場合は ^ 記号と強調度を単語の後に続けます。つまり

PHP^4 framework

のようにします。これにより、PHP という単語を含むドキュメントがより重視されるようになります。 フレーズやサブクエリを強調することも可能です。たとえば

"PHP framework"^4 "Zend Framework"

のようになります。デフォルトの強調度は 1 です。強調度には正の数値を指定しますが、 1 より小さくする (たとえば 0.2 など) ことも可能です。

論理演算子によって、複数の単語を組み合わせることができます。 Lucene では、論理演算子として AND、"+"、OR、NOT および "-" をサポートしています。Java Lucene では論理演算子をすべて大文字にする必要がありますが、 Zend_Search_Lucene ではその必要はありません。

論理演算子によって、複数の単語を組み合わせることができます。 Lucene では、論理演算子として AND、"+"、OR、NOT および "-" をサポートしています。

論理クエリを作成するための方式は、大きく AND、OR および NOT の組と "+"、"-" の組に分けられます。Java Lucene とは異なり、Zend_Search_Lucene ではこれらの二つの組を混ぜて使うことはできません。

AND/OR/NOT 形式を使用する場合は、AND/OR 演算子がすべてのクエリ単語の間に存在する必要があります。 各単語の前には NOT 演算子をつけることができます。AND 演算子の優先順位は OR より高くなります。これは Java Lucene の挙動とは異なります。

"PHP framework" AND "Zend Framework"

"PHP framework" OR "Zend Framework"

"PHP framework" AND NOT "Zend Framework"

+Zend Framework

"PHP framework" -"Zend Framework"

+"PHP framework" "Zend Framework"

Java Lucene および Zend_Search_Lucene では、 括弧を使用して条件をグループ化することによるサブクエリの作成をサポートしています。 これは、クエリのロジックを制御したい場合や異なるスタイルの論理クエリを共用したい場合などに便利です。

+(framework OR library) +php

Zend_Search_Lucene は、あらゆるレベルのサブクエリをサポートしています。

Lucene では、括弧を使用して複数の条件をひとつのフィールドに適用することができます。

タイトルに単語 "return" とフレーズ "pink panther" の両方を含むドキュメントを検索するには

title:(+return +"pink panther")

を使用します。Zend_Search_Lucene は、あらゆるレベルのサブクエリをサポートしています。

Lucene は、クエリの文法に含まれる特殊文字のエスケープをサポートしています。 特殊文字に含まれるの文字は次のとおりです。

+ - && || ! ( ) { } [ ] ^ " ~ * ? : \

+ および - が単一の単語の中に含まれる場合は、通常の文字として扱われます。

これらの文字をエスケープするには、その文字の前に \ をつけます。 たとえば、(1+1):2 を検索するには

\(1\+1\)\:2

を使用します。