PHP5

Возможности по созданию и обновлению индекса реализованы в модуле Zend_Search_Lucene и Java Lucene. Вы можете использовать обе эти возможности.

Приведенный ниже листинг кода PHP дает пример того, как индексировать файл, используя программный интерфейс Zend_Search_Lucene для индексирования.

<?php
// Создание индекса
$index = Zend_Search_Lucene::create('/data/my-index');

$doc = new Zend_Search_Lucene_Document();

// Сохранение URL документа для того, чтобы идентифицировать его
// в результатах поиска
$doc->addField(Zend_Search_Lucene_Field::Text('url', $docUrl));

// Индексирование содержимого документа
$doc->addField(Zend_Search_Lucene_Field::UnStored('contents', $docContent));

// Добавление документа в индекс
$index->addDocument($doc);
?>

Только что добавленные документы можно сразу извлекать из индекса.

Та же самая процедура используется при обновлении существующего индекса. Единственное отличие состоит в том, что вместо метода create() вызывается метод open():

<?php
// Открытие существующего индекса
$index = Zend_Search_Lucene::open('/data/my-index');

$doc = new Zend_Search_Lucene_Document();
// Сохраниение URL документа для того, чтобы идентифицировать его в результатах поиска.
$doc->addField(Zend_Search_Lucene_Field::Text('url', $docUrl));
// Индексация содержимого документа.
$doc->addField(Zend_Search_Lucene_Field::UnStored('contents', $docContent));

// Добавление документа в индекс.
$index->addDocument($doc);
?>   

Формат файлов индекса Lucene не поддерживает обновление документов. Для обновления документ должен быть удален и добавлен снова.

Метод Zend_Search_Lucene::delete() оперирует с внутренним идентификатором индекса документа. Он может быть получен из результата запроса ("хит") через свойство 'id':

<?php
$removePath = ...;
$hits = $index->find('path:' . $removePath);
foreach ($hits as $hit) {
    $index->delete($hit->id);
}
?>

В Zend_Search_Lucene есть два способа получения размера индекса.

Метод Zend_Search_Lucene::maxDoc() возвращает число, на единицу большее, чем наибольший возможный номер документа. Фактически это общее количество документов в индексе, включая удаленные. У этого метода есть синоним - Zend_Search_Lucene::count().

Zend_Search_Lucene::numDocs() возвращает общее количество не удаленных документов.

<?php
$indexSize = $index->count();
$documents = $index->numDocs();
?>

Метод Zend_Search_Lucene::isDeleted($id) может использоваться для проверки того, был ли документ удален.

<?php
for ($count = 0; $count < $index->maxDoc(); $count++) {
    if ($index->isDeleted($count)) {
        echo "Document #$id is deleted.\n";
    }
}
?>

При оптимизации индекса производится очищение индекса от удаленных документов и сжатие диапазона используемых идентификаторов. Поэтому внутренний идентификатор документа может изменяться

Индекс Lucene состоит из сегментов. Каждый сегмент является независимой порцией данных.

Файлы сегментов индекса Lucene по своей природе не могут обновляться. Обновление сегмента требует его полной реорганизации. За подробностями см. форматы файлов индекса (http://lucene.apache.org/java/docs/fileformats.html). Новые документы добавляются в индекс путем создания новых сегментов.

Увеличение числа сегментов ухудшает качество индекса, но оптимизация индекса восстанавливает его. Оптимизация сводится к объединению нескольких сегментов в один. Этот процедура также не обновляет сегменты. Она создает новый большой сегмент, который содержит новый оптимизированный сегмент вместо набора старых сегментов и обновляет список сегментов (файл 'segments').

Полная оптимизация индекса может производиться через вызов метода Zend_Search_Lucene::optimize(). Он объединяет все сегменты индекса в один.

<?php
// Открытие существующего индекса
$index = Zend_Search_Lucene::open('/data/my-index');

// Оптимизация индекса
$index->optimize();
?>

Автоматическая оптимизация индекса выполняется для поддержания индекса в согласованном состоянии.

Автоматическая оптимизация является итеративным процессом, управление которым производится посредством нескольких опций. В процессе этой оптимизации очень маленькие сегменты объединяются в сегменты большего размера, затем эти сегменты объединяются в еще большие и т.д.

Ограничения зависят от платформы.

Для 32-битной платформы максимальный размер индекса составляет 2Гб.