Zend_Search_Lucene-Overview.xml 29 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!-- EN-Revision: 15225 -->
  3. <!-- Reviewed: no -->
  4. <sect1 id="zend.search.lucene.overview">
  5. <title>Überblick</title>
  6. <sect2 id="zend.search.lucene.introduction">
  7. <title>Einführung</title>
  8. <para>
  9. <classname>Zend_Search_Lucene</classname> ist eine komplett in PHP 5 geschriebene Textsuchmaschine für viele
  10. Zwecke. Da es seinen Index im Dateisystem ablegt und keinen Datenbankserver erfordert,
  11. kann es eine Suchfunktion für nahezu jede auf PHP basierende Website bereitstellen.
  12. <classname>Zend_Search_Lucene</classname> unterstützt die folgenden Funktionalitäten:
  13. <itemizedlist>
  14. <listitem>
  15. <para>Klassifizierte Suche - die besten Ergebnisse werden zuerst zurückgegeben</para>
  16. </listitem>
  17. <listitem>
  18. <para>
  19. Viele mächtige Abfragearten: Phrasensuche, Platzhaltersuche, Boolsche Suche,
  20. Näherungssuche, Bereichssuche und viele andere.
  21. </para>
  22. </listitem>
  23. <listitem>
  24. <para>
  25. Suche anhand eines bestimmten Feldes (z.B. Titel, Autor, Inhalt)
  26. </para>
  27. </listitem>
  28. </itemizedlist>
  29. <classname>Zend_Search_Lucene</classname> wurde abgeleitet vom Apache Lucene Projekt. Die aktuell unterstützten Versionen
  30. des Lucene Indexformats (beginnend mit ZF 1.6) sind 1.4 - 2.3. Für weitere Informationen über
  31. Lucene, besuchen Sie <ulink url="http://lucene.apache.org/java/docs/"/>.
  32. </para>
  33. <note>
  34. <title/>
  35. <para>
  36. Frühere <classname>Zend_Search_Lucene</classname> Implementationen unterstützen das Lucene Indexformat 1.4 (1.9) - 2.1.
  37. </para>
  38. <para>
  39. Beginnend mit Zend Framework 1.5 werden, nach dem <classname>Zend_Search_Lucene</classname> Update,
  40. alle Indezes die mit einem pre-2.1 Indexformat erstellt wurden automatisch in das Lucene 2.1
  41. Format upgegraded und ist daher mit vorherigen <classname>Zend_Search_Lucene</classname> Versionen
  42. nicht mehr kompatibel die in Zend Framework 1.0.x enthalten sind.
  43. </para>
  44. </note>
  45. </sect2>
  46. <sect2 id="zend.search.lucene.index-creation.documents-and-fields">
  47. <title>Dokumenten- und Feldobjekte</title>
  48. <para>
  49. Für die Indizierung verarbeitet <classname>Zend_Search_Lucene</classname> Dokumente als atomare Objekte.
  50. Ein Dokument wird in benannte Felder unterteilt und diese Felder enthalten Inhalte,
  51. die durchsucht werden können.
  52. </para>
  53. <para>
  54. Ein Dokument wird durch die <classname>Zend_Search_Lucene_Document</classname> Klasse abgebildet und die
  55. Objekte dieser Klasse enthalten Instanzen von <classname>Zend_Search_Lucene_Field</classname>, welche die Felder
  56. dieses Objektes repräsentieren.
  57. </para>
  58. <para>
  59. Es ist wichtig zu beachten, dass dem Index jegliche Informationen hinzugefügt werden
  60. können. Anwendungsspezifische Informationen oder Metadaten können in den
  61. Dokumentfeldern gespeichert und später bei der Suche aus dem Dokument zurückgeholt
  62. werden.
  63. </para>
  64. <para>
  65. Es liegt in der Verantwortung deiner Anwendung, den Indexer zu kontrollieren. Das
  66. bedeutet, dass die Daten aus jeder Quelle indiziert werden können, die von deiner
  67. Anwendung aus ansprechbar ist. Zum Beispiel könnten dies das Dateisystem, eine
  68. Datenbank, ein HTML Formular, usw. sein.
  69. </para>
  70. <para>
  71. Die <classname>Zend_Search_Lucene_Field</classname> Klasse stellt verschiedene statische
  72. Methoden zum Erstellen mit unterschiedlichen Charakteristika bereit:
  73. </para>
  74. <programlisting role="php"><![CDATA[
  75. $doc = new Zend_Search_Lucene_Document();
  76. // Feld wird nicht in Token aufgeteilt, aber indiziert und im Index
  77. // gespeichert. Die gespeichertern Felder können aus dem Index abgerufen werden
  78. $doc->addField(Zend_Search_Lucene_Field::Keyword('doctype',
  79. 'autogenerated'));
  80. // Feld wird weder in Token aufgeteilt noch indiziert, aber im Index gespeichert
  81. $doc->addField(Zend_Search_Lucene_Field::UnIndexed('created',
  82. time()));
  83. // Feld mit einer binären Zeichenkette, die weder in Token aufgeteilt
  84. // noch indiziert, aber im Index gespeichert wird
  85. $doc->addField(Zend_Search_Lucene_Field::Binary('icon',
  86. $iconData));
  87. // Feld wird in Token aufgeteilt und indiziert und im Index gespeichert
  88. $doc->addField(Zend_Search_Lucene_Field::Text('annotation',
  89. 'Document annotation text'));
  90. // Feld wird in Token aufgeteilt und indiziert, aber nicht im Index gespeichert
  91. $doc->addField(Zend_Search_Lucene_Field::UnStored('contents',
  92. 'My document content'));
  93. ]]></programlisting>
  94. <para>
  95. Jede dieser Methoden (ausser der <classname>Zend_Search_Lucene_Field::Binary()</classname> Methode) hat einen
  96. optionalen <code>$encoding</code> Parameter. Er definiert das Encoding für Eingabedaten.
  97. </para>
  98. <para>
  99. Die Codierung kann für unterschiedliche Dokumente verschieden sein genauso wie für unterschiedliche
  100. Felder innerhalb eines Dokuments:
  101. <programlisting role="php"><![CDATA[
  102. $doc = new Zend_Search_Lucene_Document();
  103. $doc->addField(Zend_Search_Lucene_Field::Text('title',
  104. $title,
  105. 'iso-8859-1'));
  106. $doc->addField(Zend_Search_Lucene_Field::UnStored('contents',
  107. $contents,
  108. 'utf-8'));
  109. ]]></programlisting>
  110. </para>
  111. <para>
  112. Wenn der encoding Parameter nicht angegeben wurde, wird das aktuelle Gebietsschema wärend der
  113. Verarbeitungzeit verwendet. Zum Beispiel:
  114. <programlisting role="php"><![CDATA[
  115. setlocale(LC_ALL, 'de_DE.iso-8859-1');
  116. ...
  117. $doc->addField(Zend_Search_Lucene_Field::UnStored('contents', $contents));
  118. ]]></programlisting>
  119. </para>
  120. <para>
  121. Felder werden immer gespeichert und vom Index in UTF-8 Codierung zurückgegeben. Jede
  122. notwendige Konvertierung zu UTF-8 geschieht automatisch.
  123. </para>
  124. <para>
  125. Text Analysatoren (<link linkend="zend.search.lucene.extending.analysis">siehe unten</link>)
  126. können auch Text in andere Codierungen konvertieren. Aktuell konvertiert der Standard Analysator
  127. Text in die 'ASCII//TRANSLIT' Codierung. Man sollte aber vorsichtig sein; diese Übersetzung
  128. hängt vom aktuellen Gebietsschema ab.
  129. </para>
  130. <para>
  131. Feld Namen werden durch die Auswahl in der <code>addField()</code> Methode definiert.
  132. </para>
  133. <para>
  134. Java Lucene verwendet das "contents" Feld für die Suche als Standardfeld.
  135. <classname>Zend_Search_Lucene</classname> durchsucht standardmäßig alle Felder, aber dieses Verhalten ist konfigurierbar.
  136. Für Details siehe das Kapitel
  137. <link linkend="zend.search.lucene.query-language.fields">"Standardsuchfeld"</link>.
  138. </para>
  139. </sect2>
  140. <sect2 id="zend.search.lucene.index-creation.understanding-field-types">
  141. <title>Verstehen der Feldtypen</title>
  142. <itemizedlist>
  143. <listitem>
  144. <para>
  145. <code>Keyword</code> (Stichwort) Felder werden gespeichert und indiziert, was
  146. bedeutet, dass sie sowohl durchsucht als auch in Suchergebnissen angezeigt
  147. werden können. Sie werden nicht in einzelne Worte (Tokens) zerteilt.
  148. Datenbankfelder für Aufzählungen lassen sich normalerweise leicht in Keyword
  149. Felder für <classname>Zend_Search_Lucene</classname> überführen.
  150. </para>
  151. </listitem>
  152. <listitem>
  153. <para>
  154. <code>UnIndexed</code> (unindizierte) Felder sind nicht durchsuchbar, werden
  155. aber bei Suchtreffern zurückgegeben. Datenbank Zeitstempel, Primärschlüssel,
  156. Pfade des Dateisystems und andere externe Identifikatoren sind gute Kandidaten
  157. für UnIndexed Felder.
  158. </para>
  159. </listitem>
  160. <listitem>
  161. <para>
  162. <code>Binary</code> (binäre) Felder werden nicht in Token aufgeteilt und
  163. indiziert, aber für die Rückgabe bei Suchtreffern gespeichert. Sie können für
  164. die Speicherung aller Daten, die als binäre Zeichenkette kodiert sind,
  165. verwendet werden, wie z.B. eine Grafiksymbol.
  166. </para>
  167. </listitem>
  168. <listitem>
  169. <para>
  170. <code>Text</code> Felder werden gespeichert, indiziert und in Token aufgeteilt.
  171. Text Felder sind geeignet für die Speicherung von Informationen wie Themen und
  172. Überschriften, die sowohl durchsuchbar sein müssen, als auch in Suchergebnissen
  173. zurückgegeben werden müssen.
  174. </para>
  175. </listitem>
  176. <listitem>
  177. <para>
  178. <code>UnStored</code> (nicht gespeicherte) Felder werden in Token aufgeteilt und
  179. indiziert, aber nicht im Index gespeichert. Umfangreiche Texte werden am besten
  180. durch diesen Feldtyp indiziert. Gespeicherte Daten benötigen einen größeren
  181. Index auf der Festplatte, wenn du also Daten nur durchsuchbar aber nicht wieder
  182. ausgegeben haben musst, verwende ein UnStored Feld. UnStored Felder sind
  183. geeignet, wenn ein <classname>Zend_Search_Lucene</classname> Index in Kombination mit einer relationalen
  184. Datenbank verwendet wird. Du kannst große Datenfelder mit UnStored Feldern
  185. für die Suche indizieren und sie aus der relationalen Datenbank durch die
  186. Verwendung eines separaten Feldes mithilfe eines Identifikators zurückholen.
  187. </para>
  188. <table id="zend.search.lucene.index-creation.understanding-field-types.table">
  189. <title>Zend_Search_Lucene_Field Typen</title>
  190. <tgroup cols="5">
  191. <thead>
  192. <row>
  193. <entry>Feldtyp</entry>
  194. <entry>Gespeichert</entry>
  195. <entry>Indiziert</entry>
  196. <entry>In Token aufgeteilt</entry>
  197. <entry>Binär</entry>
  198. </row>
  199. </thead>
  200. <tbody>
  201. <row>
  202. <entry>Keyword</entry>
  203. <entry>Ja</entry>
  204. <entry>Ja</entry>
  205. <entry>Nein</entry>
  206. <entry>Nein</entry>
  207. </row>
  208. <row>
  209. <entry>UnIndexed</entry>
  210. <entry>Ja</entry>
  211. <entry>Nein</entry>
  212. <entry>Nein</entry>
  213. <entry>Nein</entry>
  214. </row>
  215. <row>
  216. <entry>Binary</entry>
  217. <entry>Ja</entry>
  218. <entry>Nein</entry>
  219. <entry>Nein</entry>
  220. <entry>Ja</entry>
  221. </row>
  222. <row>
  223. <entry>Text</entry>
  224. <entry>Ja</entry>
  225. <entry>Ja</entry>
  226. <entry>Ja</entry>
  227. <entry>Nein</entry>
  228. </row>
  229. <row>
  230. <entry>UnStored</entry>
  231. <entry>Nein</entry>
  232. <entry>Ja</entry>
  233. <entry>Ja</entry>
  234. <entry>Nein</entry>
  235. </row>
  236. </tbody>
  237. </tgroup>
  238. </table>
  239. </listitem>
  240. </itemizedlist>
  241. </sect2>
  242. <sect2 id="zend.search.lucene.index-creation.html-documents">
  243. <title>HTML Dokumente</title>
  244. <para>
  245. <classname>Zend_Search_Lucene</classname> bietet ein HTML Parsing Feature. Dokumente können direkt von einer HTML Datei oder
  246. String erzeugt werden:
  247. <programlisting role="php"><![CDATA[
  248. $doc = Zend_Search_Lucene_Document_Html::loadHTMLFile($filename);
  249. $index->addDocument($doc);
  250. ...
  251. $doc = Zend_Search_Lucene_Document_Html::loadHTML($htmlString);
  252. $index->addDocument($doc);
  253. ]]></programlisting>
  254. </para>
  255. <para>
  256. Die <classname>Zend_Search_Lucene_Document_Html</classname> Klasse verwendet die
  257. <code>DOMDocument::loadHTML()</code> und die <code>DOMDocument::loadHTMLFile()</code> Methode um die
  258. HTML Quelle zu analysieren, deswegen benötigt Sie kein gut geformtes HTML noch ein XHTML. Auf der
  259. anderen Seite ist es abhängig von der angegebenen Codierung im "meta http-equiv" Tag Header.
  260. </para>
  261. <para>
  262. Die <classname>Zend_Search_Lucene_Document_Html</classname> Klasse erkennt Dokument Titel, Body Dokument Header
  263. Meta Tags.
  264. </para>
  265. <para>
  266. Das 'title' Feld ist aktuell der /html/head/title Wert. Er wird inneralb des Index gespeichert,
  267. Tokenized und für die Suche zur Verfügung gestellt.
  268. </para>
  269. <para>
  270. Das 'body' Feld ist aktuell der Inhalt vom Body der HTML Datei oder des Strings. Er enthält keine
  271. Skripte, Kommentare oder Attribute.
  272. </para>
  273. <para>
  274. Die <code>loadHTML()</code> und <code>loadHTMLFile()</code> Methoden der
  275. <classname>Zend_Search_Lucene_Document_Html</classname> Klasse haben auch ein zweites optionales Argument.
  276. Wenn es auf true gesetzt wird, wird der Inhalt vom Body auch innerhalb des Index gespeichert und kann
  277. vom Index empfangen werden. Standardmäßig wird der Body nur Tokenized und Indiziert, aber nicht
  278. gespeichert.
  279. </para>
  280. <para>
  281. Der dritte Parameter der <code>loadHTML()</code> und <code>loadHTMLFile()</code>
  282. Methoden spezifiziert optional die Kodierung des Quell- HTML Dokuments. Er wird
  283. verwendet wenn die Kodierung nicht durch die Angabe des Content-type MetaTags
  284. HTTP-EQUIV spezifiziert ist.
  285. </para>
  286. <para>
  287. Andere Dokument Header Meta Tags produzieren zusätzliche Dokument Felder. Der Feld 'name' wird vom
  288. 'name' Attribut genommen, und das 'content' Attribut veröffentlicht das Feld 'value'. Beide werden
  289. geteilt, indiziert und gespeichert damit damit Dokumente mit Hilfe Ihrer Meta Tags durchsucht werden
  290. können (zum Beispiel durch Schlüsselwörter).
  291. </para>
  292. <para>
  293. Analysierte Dokumente können durch den Programmierer mit jedem anderen Feld ausgegeben werden:
  294. <programlisting role="php"><![CDATA[
  295. $doc = Zend_Search_Lucene_Document_Html::loadHTML($htmlString);
  296. $doc->addField(Zend_Search_Lucene_Field::UnIndexed('created',
  297. time()));
  298. $doc->addField(Zend_Search_Lucene_Field::UnIndexed('updated',
  299. time()));
  300. $doc->addField(Zend_Search_Lucene_Field::Text('annotation',
  301. 'Document annotation text'));
  302. $index->addDocument($doc);
  303. ]]></programlisting>
  304. </para>
  305. <para>
  306. Dokument-Links sind im erstellten Dokument nicht enthalten, können aber mit den
  307. <classname>Zend_Search_Lucene_Document_Html::getLinks()</classname> und
  308. <classname>Zend_Search_Lucene_Document_Html::getHeaderLinks()</classname> Methoden empfangen werden:
  309. <programlisting role="php"><![CDATA[
  310. $doc = Zend_Search_Lucene_Document_Html::loadHTML($htmlString);
  311. $linksArray = $doc->getLinks();
  312. $headerLinksArray = $doc->getHeaderLinks();
  313. ]]></programlisting>
  314. </para>
  315. <para>
  316. Beginnend mit ZF 1.6 ist es auch möglich Links mit dem <code>rel</code> Attribut auszunehmen wenn
  317. es auf <code>'nofollow'</code> gesetzt wird. Man kann
  318. <classname>Zend_Search_Lucene_Document_Html::setExcludeNoFollowLinks($true)</classname> verwenden um diese
  319. Option einzuschalten.
  320. </para>
  321. <para>
  322. Die <classname>Zend_Search_Lucene_Document_Html::getExcludeNoFollowLinks()</classname> Methode gibt den
  323. aktuellen Status des "Exclude nofollow links" Flags zurück.
  324. </para>
  325. </sect2>
  326. <sect2 id="zend.search.lucene.index-creation.docx-documents">
  327. <title>Word 2007 Dokumente</title>
  328. <para>
  329. <classname>Zend_Search_Lucene</classname> bietet ein Word 2007 Parsing Feature. Dokumente können direkt aus einer
  330. Word 2007 Datei heraus erstellt werden:
  331. <programlisting role="php"><![CDATA[
  332. $doc = Zend_Search_Lucene_Document_Docx::loadDocxFile($filename);
  333. $index->addDocument($doc);
  334. ]]></programlisting>
  335. </para>
  336. <para>
  337. Die <classname>Zend_Search_Lucene_Document_Docx</classname> Klasse verwendet die
  338. <code>ZipArchive</code> Klasse und <code>simplexml</code> Methoden um das Quelldokument
  339. zu parsen. Wenn die <code>ZipArchive</code> Klasse (vom Modul php_zip) nicht vorhanden
  340. ist, wird <classname>Zend_Search_Lucene_Document_Docx</classname> auch nicht für die
  341. Verwendung mit dem Zend Framework zur Verfügung stehen.
  342. </para>
  343. <para>
  344. Die <classname>Zend_Search_Lucene_Document_Docx</classname> Klasse erkennt die Metadaten und den
  345. Text des Dokuments. Metadaten bestehen, abhängig vom Inhalt des Dokuments, aus
  346. Dateinamen, Titel, Untertitel, Ersteller, Schlüsselwörter, Beschreibung, zuletzt
  347. geändert von, Version, Geändert und Erstellt.
  348. </para>
  349. <para>
  350. Das Feld 'filename' ist der aktuelle Word 2007 Dateiname.
  351. </para>
  352. <para>
  353. Das Feld 'title' ist der aktuelle Titel des Dokuments.
  354. </para>
  355. <para>
  356. Das Feld 'subject' ist der aktuelle Untertitel des Dokuments.
  357. </para>
  358. <para>
  359. Das Feld 'creator' ist der Ersteller des aktuellen Dokuments.
  360. </para>
  361. <para>
  362. Das Feld 'keywords' enthält die Schlüsselwörter des aktuellen Dokuments.
  363. </para>
  364. <para>
  365. Das Feld 'description' ist die Beschreibung des aktuellen Dokuments.
  366. </para>
  367. <para>
  368. Das Feld 'lastModifiedBy' ist der Benutzername der Person die das aktuelle Dokument
  369. als letztes geändert hat.
  370. </para>
  371. <para>
  372. Das Feld 'revision' ist die Versionsnummer des aktuellen Dokuments.
  373. </para>
  374. <para>
  375. Das Feld 'modified' ist das Datum / die Uhrzeit der letzten Änderung des
  376. aktuellen Dokuments.
  377. </para>
  378. <para>
  379. Das Feld 'created' ist das Datum / die Uhrzeit der Erstellung des aktuellen
  380. Dokuments.
  381. </para>
  382. <para>
  383. Das Feld 'body' ist der aktuelle Inhalt des Word 2007 Dokuments. Es enthält nur
  384. normalen Text, Kommentare und Versionen sind nicht enthalten.
  385. </para>
  386. <para>
  387. Die Methode <code>loadDocxFile()</code> der <classname>Zend_Search_Lucene_Document_Docx</classname>
  388. Klasse hat auch ein zweites optionales Argument. Wenn es auf true gesetzt wird, wird der
  389. Inhalt auch mit einem Index gespeichert und kann vom Index empfangen werden. Standardmäßig
  390. wird der Inhalt gesplittet und indiziert, aber nicht gespeichert.
  391. </para>
  392. <para>
  393. Eingelesene Dokumente können vom Programierer mit jedem anderen Feld argumentiert werden:
  394. <programlisting role="php"><![CDATA[
  395. $doc = Zend_Search_Lucene_Document_Docx::loadDocxFile($filename);
  396. $doc->addField(Zend_Search_Lucene_Field::UnIndexed(
  397. 'indexTime',
  398. time())
  399. );
  400. $doc->addField(Zend_Search_Lucene_Field::Text(
  401. 'annotation',
  402. 'Anmerkungstext des Dokuments')
  403. );
  404. $index->addDocument($doc);
  405. ]]></programlisting>
  406. </para>
  407. </sect2>
  408. <sect2 id="zend.search.lucene.index-creation.pptx-documents">
  409. <title>Powerpoint 2007 Dokumente</title>
  410. <para>
  411. <classname>Zend_Search_Lucene</classname> bietet ein Parsing Feature für Powerpoint 2007. Dokumente können direkt
  412. auf einer Powerpoint 2007 Datei heraus erstellt werden:
  413. <programlisting role="php"><![CDATA[
  414. $doc = Zend_Search_Lucene_Document_Pptx::loadPptxFile($filename);
  415. $index->addDocument($doc);
  416. ]]></programlisting>
  417. </para>
  418. <para>
  419. Die <classname>Zend_Search_Lucene_Document_Pptx</classname> Klasse verwendet die
  420. <code>ZipArchive</code> Klasse und <code>simplexml</code> Methoden um das Quelldokument
  421. zu parsen. Wenn die <code>ZipArchive</code> Klasse (vom Modul php_zip) nicht vorhanden
  422. ist, wird <classname>Zend_Search_Lucene_Document_Docx</classname> auch nicht für die
  423. Verwendung mit dem Zend Framework zur Verfügung stehen.
  424. </para>
  425. <para>
  426. Die <classname>Zend_Search_Lucene_Document_Docx</classname> Klasse erkennt die Metadaten und den
  427. Text des Dokuments. Metadaten bestehen, abhängig vom Inhalt des Dokuments, aus
  428. Dateinamen, Titel, Untertitel, Ersteller, Schlüsselwörter, Beschreibung, zuletzt
  429. geändert von, Version, Geändert und Erstellt.
  430. </para>
  431. <para>
  432. Das Feld 'filename' ist der aktuelle Powerpoint 2007 Dateiname.
  433. </para>
  434. <para>
  435. Das Feld 'title' ist der aktuelle Titel des Dokuments.
  436. </para>
  437. <para>
  438. Das Feld 'subject' ist der aktuelle Untertitel des Dokuments.
  439. </para>
  440. <para>
  441. Das Feld 'creator' ist der Ersteller des aktuellen Dokuments.
  442. </para>
  443. <para>
  444. Das Feld 'keywords' enthält die Schlüsselwörter des aktuellen Dokuments.
  445. </para>
  446. <para>
  447. Das Feld 'description' ist die Beschreibung des aktuellen Dokuments.
  448. </para>
  449. <para>
  450. Das Feld 'lastModifiedBy' ist der Benutzername der Person die das aktuelle Dokument
  451. als letztes geändert hat.
  452. </para>
  453. <para>
  454. Das Feld 'revision' ist die Versionsnummer des aktuellen Dokuments.
  455. </para>
  456. <para>
  457. Das Feld 'modified' ist das Datum / die Uhrzeit der letzten Änderung des
  458. aktuellen Dokuments.
  459. </para>
  460. <para>
  461. Das Feld 'created' ist das Datum / die Uhrzeit der Erstellung des aktuellen
  462. Dokuments.
  463. </para>
  464. <para>
  465. Das Feld 'body' ist der aktuelle Inhalt aller Slides und Slidenotizen im
  466. Powerpoint 2007 Dokument.
  467. </para>
  468. <para>
  469. Die Methode <code>loadPptxFile()</code> der <classname>Zend_Search_Lucene_Document_Pptx</classname>
  470. Klasse hat auch ein zweites optionales Argument. Wenn es auf true gesetzt wird, wird der
  471. Inhalt auch mit einem Index gespeichert und kann vom Index empfangen werden. Standardmäßig
  472. wird der Inhalt gesplittet und indiziert, aber nicht gespeichert.
  473. </para>
  474. <para>
  475. Eingelesene Dokumente können vom Programierer mit jedem anderen Feld argumentiert werden:
  476. <programlisting role="php"><![CDATA[
  477. $doc = Zend_Search_Lucene_Document_Pptx::loadPptxFile($filename);
  478. $doc->addField(Zend_Search_Lucene_Field::UnIndexed(
  479. 'indexTime',
  480. time()));
  481. $doc->addField(Zend_Search_Lucene_Field::Text(
  482. 'annotation',
  483. 'Anmerkungstext des Dokuments'));
  484. $index->addDocument($doc);
  485. ]]></programlisting>
  486. </para>
  487. </sect2>
  488. <sect2 id="zend.search.lucene.index-creation.xlsx-documents">
  489. <title>Excel 2007 Dokumente</title>
  490. <para>
  491. <classname>Zend_Search_Lucene</classname> bietet ein Parsing Feature für Excel 2007. Dokumente können direkt
  492. von einer Excel 2007 Datei erstellt werden:
  493. <programlisting role="php"><![CDATA[
  494. $doc = Zend_Search_Lucene_Document_Xlsx::loadXlsxFile($filename);
  495. $index->addDocument($doc);
  496. ]]></programlisting>
  497. </para>
  498. <para>
  499. Die <classname>Zend_Search_Lucene_Document_Xlsx</classname> Klasse verwendet die
  500. <code>ZipArchive</code> Klasse und <code>simplexml</code> Methoden um das Quelldokument
  501. zu parsen. Wenn die <code>ZipArchive</code> Klasse (vom Modul php_zip) nicht vorhanden
  502. ist, wird <classname>Zend_Search_Lucene_Document_Xlsx</classname> auch nicht für die
  503. Verwendung mit dem Zend Framework zur Verfügung stehen.
  504. </para>
  505. <para>
  506. Die <classname>Zend_Search_Lucene_Document_Xlsx</classname> Klasse erkennt die Metadaten und den
  507. Text des Dokuments. Metadaten bestehen, abhängig vom Inhalt des Dokuments, aus
  508. Dateinamen, Titel, Untertitel, Ersteller, Schlüsselwörter, Beschreibung, zuletzt
  509. geändert von, Version, Geändert und Erstellt.
  510. </para>
  511. <para>
  512. Das Feld 'filename' ist der aktuelle Excel 2007 Dateiname.
  513. </para>
  514. <para>
  515. Das Feld 'title' ist der aktuelle Titel des Dokuments.
  516. </para>
  517. <para>
  518. Das Feld 'subject' ist der aktuelle Untertitel des Dokuments.
  519. </para>
  520. <para>
  521. Das Feld 'creator' ist der Ersteller des aktuellen Dokuments.
  522. </para>
  523. <para>
  524. Das Feld 'keywords' enthält die Schlüsselwörter des aktuellen Dokuments.
  525. </para>
  526. <para>
  527. Das Feld 'description' ist die Beschreibung des aktuellen Dokuments.
  528. </para>
  529. <para>
  530. Das Feld 'lastModifiedBy' ist der Benutzername der Person die das aktuelle Dokument
  531. als letztes geändert hat.
  532. </para>
  533. <para>
  534. Das Feld 'revision' ist die Versionsnummer des aktuellen Dokuments.
  535. </para>
  536. <para>
  537. Das Feld 'modified' ist das Datum / die Uhrzeit der letzten Änderung des
  538. aktuellen Dokuments.
  539. </para>
  540. <para>
  541. Das Feld 'created' ist das Datum / die Uhrzeit der Erstellung des aktuellen
  542. Dokuments.
  543. </para>
  544. <para>
  545. Das Feld 'body' ist der aktuelle Inhalt aller Arbeitsblätter im
  546. Excel 2007 Dokument.
  547. </para>
  548. <para>
  549. Die Methode <code>loadXlsxFile()</code> der <classname>Zend_Search_Lucene_Document_Xlsx</classname>
  550. Klasse hat auch ein zweites optionales Argument. Wenn es auf true gesetzt wird, wird der
  551. Inhalt auch mit einem Index gespeichert und kann vom Index empfangen werden. Standardmäßig
  552. wird der Inhalt gesplittet und indiziert, aber nicht gespeichert.
  553. </para>
  554. <para>
  555. Eingelesene Dokumente können vom Programierer mit jedem anderen Feld argumentiert werden:
  556. <programlisting role="php"><![CDATA[
  557. $doc = Zend_Search_Lucene_Document_Xlsx::loadXlsxFile($filename);
  558. $doc->addField(Zend_Search_Lucene_Field::UnIndexed(
  559. 'indexTime',
  560. time()));
  561. $doc->addField(Zend_Search_Lucene_Field::Text(
  562. 'annotation',
  563. 'Anmerkungstext des Dokuments'));
  564. $index->addDocument($doc);
  565. ]]></programlisting>
  566. </para>
  567. </sect2>
  568. </sect1>