Die Funktionen für das Erstellen und Aktualisieren eines Index wurden innerhalb der Zend_Search_Lucene Komponente und von Java Lucene implementiert. Du kannst diese beiden Funktionalitäten verwenden.

Der PHP Quellcode unten zeigt ein Beispiel, wie eine Datei durch Verwendung der Zend_Search_Lucene Programmierschnittstelle (API) indiziert werden kann:

<?php

// Das Setzen des zweiten Arguments auf TRUE erstellt einen neuen Index
$index = new Zend_Search_Lucene('/data/my-index', true);

$doc = new Zend_Search_Lucene_Document();

// Speichere die URL des Dokuments, um es für Suchergebnisse ermitteln zu können
$doc->addField(Zend_Search_Lucene_Field::Text('url', $docUrl));

// Indiziere den Dokumenteninhalt
$doc->addField(Zend_Search_Lucene_Field::UnStored('contents', $docContent));

// Füge das Dokument dem Index hinzu 
$index->addDocument($doc);

// Schreibe die Änderungen in den Index.
$index->commit();
?>

Neu hinzugefügte Dokumente können nach der Übergabe aus dem Index zurückgeholt werden.

Zend_Search_Lucene::commit() wird automatisch am Ende der Skriptausführung vor jeder Suchanfrage aufgerufen.

Jeder commit() Aufruf erstellt ein neues Indexsegment. ^[6] Also muß er so selten wie möglich aufgerufen werden. Auf der anderen Seite verbraucht die Verarbeitung sehr vieler Dokumente in einem Schritt auch mehr Speicher..

Die automatische Optimierung von Segmenten ist ein Thema für zukünftige Weiterentwicklungen von Zend_Search_Lucene.

Der selbe Prozess wird verwendet, um einen vorhandenen Index zu aktualisieren. Der einzige Unterschied ist, dass der Index ohne den zweiten Parameter geöffnet werden sollte:

<?php

// Öffnen einen vorhandenen Index
$index = new Zend_Search_Lucene('/data/my-index');

$doc = new Zend_Search_Lucene_Document();

// Speichere die URL des Dokuments, um es für Suchergebnisse ermitteln zu können
$doc->addField(Zend_Search_Lucene_Field::Text('url', $docUrl));

// Indiziere den Dokumenteninhalt
$doc->addField(Zend_Search_Lucene_Field::UnStored('contents', $docContent));

// Füge das Dokument dem Index hinzu 
$index->addDocument($doc);

// Schreibe die Änderungen in den Index.
$index->commit();
?>

Jeder Aufruf von commit() (explizit oder implizit) erstellt ein neues Indexsegment.

Zend_Search_Lucene kann Segmente nicht automatisch verwalten. Deshalb solltest du dich um die Segmentgröße kümmer. Auf der einen Seite sind große Segmente optimaler, auf der anderen Seite verbrauchen große Segmente beim Erstellen mehr Speicher.

Lucene Java and Luke (Lucene Index Toolbox - http://www.getopt.org/luke/) können für die Indexoptimierung dieser Zend_Search_Lucene Version verwendet werden.

Das Lucene Indexdateiformat unterstützt keine Aktualisierung von Dokumenten. Ein Dokument sollte entfernt und wieder hinzugefügt werden, um eine Aktualisierung zu erreichen.

Die Zend_Search_Lucene::delete() Methode arbeitet mit einer internen Index Dokumentennummer. Sie kann aus dem Ergebnistreffer über die 'id' Eigenschaft erhalten werden:

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