1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect1 id="learning.lucene.searching">
<title>Recherche</title>
<para>
La recherche s'effectue en utilisant la méthode <methodname>find()</methodname> :
</para>
<example id="learning.lucene.searching.search-example">
<title>Recherche à travers l'index</title>
<programlisting language="php"><![CDATA[
$hits = $index->find($query);
foreach ($hits as $hit) {
printf("%d %f %s\n", $hit->id, $hit->score, $hit->title);
}
]]></programlisting>
</example>
<para>
Cet exemple montre l'utilisation de deux propriétés particulières des résultats de
recherche - <property>id</property> et <property>score</property>.
</para>
<para>
<property>id</property> est un identifiant interne de document utilisé dans un index Lucene.
Il peut être utilisé pour un certains nombre d'opérations, tels que la suppression d'un
document de l'index :
</para>
<example id="learning.lucene.searching.delete-example">
<title>Suppression d'un document indexé</title>
<programlisting language="php"><![CDATA[
$index->delete($id);
]]></programlisting>
</example>
<para>
Ou récupération d'un document à partir de l'index :
</para>
<example id="learning.lucene.searching.retrieve-example">
<title>Récupération d'un document indexé</title>
<programlisting language="php"><![CDATA[
$doc = $index->getDocument($id);
]]></programlisting>
</example>
<note id="learning.lucene.searching.identifiers">
<title>Identifiant interne de document</title>
<para>
Note importante ! Les identifiants de documents internes peuvent changer suite à
une optimisation de l'index ou au processus d'auto-optimisation, mais il ne sera jamais
changé pendant l'exécution d'un script à moins que ne soient appellées les méthodes
<methodname>addDocument()</methodname> (ce qui peut impliquer une procédure
d'auto-optimisation) ou <methodname>optimize()</methodname>.
</para>
</note>
<para>
Le champ <property>score</property> est un score de résultat. Les résultats de recherche
sont triés par score (meilleurs résultats en premier).
</para>
<para>
Il est aussi possible de trier l'ensemble de résultats en fonction d'une valeur de champ
spécifique. Voir la <link
linkend="zend.search.lucene.searching.sorting"> documentation
<classname>Zend_Search_Lucene</classname></link> pour plus de détails sur cette
possibilité.
</para>
<para>
Cette exemple montre aussi la possibilité d'accéder à des champs stockés (ex :
<command>$hit->title</command>). Les champs de documents stockés sont chargés lors du
premier accès à l'une des propriété du résultat autre que
<property>id</property> ou <property>score</property>, et la valeur du champ correspondant
est retournée.
</para>
<para>
Ceci cause une ambiguïté car les documents ont leurs propres champs <property>id</property>
ou <property>score</property> par conséquence, il n'est pas recommendé d'utiliser ces noms
de champs dans les documents stockés. Cependant, ils peuvent être accédé via la
méthode : <methodname>getDocument()</methodname>
</para>
<example id="learning.lucene.searching.id-score-fields">
<title>Accéder aux champs "id" et "score" original du documents</title>
<programlisting language="php"><![CDATA[
$id = $hit->getDocument()->id;
$score = $hit->getDocument()->score;
]]></programlisting>
</example>
</sect1>
|
