Public Member Functions
	getFormatVersion ()
	Get index format version.

	setFormatVersion ($formatVersion)
	Set index format version.

	getDirectory ()
	Returns the Zend_Search_Lucene_Storage_Directory instance for this index.

	count ()
	Returns the total number of documents in this index (including deleted documents).

	maxDoc ()
	Returns one greater than the largest possible document number.

	numDocs ()
	Returns the total number of non-deleted documents in this index.

	isDeleted ($id)
	Checks, that document is deleted.

	getMaxBufferedDocs ()
	Retrieve index maxBufferedDocs option.

	setMaxBufferedDocs ($maxBufferedDocs)
	Set index maxBufferedDocs option.

	getMaxMergeDocs ()
	Retrieve index maxMergeDocs option.

	setMaxMergeDocs ($maxMergeDocs)
	Set index maxMergeDocs option.

	getMergeFactor ()
	Retrieve index mergeFactor option.

	setMergeFactor ($mergeFactor)
	Set index mergeFactor option.

	find ($query)
	Performs a query against the index and returns an array of Zend_Search_Lucene_Search_QueryHit objects.

	getFieldNames ($indexed=false)
	Returns a list of all unique field names that exist in this index.

	getDocument ($id)
	Returns a Zend_Search_Lucene_Document object for the document number $id in this index.

	hasTerm (Zend_Search_Lucene_Index_Term $term)
	Returns true if index contain documents with specified term.

	termDocs (Zend_Search_Lucene_Index_Term $term, $docsFilter=null)
	Returns IDs of all the documents containing term.

	termDocsFilter (Zend_Search_Lucene_Index_Term $term, $docsFilter=null)
	Returns documents filter for all documents containing term.

	termFreqs (Zend_Search_Lucene_Index_Term $term, $docsFilter=null)
	Returns an array of all term freqs.

	termPositions (Zend_Search_Lucene_Index_Term $term, $docsFilter=null)
	Returns an array of all term positions in the documents.

	docFreq (Zend_Search_Lucene_Index_Term $term)
	Returns the number of documents in this index containing the $term.

	getSimilarity ()
	Retrive similarity used by index reader.

	norm ($id, $fieldName)
	Returns a normalization factor for "field, document" pair.

	hasDeletions ()
	Returns true if any documents have been deleted from this index.

	delete ($id)
	Deletes a document from the index.

	addDocument (Zend_Search_Lucene_Document $document)
	Adds a document to this index.

	commit ()
	Commit changes resulting from delete() or undeleteAll() operations.

	optimize ()
	Optimize index.

	terms ()
	Returns an array of all terms in this index.

	undeleteAll ()
	Undeletes all documents currently marked as deleted in this index.

	addReference ()
	Add reference to the index object.

	removeReference ()
	Remove reference from the index object.

Public Member Functions inherited from Zend_Search_Lucene_Index_TermsStream_Interface
	resetTermsStream ()
	Reset terms stream.

	skipTo (Zend_Search_Lucene_Index_Term $prefix)
	Skip terms stream up to the specified term preffix.

	nextTerm ()
	Scans terms dictionary and returns next term.

	currentTerm ()
	Returns term in current position.

	closeTermsStream ()
	Close terms stream.

Static Public Member Functions
static	getActualGeneration (Zend_Search_Lucene_Storage_Directory $directory)
	Get current generation number.

static	getSegmentFileName ($generation)
	Get segments file name.

static	setDefaultSearchField ($fieldName)
	Set default search field.

static	getDefaultSearchField ()
	Get default search field.

static	setResultSetLimit ($limit)
	Set result set limit.

static	getResultSetLimit ()
	Set result set limit.

Member Function Documentation

addDocument ( Zend_Search_Lucene_Document $document )

Adds a document to this index.

Parameters

Zend_Search_Lucene_Document $document

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

addReference ( )

Add reference to the index object.

Implemented in Zend_Search_Lucene_MultiSearcher, Zend_Search_Lucene, and Zend_Search_Lucene_Proxy.

commit ( )

Commit changes resulting from delete() or undeleteAll() operations.

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

count ( )

Returns the total number of documents in this index (including deleted documents).

Returns: integer

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

delete ( $id )

Deletes a document from the index.

$id is an internal document id

Parameters

integer | Zend_Search_Lucene_Search_QueryHit $id

Exceptions

Zend_Search_Lucene_Exception

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

docFreq ( Zend_Search_Lucene_Index_Term $term )

Returns the number of documents in this index containing the $term.

Parameters

Zend_Search_Lucene_Index_Term $term

Returns: integer

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

find ( $query )

Performs a query against the index and returns an array of Zend_Search_Lucene_Search_QueryHit objects.

Input is a string or Zend_Search_Lucene_Search_Query.

Parameters

mixed $query

Returns: array Zend_Search_Lucene_Search_QueryHit

Exceptions

Zend_Search_Lucene_Exception

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

static getActualGeneration ( Zend_Search_Lucene_Storage_Directory $directory )

static

Get current generation number.

Returns generation number 0 means pre-2.1 index format -1 means there are no segments files.

Parameters

Zend_Search_Lucene_Storage_Directory $directory

Returns: integer

Exceptions

Zend_Search_Lucene_Exception

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

static getDefaultSearchField ( )

static

Get default search field.

Null means, that search is performed through all fields by default

Returns: string

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

getDirectory ( )

Returns the Zend_Search_Lucene_Storage_Directory instance for this index.

Returns: Zend_Search_Lucene_Storage_Directory

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

getDocument ( $id )

Returns a Zend_Search_Lucene_Document object for the document number $id in this index.

Parameters

integer | Zend_Search_Lucene_Search_QueryHit $id

Returns: Zend_Search_Lucene_Document

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

getFieldNames ( $indexed = false )

Returns a list of all unique field names that exist in this index.

Parameters

boolean $indexed

Returns: array

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

getFormatVersion ( )

Get index format version.

Returns: integer

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

getMaxBufferedDocs ( )

Retrieve index maxBufferedDocs option.

maxBufferedDocs is a minimal number of documents required before the buffered in-memory documents are written into a new Segment

Default value is 10

Returns: integer

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

getMaxMergeDocs ( )

Retrieve index maxMergeDocs option.

maxMergeDocs is a largest number of documents ever merged by addDocument(). Small values (e.g., less than 10,000) are best for interactive indexing, as this limits the length of pauses while indexing to a few seconds. Larger values are best for batched indexing and speedier searches.

Default value is PHP_INT_MAX

Returns: integer

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

getMergeFactor ( )

Retrieve index mergeFactor option.

mergeFactor determines how often segment indices are merged by addDocument(). With smaller values, less RAM is used while indexing, and searches on unoptimized indices are faster, but indexing speed is slower. With larger values, more RAM is used during indexing, and while searches on unoptimized indices are slower, indexing is faster. Thus larger values (> 10) are best for batch index creation, and smaller values (< 10) for indices that are interactively maintained.

Default value is 10

Returns: integer

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

static getResultSetLimit ( )

static

Set result set limit.

0 means no limit

Returns: integer

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

static getSegmentFileName ( $generation )

static

Get segments file name.

Parameters

integer $generation

Returns: string

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

getSimilarity ( )

Retrive similarity used by index reader.

Returns: Zend_Search_Lucene_Search_Similarity

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

hasDeletions ( )

Returns true if any documents have been deleted from this index.

Returns: boolean

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

hasTerm ( Zend_Search_Lucene_Index_Term $term )

Returns true if index contain documents with specified term.

Is used for query optimization.

Parameters

Zend_Search_Lucene_Index_Term $term

Returns: boolean

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

isDeleted ( $id )

Checks, that document is deleted.

Parameters

integer $id

Returns: boolean

Exceptions

Zend_Search_Lucene_Exception Exception is thrown if $id is out of the range

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

maxDoc ( )

Returns one greater than the largest possible document number.

This may be used to, e.g., determine how big to allocate a structure which will have an element for every document number in an index.

Returns: integer

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

norm	(	$id,
		$fieldName
	)

Returns a normalization factor for "field, document" pair.

Parameters

integer	$id
string	$fieldName

Returns: float

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

numDocs ( )

Returns the total number of non-deleted documents in this index.

Returns: integer

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

optimize ( )

Optimize index.

Merges all segments into one

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

removeReference ( )

Remove reference from the index object.

When reference count becomes zero, index is closed and resources are cleaned up

Implemented in Zend_Search_Lucene_MultiSearcher, Zend_Search_Lucene, and Zend_Search_Lucene_Proxy.

static setDefaultSearchField ( $fieldName )

static

Set default search field.

Null means, that search is performed through all fields by default

Default value is null

Parameters

string $fieldName

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

setFormatVersion ( $formatVersion )

Set index format version.

Index is converted to this format at the nearest upfdate time

Parameters

int $formatVersion

Exceptions

Zend_Search_Lucene_Exception

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

setMaxBufferedDocs ( $maxBufferedDocs )

Set index maxBufferedDocs option.

maxBufferedDocs is a minimal number of documents required before the buffered in-memory documents are written into a new Segment

Default value is 10

Parameters

integer $maxBufferedDocs

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

setMaxMergeDocs ( $maxMergeDocs )

Set index maxMergeDocs option.

maxMergeDocs is a largest number of documents ever merged by addDocument(). Small values (e.g., less than 10,000) are best for interactive indexing, as this limits the length of pauses while indexing to a few seconds. Larger values are best for batched indexing and speedier searches.

Default value is PHP_INT_MAX

Parameters

integer $maxMergeDocs

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

setMergeFactor ( $mergeFactor )

Set index mergeFactor option.

mergeFactor determines how often segment indices are merged by addDocument(). With smaller values, less RAM is used while indexing, and searches on unoptimized indices are faster, but indexing speed is slower. With larger values, more RAM is used during indexing, and while searches on unoptimized indices are slower, indexing is faster. Thus larger values (> 10) are best for batch index creation, and smaller values (< 10) for indices that are interactively maintained.

Default value is 10

Parameters

integer $maxMergeDocs

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

static setResultSetLimit ( $limit )

static

Set result set limit.

0 (default) means no limit

Parameters

integer $limit

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

termDocs	(	Zend_Search_Lucene_Index_Term	$term,
			$docsFilter = `null`
	)

Returns IDs of all the documents containing term.

Parameters

Zend_Search_Lucene_Index_Term	$term
Zend_Search_Lucene_Index_DocsFilter \| null	$docsFilter

Returns: array

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

termDocsFilter	(	Zend_Search_Lucene_Index_Term	$term,
			$docsFilter = `null`
	)

Returns documents filter for all documents containing term.

It performs the same operation as termDocs, but return result as Zend_Search_Lucene_Index_DocsFilter object

Parameters

Zend_Search_Lucene_Index_Term	$term
Zend_Search_Lucene_Index_DocsFilter \| null	$docsFilter

Returns: Zend_Search_Lucene_Index_DocsFilter

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

termFreqs	(	Zend_Search_Lucene_Index_Term	$term,
			$docsFilter = `null`
	)

Returns an array of all term freqs.

Return array structure: array( docId => freq, ...)

Parameters

Zend_Search_Lucene_Index_Term	$term
Zend_Search_Lucene_Index_DocsFilter \| null	$docsFilter

Returns: integer

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

termPositions	(	Zend_Search_Lucene_Index_Term	$term,
			$docsFilter = `null`
	)

Returns an array of all term positions in the documents.

Return array structure: array( docId => array( pos1, pos2, ...), ...)

Parameters

Zend_Search_Lucene_Index_Term	$term
Zend_Search_Lucene_Index_DocsFilter \| null	$docsFilter

Returns: array

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

terms ( )

Returns an array of all terms in this index.

Returns: array

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

undeleteAll ( )

Undeletes all documents currently marked as deleted in this index.

Implemented in Zend_Search_Lucene, Zend_Search_Lucene_MultiSearcher, and Zend_Search_Lucene_Proxy.

Public Member Functions

Static Public Member Functions

Member Function Documentation