Глава 22. Zend_Search
Пред. |  | След.

## Глава 22. Zend_Search

## 22.1. Обзор

### 22.1.1. Введение

Zend_Search_Lucene является поисковым движком общего назначения для полнотекстового поиска, написанным полностью на PHP 5. Так как он хранит индекс в файловой системе и не требует наличия сервера баз данных, то дает возможность реализовать поиск практически для всех веб-сайтов, работающих под управлением PHP. Zend_Search_Lucene поддерживает следующие возможности:

- Ранжированный поиск — более подходящие результаты возвращаются первыми

- Множество типов запросов: поиск фраз, поиск с шаблонами, поиск по критерию близости, поиск по диапазону значений и т.д. [7]

- Поиск по определенному полю (например: заголовок, автор, содержимое)

Zend_Search_Lucene произошел от проекта Apache Lucene. За более подробной информацией см. http://lucene.apache.org/java/docs/.

### 22.1.2. Объекты документа и поля

Zend_Search_Lucene оперирует с документами как с элементарными объектами для индексации. Документ делится на именованные поля, содержащие контент, по которому может производиться поиск.

Документ представлен объектом Zend_Search_Lucene_Document, этот объект содержит объекты Zend_Search_Lucene_Field, представляющие собой поля документа.

Важно отметить, что в индекс может быть добавлена любая информация. Данные вашего приложения или метаданные могут сохраняться в полях документа и после извлекаться вместе с документом в процессе поиска.

Приложение отвественно за процесс индексации. Как следствие, проиндексированы могут быть данные из любых источников, доступных приложению. Например, это могут быть файловая система, база данных, форма HTML и т.д.

Класс `Zend_Search_Lucene_Field` предоставляет несколько статических методов для создания полей с различными характеристиками.

    <?php
    $doc = new Zend_Search_Lucene_Document();

    // Данные поля не разбиваются на лексемы,
    // но индексируются и полностью сохраняются в индексе.
    // Сохраненные данные поля могут быть получены из индекса.
    $doc->addField(Zend_Search_Lucene_Field::Keyword('doctype',
                                                     'autogenerated'));

    // Данные поля не разбиваются на лексемы и не индексируются,
    // но полностью сохраняются в индексе.
    $doc->addField(Zend_Search_Lucene_Field::UnIndexed('created',
                                                       time()));

    // Бинарное поле, данные которого не разбиваются на лексемы и не индексируются,
    // но сохраняются в индексе.
    $doc->addField(Zend_Search_Lucene_Field::Binary('icon',
                                                    $iconData));

    // Данные поля разбиваются на лексемы, индексируются
    // и полностью сохраняются в индексе.
    $doc->addField(Zend_Search_Lucene_Field::Text('annotation',
                                                  'Document annotation text'));

    // Данные поля разбиваются на лексемы и индексируются,
    // но не сохраняются в индексе.
    $doc->addField(Zend_Search_Lucene_Field::UnStored('contents',
                                                      'My document content'));

    ?>

Каждый из этх методов (исключая метод `Zend_Search_Lucene_Field::Binary()`) имеет необязательный параметр `$encoding`. Через него указывается кодировка для входных данных.

Кодировка может различаться как для документов, так и для полей в одном документе.

    <?php
    $doc = new Zend_Search_Lucene_Document();
    $doc->addField(Zend_Search_Lucene_Field::Text('title', $title, 'iso-8859-1'));
    $doc->addField(Zend_Search_Lucene_Field::UnStored('contents', $contents, 'utf-8'));
    ?>

Если этот параметр опущен, то используется текущая локаль. Например:

    <?php
    setlocale(LC_ALL, 'de_DE.iso-8859-1');
    ...
    $doc->addField(Zend_Search_Lucene_Field::UnStored('contents', $contents));
    ?>

Поля всегда сохраняются и возвращаются из индекса в кодировке UTF-8. Преобразование в UTF-8 производится автоматически.

Анализатор текста (см. далее) может также преобразовывать текст в другие кодировки. В настоящее время используемый по умолчанию анализатор преобразует текст в кодировку 'ASCII//TRANSLIT'. Имейте в виду, что такое преобразование может зависеть от текущей локали.

Имена полей могут быть любыми.

Java Lucene по умолчанию использует для поиска поле "contents". Zend_Search_Lucene по умолчанию производит поиск по всем полям, но это поведение можно изменить. За подробностями см. Поля для поиска.

### 22.1.3. Значение типов полей

- Поля `Keyword` полностью сохраняются и индексируются, это означает, что можно не только производить поиск в них, но и отображать их в результатах поиска. Они не делятся на отдельные слова посредством разбиения на лексемы. Нумерованные поля БД обычно преобразуются в поля Keyword в Zend_Search_Lucene.

- В полях `UnIndexed` нельзя производить поиск, но они возвращаются в результатах поиска. Поля timestamp, ключевые поля, пути в файловой системе и другие внешние идентификаторы — хорошие кандидаты для того, чтобы быть полями UnIndexed.

- Поля `Binary` не разбиваются на лексемы и не индексируются, но сохраняются для возвращения в результатах поиска. Они могут использоваться для хранения любых данных, закодированных в виде бинарной строки — как, например, иконки.

- Поля `Text` сохраняются, разбиваются на лексемы и индексируются. Текстовые поля подходят для хранения такой информации, как темы и заголовки — в них нужно не только искать, но и возвращать с результатами поиска.

- Поля `UnStored` разбиваются на лексемы и индексируются, но не сохраняются в индексе. Тексты большого объема лучше индексировать, используя этот тип поля. Хранение таких данных создает индекс, который занимает много места на диске, поэтому если нужно искать в данных, но не выводить их, то используйте поле UnStored. Поля UnStored полезны, когда используется индекс Zend_Search_Lucene в комбинации с реляционной БД. Вы можете индексировать большие поля данных для поиска с помощью UnStored и извлекать их из реляционной БД, используя отдельные поля как идентификаторы.

  Таблица 22.1. Типы Zend_Search_Lucene_Field

  Тип поля | Сохраняется | Индексируется | Разбивается на лексемы | Бинарное
  --- | --- | --- | --- | ---
  Keyword | Да | Да | Нет | Нет
  UnIndexed | Да | Нет | Нет | Нет
  Binary | Да | Нет | Нет | Да
  Text | Да | Да | Да | Нет
  UnStored | Нет | Да | Да | Нет

[7] Сейчас поддерживается поиск по одному и нескольким элементам, фразам, булевы операторы и подзапросы.

Пред. |  | След.
21.3. Zend_Rest_Server | Начало | 22.2. Индексация