ÜberblickEinführungZend_Search_Lucene ist eine komplett in PHP 5 geschriebene Textsuchmaschine für viele Zwecke. Da es seinen Index im Dateisystem ablegt und keinen Datenbankserver erfordert, kann es eine Suchfunktion für nahezu jede auf PHP basierende Website bereitstellen. Zend_Search_Lucene unterstützt die folgenden Funktionalitäten:
Dokumenten- und FeldobjekteFür die Indizierung verarbeitet Zend_Search_Lucene Dokumente als atomare Objekte. Ein Dokument wird in benannte Felder unterteilt und diese Felder enthalten Inhalte, die durchsucht werden können. Ein Dokument wird durch die Zend_Search_Lucene_Document Klasse abgebildet und die Objekte dieser Klasse enthalten Instanzen von Zend_Search_Lucene_Field, welche die Felder dieses Objektes repräsentieren. Es ist wichtig zu beachten, dass dem Index jegliche Informationen hinzugefügt werden können. Anwendungsspezifische Informationen oder Metadaten können in den Dokumentfeldern gespeichert und später bei der Suche aus dem Dokument zurückgeholt werden. Es liegt in der Verantwortung deiner Anwendung, den Indexer zu kontrollieren. Das bedeutet, dass die Daten aus jeder Quelle indiziert werden können, die von deiner Anwendung aus ansprechbar ist. Zum Beispiel könnten dies das Dateisystem, eine Datenbank, ein HTML Formular, usw. sein. Die Zend_Search_Lucene_Field Klasse stellt verschiedene statische Methoden zum Erstellen mit unterschiedlichen Charakteristika bereit:
Jede dieser Methoden (ausser der Zend_Search_Lucene_Field::Binary() Methode) hat einen optionalen $encoding Parameter. Er definiert das Encoding für Eingabedaten. Die Codierung kann für unterschiedliche Dokumente verschieden sein genauso wie für unterschiedliche Felder innerhalb eines Dokuments:
Wenn der encoding Parameter nicht angegeben wurde, wird das aktuelle Gebietsschema während der Verarbeitungzeit verwendet. Zum Beispiel:
Felder werden immer gespeichert und vom Index in UTF-8 Codierung zurückgegeben. Jede notwendige Konvertierung zu UTF-8 geschieht automatisch. Text Analysatoren (siehe unten) können auch Text in andere Codierungen konvertieren. Aktuell konvertiert der Standard Analysator Text in die 'ASCII//TRANSLIT' Codierung. Man sollte aber vorsichtig sein; diese Übersetzung hängt vom aktuellen Gebietsschema ab. Feld Namen werden durch die Auswahl in der addField() Methode definiert. Java Lucene verwendet das "contents" Feld für die Suche als Standardfeld. Zend_Search_Lucene durchsucht standardmäßig alle Felder, aber dieses Verhalten ist konfigurierbar. Für Details siehe das Kapitel "Standardsuchfeld". Verstehen der Feldtypen
HTML DokumenteZend_Search_Lucene bietet ein HTML Parsing Feature. Dokumente können direkt von einer HTML Datei oder String erzeugt werden: Die Zend_Search_Lucene_Document_Html Klasse verwendet die DOMDocument::loadHTML() und die DOMDocument::loadHTMLFile() Methode um die HTML Quelle zu analysieren, deswegen benötigt Sie kein gut geformtes HTML noch ein XHTML. Auf der anderen Seite ist es abhängig von der angegebenen Codierung im "meta http-equiv" Tag Header. Die Zend_Search_Lucene_Document_Html Klasse erkennt Dokument Titel, Body Dokument Header Meta Tags. Das 'title' Feld ist aktuell der /html/head/title Wert. Er wird inneralb des Index gespeichert, Tokenized und für die Suche zur Verfügung gestellt. Das 'body' Feld ist aktuell der Inhalt vom Body der HTML Datei oder des Strings. Er enthält keine Skripte, Kommentare oder Attribute. Die loadHTML() und loadHTMLFile() Methoden der Zend_Search_Lucene_Document_Html Klasse haben auch ein zweites optionales Argument. Wenn es auf TRUE gesetzt wird, wird der Inhalt vom Body auch innerhalb des Index gespeichert und kann vom Index empfangen werden. Standardmäßig wird der Body nur Tokenized und Indiziert, aber nicht gespeichert. Der dritte Parameter der loadHTML() und loadHTMLFile() Methoden spezifiziert optional die Kodierung des Quell- HTML Dokuments. Er wird verwendet wenn die Kodierung nicht durch die Angabe des Content-type MetaTags HTTP-EQUIV spezifiziert ist. Andere Dokument Header Meta Tags produzieren zusätzliche Dokument Felder. Der Feld 'name' wird vom 'name' Attribut genommen, und das 'content' Attribut veröffentlicht das Feld 'value'. Beide werden geteilt, indiziert und gespeichert damit damit Dokumente mit Hilfe Ihrer Meta Tags durchsucht werden können (zum Beispiel durch Schlüsselwörter). Analysierte Dokumente können durch den Programmierer mit jedem anderen Feld ausgegeben werden:
Dokument-Links sind im erstellten Dokument nicht enthalten, können aber mit den Zend_Search_Lucene_Document_Html::getLinks() und Zend_Search_Lucene_Document_Html::getHeaderLinks() Methoden empfangen werden:
Beginnend mit Zend Framework 1.6 ist es auch möglich Links mit dem Die Zend_Search_Lucene_Document_Html::getExcludeNoFollowLinks() Methode gibt den aktuellen Status des "Exclude nofollow links" Flags zurück. Word 2007 DokumenteZend_Search_Lucene bietet ein Word 2007 Parsing Feature. Dokumente können direkt aus einer Word 2007 Datei heraus erstellt werden:
Die Zend_Search_Lucene_Document_Docx Klasse verwendet die
Die Zend_Search_Lucene_Document_Docx Klasse erkennt die Metadaten und den Text des Dokuments. Metadaten bestehen, abhängig vom Inhalt des Dokuments, aus Dateinamen, Titel, Untertitel, Ersteller, Schlüsselwörter, Beschreibung, zuletzt geändert von, Version, Geändert und Erstellt. Das Feld 'filename' ist der aktuelle Word 2007 Dateiname. Das Feld 'title' ist der aktuelle Titel des Dokuments. Das Feld 'subject' ist der aktuelle Untertitel des Dokuments. Das Feld 'creator' ist der Ersteller des aktuellen Dokuments. Das Feld 'keywords' enthält die Schlüsselwörter des aktuellen Dokuments. Das Feld 'description' ist die Beschreibung des aktuellen Dokuments. Das Feld 'lastModifiedBy' ist der Benutzername der Person die das aktuelle Dokument als letztes geändert hat. Das Feld 'revision' ist die Versionsnummer des aktuellen Dokuments. Das Feld 'modified' ist das Datum / die Uhrzeit der letzten Änderung des aktuellen Dokuments. Das Feld 'created' ist das Datum / die Uhrzeit der Erstellung des aktuellen Dokuments. Das Feld 'body' ist der aktuelle Inhalt des Word 2007 Dokuments. Es enthält nur normalen Text, Kommentare und Versionen sind nicht enthalten. Die Methode loadDocxFile() der Zend_Search_Lucene_Document_Docx Klasse hat auch ein zweites optionales Argument. Wenn es auf TRUE gesetzt wird, wird der Inhalt auch mit einem Index gespeichert und kann vom Index empfangen werden. Standardmäßig wird der Inhalt gesplittet und indiziert, aber nicht gespeichert. Eingelesene Dokumente können vom Programierer mit jedem anderen Feld argumentiert werden:
Powerpoint 2007 DokumenteZend_Search_Lucene bietet ein Parsing Feature für Powerpoint 2007. Dokumente können direkt auf einer Powerpoint 2007 Datei heraus erstellt werden:
Die Zend_Search_Lucene_Document_Pptx Klasse verwendet die
Die Zend_Search_Lucene_Document_Docx Klasse erkennt die Metadaten und den Text des Dokuments. Metadaten bestehen, abhängig vom Inhalt des Dokuments, aus Dateinamen, Titel, Untertitel, Ersteller, Schlüsselwörter, Beschreibung, zuletzt geändert von, Version, Geändert und Erstellt. Das Feld 'filename' ist der aktuelle Powerpoint 2007 Dateiname. Das Feld 'title' ist der aktuelle Titel des Dokuments. Das Feld 'subject' ist der aktuelle Untertitel des Dokuments. Das Feld 'creator' ist der Ersteller des aktuellen Dokuments. Das Feld 'keywords' enthält die Schlüsselwörter des aktuellen Dokuments. Das Feld 'description' ist die Beschreibung des aktuellen Dokuments. Das Feld 'lastModifiedBy' ist der Benutzername der Person die das aktuelle Dokument als letztes geändert hat. Das Feld 'revision' ist die Versionsnummer des aktuellen Dokuments. Das Feld 'modified' ist das Datum / die Uhrzeit der letzten Änderung des aktuellen Dokuments. Das Feld 'created' ist das Datum / die Uhrzeit der Erstellung des aktuellen Dokuments. Das Feld 'body' ist der aktuelle Inhalt aller Slides und Slidenotizen im Powerpoint 2007 Dokument. Die Methode loadPptxFile() der Zend_Search_Lucene_Document_Pptx Klasse hat auch ein zweites optionales Argument. Wenn es auf TRUE gesetzt wird, wird der Inhalt auch mit einem Index gespeichert und kann vom Index empfangen werden. Standardmäßig wird der Inhalt gesplittet und indiziert, aber nicht gespeichert. Eingelesene Dokumente können vom Programierer mit jedem anderen Feld argumentiert werden:
Excel 2007 DokumenteZend_Search_Lucene bietet ein Parsing Feature für Excel 2007. Dokumente können direkt von einer Excel 2007 Datei erstellt werden:
Die Zend_Search_Lucene_Document_Xlsx Klasse verwendet die
Die Zend_Search_Lucene_Document_Xlsx Klasse erkennt die Metadaten und den Text des Dokuments. Metadaten bestehen, abhängig vom Inhalt des Dokuments, aus Dateinamen, Titel, Untertitel, Ersteller, Schlüsselwörter, Beschreibung, zuletzt geändert von, Version, Geändert und Erstellt. Das Feld 'filename' ist der aktuelle Excel 2007 Dateiname. Das Feld 'title' ist der aktuelle Titel des Dokuments. Das Feld 'subject' ist der aktuelle Untertitel des Dokuments. Das Feld 'creator' ist der Ersteller des aktuellen Dokuments. Das Feld 'keywords' enthält die Schlüsselwörter des aktuellen Dokuments. Das Feld 'description' ist die Beschreibung des aktuellen Dokuments. Das Feld 'lastModifiedBy' ist der Benutzername der Person die das aktuelle Dokument als letztes geändert hat. Das Feld 'revision' ist die Versionsnummer des aktuellen Dokuments. Das Feld 'modified' ist das Datum / die Uhrzeit der letzten Änderung des aktuellen Dokuments. Das Feld 'created' ist das Datum / die Uhrzeit der Erstellung des aktuellen Dokuments. Das Feld 'body' ist der aktuelle Inhalt aller Arbeitsblätter im Excel 2007 Dokument. Die Methode loadXlsxFile() der Zend_Search_Lucene_Document_Xlsx Klasse hat auch ein zweites optionales Argument. Wenn es auf TRUE gesetzt wird, wird der Inhalt auch mit einem Index gespeichert und kann vom Index empfangen werden. Standardmäßig wird der Inhalt gesplittet und indiziert, aber nicht gespeichert. Eingelesene Dokumente können vom Programierer mit jedem anderen Feld argumentiert werden:
|