These results are based on our legacy PHP analysis, consider migrating to our new PHP analysis engine instead. Learn more
1 | <?php |
||
2 | |||
3 | namespace dokuwiki\Search; |
||
4 | |||
5 | use dokuwiki\Extension\Event; |
||
6 | |||
7 | /** |
||
8 | * Class that encapsulates operations on the indexer database. |
||
9 | * |
||
10 | * @author Tom N Harris <[email protected]> |
||
11 | */ |
||
12 | class Indexer { |
||
13 | /** |
||
14 | * @var array $pidCache Cache for getPID() |
||
15 | */ |
||
16 | protected $pidCache = array(); |
||
17 | |||
18 | /** |
||
19 | * Adds the contents of a page to the fulltext index |
||
20 | * |
||
21 | * The added text replaces previous words for the same page. |
||
22 | * An empty value erases the page. |
||
23 | * |
||
24 | * @param string $page a page name |
||
25 | * @param string $text the body of the page |
||
26 | * @return string|boolean the function completed successfully |
||
27 | * |
||
28 | * @author Tom N Harris <[email protected]> |
||
29 | * @author Andreas Gohr <[email protected]> |
||
30 | */ |
||
31 | public function addPageWords($page, $text) { |
||
32 | if (!$this->lock()) |
||
33 | return "locked"; |
||
34 | |||
35 | // load known documents |
||
36 | $pid = $this->getPIDNoLock($page); |
||
37 | if ($pid === false) { |
||
38 | $this->unlock(); |
||
39 | return false; |
||
40 | } |
||
41 | |||
42 | $pagewords = array(); |
||
43 | // get word usage in page |
||
44 | $words = $this->getPageWords($text); |
||
45 | if ($words === false) { |
||
46 | $this->unlock(); |
||
47 | return false; |
||
48 | } |
||
49 | |||
50 | if (!empty($words)) { |
||
51 | foreach (array_keys($words) as $wlen) { |
||
52 | $index = $this->getIndex('i', $wlen); |
||
53 | foreach ($words[$wlen] as $wid => $freq) { |
||
54 | $idx = ($wid<count($index)) ? $index[$wid] : ''; |
||
55 | $index[$wid] = $this->updateTuple($idx, $pid, $freq); |
||
0 ignored issues
–
show
|
|||
56 | $pagewords[] = "$wlen*$wid"; |
||
57 | } |
||
58 | if (!$this->saveIndex('i', $wlen, $index)) { |
||
59 | $this->unlock(); |
||
60 | return false; |
||
61 | } |
||
62 | } |
||
63 | } |
||
64 | |||
65 | // Remove obsolete index entries |
||
66 | $pageword_idx = $this->getIndexKey('pageword', '', $pid); |
||
0 ignored issues
–
show
It seems like
$pid defined by $this->getPIDNoLock($page) on line 36 can also be of type boolean ; however, dokuwiki\Search\Indexer::getIndexKey() does only seem to accept integer , maybe add an additional type check?
If a method or function can return multiple different values and unless you are sure that you only can receive a single value in this context, we recommend to add an additional type check: /**
* @return array|string
*/
function returnsDifferentValues($x) {
if ($x) {
return 'foo';
}
return array();
}
$x = returnsDifferentValues($y);
if (is_array($x)) {
// $x is an array.
}
If this a common case that PHP Analyzer should handle natively, please let us know by opening an issue. ![]() |
|||
67 | if ($pageword_idx !== '') { |
||
68 | $oldwords = explode(':',$pageword_idx); |
||
69 | $delwords = array_diff($oldwords, $pagewords); |
||
70 | $upwords = array(); |
||
71 | foreach ($delwords as $word) { |
||
72 | if ($word != '') { |
||
73 | list($wlen, $wid) = explode('*', $word); |
||
74 | $wid = (int)$wid; |
||
75 | $upwords[$wlen][] = $wid; |
||
76 | } |
||
77 | } |
||
78 | foreach ($upwords as $wlen => $widx) { |
||
79 | $index = $this->getIndex('i', $wlen); |
||
80 | foreach ($widx as $wid) { |
||
81 | $index[$wid] = $this->updateTuple($index[$wid], $pid, 0); |
||
0 ignored issues
–
show
It seems like
$pid defined by $this->getPIDNoLock($page) on line 36 can also be of type boolean ; however, dokuwiki\Search\Indexer::updateTuple() does only seem to accept string|integer , maybe add an additional type check?
If a method or function can return multiple different values and unless you are sure that you only can receive a single value in this context, we recommend to add an additional type check: /**
* @return array|string
*/
function returnsDifferentValues($x) {
if ($x) {
return 'foo';
}
return array();
}
$x = returnsDifferentValues($y);
if (is_array($x)) {
// $x is an array.
}
If this a common case that PHP Analyzer should handle natively, please let us know by opening an issue. ![]() |
|||
82 | } |
||
83 | $this->saveIndex('i', $wlen, $index); |
||
84 | } |
||
85 | } |
||
86 | // Save the reverse index |
||
87 | $pageword_idx = join(':', $pagewords); |
||
88 | if (!$this->saveIndexKey('pageword', '', $pid, $pageword_idx)) { |
||
0 ignored issues
–
show
It seems like
$pid defined by $this->getPIDNoLock($page) on line 36 can also be of type boolean ; however, dokuwiki\Search\Indexer::saveIndexKey() does only seem to accept integer , maybe add an additional type check?
If a method or function can return multiple different values and unless you are sure that you only can receive a single value in this context, we recommend to add an additional type check: /**
* @return array|string
*/
function returnsDifferentValues($x) {
if ($x) {
return 'foo';
}
return array();
}
$x = returnsDifferentValues($y);
if (is_array($x)) {
// $x is an array.
}
If this a common case that PHP Analyzer should handle natively, please let us know by opening an issue. ![]() |
|||
89 | $this->unlock(); |
||
90 | return false; |
||
91 | } |
||
92 | |||
93 | $this->unlock(); |
||
94 | return true; |
||
95 | } |
||
96 | |||
97 | /** |
||
98 | * Split the words in a page and add them to the index. |
||
99 | * |
||
100 | * @param string $text content of the page |
||
101 | * @return array list of word IDs and number of times used |
||
102 | * |
||
103 | * @author Andreas Gohr <[email protected]> |
||
104 | * @author Christopher Smith <[email protected]> |
||
105 | * @author Tom N Harris <[email protected]> |
||
106 | */ |
||
107 | protected function getPageWords($text) { |
||
108 | |||
109 | $tokens = $this->tokenizer($text); |
||
110 | $tokens = array_count_values($tokens); // count the frequency of each token |
||
111 | |||
112 | $words = array(); |
||
113 | foreach ($tokens as $w=>$c) { |
||
114 | $l = wordlen($w); |
||
115 | if (isset($words[$l])){ |
||
116 | $words[$l][$w] = $c + (isset($words[$l][$w]) ? $words[$l][$w] : 0); |
||
117 | }else{ |
||
118 | $words[$l] = array($w => $c); |
||
119 | } |
||
120 | } |
||
121 | |||
122 | // arrive here with $words = array(wordlen => array(word => frequency)) |
||
123 | $word_idx_modified = false; |
||
124 | $index = array(); //resulting index |
||
125 | foreach (array_keys($words) as $wlen) { |
||
126 | $word_idx = $this->getIndex('w', $wlen); |
||
127 | foreach ($words[$wlen] as $word => $freq) { |
||
128 | $word = (string)$word; |
||
129 | $wid = array_search($word, $word_idx, true); |
||
130 | if ($wid === false) { |
||
131 | $wid = count($word_idx); |
||
132 | $word_idx[] = $word; |
||
133 | $word_idx_modified = true; |
||
134 | } |
||
135 | if (!isset($index[$wlen])) |
||
136 | $index[$wlen] = array(); |
||
137 | $index[$wlen][$wid] = $freq; |
||
138 | } |
||
139 | // save back the word index |
||
140 | if ($word_idx_modified && !$this->saveIndex('w', $wlen, $word_idx)) |
||
141 | return false; |
||
142 | } |
||
143 | |||
144 | return $index; |
||
145 | } |
||
146 | |||
147 | /** |
||
148 | * Add/update keys to/of the metadata index. |
||
149 | * |
||
150 | * Adding new keys does not remove other keys for the page. |
||
151 | * An empty value will erase the key. |
||
152 | * The $key parameter can be an array to add multiple keys. $value will |
||
153 | * not be used if $key is an array. |
||
154 | * |
||
155 | * @param string $page a page name |
||
156 | * @param mixed $key a key string or array of key=>value pairs |
||
157 | * @param mixed $value the value or list of values |
||
158 | * @return boolean|string the function completed successfully |
||
159 | * |
||
160 | * @author Tom N Harris <[email protected]> |
||
161 | * @author Michael Hamann <[email protected]> |
||
162 | */ |
||
163 | public function addMetaKeys($page, $key, $value=null) { |
||
164 | if (!is_array($key)) { |
||
165 | $key = array($key => $value); |
||
166 | } elseif (!is_null($value)) { |
||
167 | // $key is array, but $value is not null |
||
168 | trigger_error("array passed to addMetaKeys but value is not null", E_USER_WARNING); |
||
169 | } |
||
170 | |||
171 | if (!$this->lock()) |
||
172 | return "locked"; |
||
173 | |||
174 | // load known documents |
||
175 | $pid = $this->getPIDNoLock($page); |
||
176 | if ($pid === false) { |
||
177 | $this->unlock(); |
||
178 | return false; |
||
179 | } |
||
180 | |||
181 | // Special handling for titles so the index file is simpler |
||
182 | if (array_key_exists('title', $key)) { |
||
183 | $value = $key['title']; |
||
184 | if (is_array($value)) { |
||
185 | $value = $value[0]; |
||
186 | } |
||
187 | $this->saveIndexKey('title', '', $pid, $value); |
||
0 ignored issues
–
show
It seems like
$pid defined by $this->getPIDNoLock($page) on line 175 can also be of type boolean ; however, dokuwiki\Search\Indexer::saveIndexKey() does only seem to accept integer , maybe add an additional type check?
If a method or function can return multiple different values and unless you are sure that you only can receive a single value in this context, we recommend to add an additional type check: /**
* @return array|string
*/
function returnsDifferentValues($x) {
if ($x) {
return 'foo';
}
return array();
}
$x = returnsDifferentValues($y);
if (is_array($x)) {
// $x is an array.
}
If this a common case that PHP Analyzer should handle natively, please let us know by opening an issue. ![]() |
|||
188 | unset($key['title']); |
||
189 | } |
||
190 | |||
191 | foreach ($key as $name => $values) { |
||
192 | $metaname = idx_cleanName($name); |
||
193 | $this->addIndexKey('metadata', '', $metaname); |
||
194 | $metaidx = $this->getIndex($metaname.'_i', ''); |
||
195 | $metawords = $this->getIndex($metaname.'_w', ''); |
||
196 | $addwords = false; |
||
197 | |||
198 | if (!is_array($values)) $values = array($values); |
||
199 | |||
200 | $val_idx = $this->getIndexKey($metaname.'_p', '', $pid); |
||
0 ignored issues
–
show
It seems like
$pid defined by $this->getPIDNoLock($page) on line 175 can also be of type boolean ; however, dokuwiki\Search\Indexer::getIndexKey() does only seem to accept integer , maybe add an additional type check?
If a method or function can return multiple different values and unless you are sure that you only can receive a single value in this context, we recommend to add an additional type check: /**
* @return array|string
*/
function returnsDifferentValues($x) {
if ($x) {
return 'foo';
}
return array();
}
$x = returnsDifferentValues($y);
if (is_array($x)) {
// $x is an array.
}
If this a common case that PHP Analyzer should handle natively, please let us know by opening an issue. ![]() |
|||
201 | if ($val_idx !== '') { |
||
202 | $val_idx = explode(':', $val_idx); |
||
203 | // -1 means remove, 0 keep, 1 add |
||
204 | $val_idx = array_combine($val_idx, array_fill(0, count($val_idx), -1)); |
||
205 | } else { |
||
206 | $val_idx = array(); |
||
207 | } |
||
208 | |||
209 | foreach ($values as $val) { |
||
210 | $val = (string)$val; |
||
211 | if ($val !== "") { |
||
212 | $id = array_search($val, $metawords, true); |
||
213 | if ($id === false) { |
||
214 | // didn't find $val, so we'll add it to the end of metawords and create a placeholder in metaidx |
||
215 | $id = count($metawords); |
||
216 | $metawords[$id] = $val; |
||
217 | $metaidx[$id] = ''; |
||
218 | $addwords = true; |
||
219 | } |
||
220 | // test if value is already in the index |
||
221 | if (isset($val_idx[$id]) && $val_idx[$id] <= 0){ |
||
222 | $val_idx[$id] = 0; |
||
223 | } else { // else add it |
||
224 | $val_idx[$id] = 1; |
||
225 | } |
||
226 | } |
||
227 | } |
||
228 | |||
229 | if ($addwords) { |
||
230 | $this->saveIndex($metaname.'_w', '', $metawords); |
||
231 | } |
||
232 | $vals_changed = false; |
||
233 | foreach ($val_idx as $id => $action) { |
||
234 | if ($action == -1) { |
||
235 | $metaidx[$id] = $this->updateTuple($metaidx[$id], $pid, 0); |
||
0 ignored issues
–
show
It seems like
$pid defined by $this->getPIDNoLock($page) on line 175 can also be of type boolean ; however, dokuwiki\Search\Indexer::updateTuple() does only seem to accept string|integer , maybe add an additional type check?
If a method or function can return multiple different values and unless you are sure that you only can receive a single value in this context, we recommend to add an additional type check: /**
* @return array|string
*/
function returnsDifferentValues($x) {
if ($x) {
return 'foo';
}
return array();
}
$x = returnsDifferentValues($y);
if (is_array($x)) {
// $x is an array.
}
If this a common case that PHP Analyzer should handle natively, please let us know by opening an issue. ![]() |
|||
236 | $vals_changed = true; |
||
237 | unset($val_idx[$id]); |
||
238 | } elseif ($action == 1) { |
||
239 | $metaidx[$id] = $this->updateTuple($metaidx[$id], $pid, 1); |
||
0 ignored issues
–
show
It seems like
$pid defined by $this->getPIDNoLock($page) on line 175 can also be of type boolean ; however, dokuwiki\Search\Indexer::updateTuple() does only seem to accept string|integer , maybe add an additional type check?
If a method or function can return multiple different values and unless you are sure that you only can receive a single value in this context, we recommend to add an additional type check: /**
* @return array|string
*/
function returnsDifferentValues($x) {
if ($x) {
return 'foo';
}
return array();
}
$x = returnsDifferentValues($y);
if (is_array($x)) {
// $x is an array.
}
If this a common case that PHP Analyzer should handle natively, please let us know by opening an issue. ![]() |
|||
240 | $vals_changed = true; |
||
241 | } |
||
242 | } |
||
243 | |||
244 | if ($vals_changed) { |
||
245 | $this->saveIndex($metaname.'_i', '', $metaidx); |
||
246 | $val_idx = implode(':', array_keys($val_idx)); |
||
247 | $this->saveIndexKey($metaname.'_p', '', $pid, $val_idx); |
||
0 ignored issues
–
show
It seems like
$pid defined by $this->getPIDNoLock($page) on line 175 can also be of type boolean ; however, dokuwiki\Search\Indexer::saveIndexKey() does only seem to accept integer , maybe add an additional type check?
If a method or function can return multiple different values and unless you are sure that you only can receive a single value in this context, we recommend to add an additional type check: /**
* @return array|string
*/
function returnsDifferentValues($x) {
if ($x) {
return 'foo';
}
return array();
}
$x = returnsDifferentValues($y);
if (is_array($x)) {
// $x is an array.
}
If this a common case that PHP Analyzer should handle natively, please let us know by opening an issue. ![]() |
|||
248 | } |
||
249 | |||
250 | unset($metaidx); |
||
251 | unset($metawords); |
||
252 | } |
||
253 | |||
254 | $this->unlock(); |
||
255 | return true; |
||
256 | } |
||
257 | |||
258 | /** |
||
259 | * Rename a page in the search index without changing the indexed content. This function doesn't check if the |
||
260 | * old or new name exists in the filesystem. It returns an error if the old page isn't in the page list of the |
||
261 | * indexer and it deletes all previously indexed content of the new page. |
||
262 | * |
||
263 | * @param string $oldpage The old page name |
||
264 | * @param string $newpage The new page name |
||
265 | * @return string|bool If the page was successfully renamed, can be a message in the case of an error |
||
266 | */ |
||
267 | public function renamePage($oldpage, $newpage) { |
||
268 | if (!$this->lock()) return 'locked'; |
||
269 | |||
270 | $pages = $this->getPages(); |
||
271 | |||
272 | $id = array_search($oldpage, $pages, true); |
||
273 | if ($id === false) { |
||
274 | $this->unlock(); |
||
275 | return 'page is not in index'; |
||
276 | } |
||
277 | |||
278 | $new_id = array_search($newpage, $pages, true); |
||
279 | if ($new_id !== false) { |
||
280 | // make sure the page is not in the index anymore |
||
281 | if ($this->deletePageNoLock($newpage) !== true) { |
||
282 | return false; |
||
283 | } |
||
284 | |||
285 | $pages[$new_id] = 'deleted:'.time().rand(0, 9999); |
||
286 | } |
||
287 | |||
288 | $pages[$id] = $newpage; |
||
289 | |||
290 | // update index |
||
291 | if (!$this->saveIndex('page', '', $pages)) { |
||
292 | $this->unlock(); |
||
293 | return false; |
||
294 | } |
||
295 | |||
296 | // reset the pid cache |
||
297 | $this->pidCache = array(); |
||
298 | |||
299 | $this->unlock(); |
||
300 | return true; |
||
301 | } |
||
302 | |||
303 | /** |
||
304 | * Renames a meta value in the index. This doesn't change the meta value in the pages, it assumes that all pages |
||
305 | * will be updated. |
||
306 | * |
||
307 | * @param string $key The metadata key of which a value shall be changed |
||
308 | * @param string $oldvalue The old value that shall be renamed |
||
309 | * @param string $newvalue The new value to which the old value shall be renamed, if exists values will be merged |
||
310 | * @return bool|string If renaming the value has been successful, false or error message on error. |
||
311 | */ |
||
312 | public function renameMetaValue($key, $oldvalue, $newvalue) { |
||
313 | if (!$this->lock()) return 'locked'; |
||
314 | |||
315 | // change the relation references index |
||
316 | $metavalues = $this->getIndex($key, '_w'); |
||
317 | $oldid = array_search($oldvalue, $metavalues, true); |
||
318 | if ($oldid !== false) { |
||
319 | $newid = array_search($newvalue, $metavalues, true); |
||
320 | if ($newid !== false) { |
||
321 | // free memory |
||
322 | unset ($metavalues); |
||
323 | |||
324 | // okay, now we have two entries for the same value. we need to merge them. |
||
325 | $indexline = $this->getIndexKey($key.'_i', '', $oldid); |
||
326 | if ($indexline != '') { |
||
327 | $newindexline = $this->getIndexKey($key.'_i', '', $newid); |
||
328 | $pagekeys = $this->getIndex($key.'_p', ''); |
||
329 | $parts = explode(':', $indexline); |
||
330 | foreach ($parts as $part) { |
||
331 | list($id, $count) = explode('*', $part); |
||
332 | $newindexline = $this->updateTuple($newindexline, $id, $count); |
||
333 | |||
334 | $keyline = explode(':', $pagekeys[$id]); |
||
335 | // remove old meta value |
||
336 | $keyline = array_diff($keyline, array($oldid)); |
||
337 | // add new meta value when not already present |
||
338 | if (!in_array($newid, $keyline)) { |
||
339 | array_push($keyline, $newid); |
||
340 | } |
||
341 | $pagekeys[$id] = implode(':', $keyline); |
||
342 | } |
||
343 | $this->saveIndex($key.'_p', '', $pagekeys); |
||
344 | unset($pagekeys); |
||
345 | $this->saveIndexKey($key.'_i', '', $oldid, ''); |
||
346 | $this->saveIndexKey($key.'_i', '', $newid, $newindexline); |
||
347 | } |
||
348 | } else { |
||
349 | $metavalues[$oldid] = $newvalue; |
||
350 | if (!$this->saveIndex($key.'_w', '', $metavalues)) { |
||
351 | $this->unlock(); |
||
352 | return false; |
||
353 | } |
||
354 | } |
||
355 | } |
||
356 | |||
357 | $this->unlock(); |
||
358 | return true; |
||
359 | } |
||
360 | |||
361 | /** |
||
362 | * Remove a page from the index |
||
363 | * |
||
364 | * Erases entries in all known indexes. |
||
365 | * |
||
366 | * @param string $page a page name |
||
367 | * @return string|boolean the function completed successfully |
||
368 | * |
||
369 | * @author Tom N Harris <[email protected]> |
||
370 | */ |
||
371 | public function deletePage($page) { |
||
372 | if (!$this->lock()) |
||
373 | return "locked"; |
||
374 | |||
375 | $result = $this->deletePageNoLock($page); |
||
376 | |||
377 | $this->unlock(); |
||
378 | |||
379 | return $result; |
||
380 | } |
||
381 | |||
382 | /** |
||
383 | * Remove a page from the index without locking the index, only use this function if the index is already locked |
||
384 | * |
||
385 | * Erases entries in all known indexes. |
||
386 | * |
||
387 | * @param string $page a page name |
||
388 | * @return boolean the function completed successfully |
||
389 | * |
||
390 | * @author Tom N Harris <[email protected]> |
||
391 | */ |
||
392 | protected function deletePageNoLock($page) { |
||
393 | // load known documents |
||
394 | $pid = $this->getPIDNoLock($page); |
||
395 | if ($pid === false) { |
||
396 | return false; |
||
397 | } |
||
398 | |||
399 | // Remove obsolete index entries |
||
400 | $pageword_idx = $this->getIndexKey('pageword', '', $pid); |
||
0 ignored issues
–
show
It seems like
$pid defined by $this->getPIDNoLock($page) on line 394 can also be of type boolean ; however, dokuwiki\Search\Indexer::getIndexKey() does only seem to accept integer , maybe add an additional type check?
If a method or function can return multiple different values and unless you are sure that you only can receive a single value in this context, we recommend to add an additional type check: /**
* @return array|string
*/
function returnsDifferentValues($x) {
if ($x) {
return 'foo';
}
return array();
}
$x = returnsDifferentValues($y);
if (is_array($x)) {
// $x is an array.
}
If this a common case that PHP Analyzer should handle natively, please let us know by opening an issue. ![]() |
|||
401 | if ($pageword_idx !== '') { |
||
402 | $delwords = explode(':',$pageword_idx); |
||
403 | $upwords = array(); |
||
404 | foreach ($delwords as $word) { |
||
405 | if ($word != '') { |
||
406 | list($wlen,$wid) = explode('*', $word); |
||
407 | $wid = (int)$wid; |
||
408 | $upwords[$wlen][] = $wid; |
||
409 | } |
||
410 | } |
||
411 | foreach ($upwords as $wlen => $widx) { |
||
412 | $index = $this->getIndex('i', $wlen); |
||
413 | foreach ($widx as $wid) { |
||
414 | $index[$wid] = $this->updateTuple($index[$wid], $pid, 0); |
||
0 ignored issues
–
show
It seems like
$pid defined by $this->getPIDNoLock($page) on line 394 can also be of type boolean ; however, dokuwiki\Search\Indexer::updateTuple() does only seem to accept string|integer , maybe add an additional type check?
If a method or function can return multiple different values and unless you are sure that you only can receive a single value in this context, we recommend to add an additional type check: /**
* @return array|string
*/
function returnsDifferentValues($x) {
if ($x) {
return 'foo';
}
return array();
}
$x = returnsDifferentValues($y);
if (is_array($x)) {
// $x is an array.
}
If this a common case that PHP Analyzer should handle natively, please let us know by opening an issue. ![]() |
|||
415 | } |
||
416 | $this->saveIndex('i', $wlen, $index); |
||
417 | } |
||
418 | } |
||
419 | // Save the reverse index |
||
420 | if (!$this->saveIndexKey('pageword', '', $pid, "")) { |
||
0 ignored issues
–
show
It seems like
$pid defined by $this->getPIDNoLock($page) on line 394 can also be of type boolean ; however, dokuwiki\Search\Indexer::saveIndexKey() does only seem to accept integer , maybe add an additional type check?
If a method or function can return multiple different values and unless you are sure that you only can receive a single value in this context, we recommend to add an additional type check: /**
* @return array|string
*/
function returnsDifferentValues($x) {
if ($x) {
return 'foo';
}
return array();
}
$x = returnsDifferentValues($y);
if (is_array($x)) {
// $x is an array.
}
If this a common case that PHP Analyzer should handle natively, please let us know by opening an issue. ![]() |
|||
421 | return false; |
||
422 | } |
||
423 | |||
424 | $this->saveIndexKey('title', '', $pid, ""); |
||
0 ignored issues
–
show
It seems like
$pid defined by $this->getPIDNoLock($page) on line 394 can also be of type boolean ; however, dokuwiki\Search\Indexer::saveIndexKey() does only seem to accept integer , maybe add an additional type check?
If a method or function can return multiple different values and unless you are sure that you only can receive a single value in this context, we recommend to add an additional type check: /**
* @return array|string
*/
function returnsDifferentValues($x) {
if ($x) {
return 'foo';
}
return array();
}
$x = returnsDifferentValues($y);
if (is_array($x)) {
// $x is an array.
}
If this a common case that PHP Analyzer should handle natively, please let us know by opening an issue. ![]() |
|||
425 | $keyidx = $this->getIndex('metadata', ''); |
||
426 | foreach ($keyidx as $metaname) { |
||
427 | $val_idx = explode(':', $this->getIndexKey($metaname.'_p', '', $pid)); |
||
0 ignored issues
–
show
It seems like
$pid defined by $this->getPIDNoLock($page) on line 394 can also be of type boolean ; however, dokuwiki\Search\Indexer::getIndexKey() does only seem to accept integer , maybe add an additional type check?
If a method or function can return multiple different values and unless you are sure that you only can receive a single value in this context, we recommend to add an additional type check: /**
* @return array|string
*/
function returnsDifferentValues($x) {
if ($x) {
return 'foo';
}
return array();
}
$x = returnsDifferentValues($y);
if (is_array($x)) {
// $x is an array.
}
If this a common case that PHP Analyzer should handle natively, please let us know by opening an issue. ![]() |
|||
428 | $meta_idx = $this->getIndex($metaname.'_i', ''); |
||
429 | foreach ($val_idx as $id) { |
||
430 | if ($id === '') continue; |
||
431 | $meta_idx[$id] = $this->updateTuple($meta_idx[$id], $pid, 0); |
||
0 ignored issues
–
show
It seems like
$pid defined by $this->getPIDNoLock($page) on line 394 can also be of type boolean ; however, dokuwiki\Search\Indexer::updateTuple() does only seem to accept string|integer , maybe add an additional type check?
If a method or function can return multiple different values and unless you are sure that you only can receive a single value in this context, we recommend to add an additional type check: /**
* @return array|string
*/
function returnsDifferentValues($x) {
if ($x) {
return 'foo';
}
return array();
}
$x = returnsDifferentValues($y);
if (is_array($x)) {
// $x is an array.
}
If this a common case that PHP Analyzer should handle natively, please let us know by opening an issue. ![]() |
|||
432 | } |
||
433 | $this->saveIndex($metaname.'_i', '', $meta_idx); |
||
434 | $this->saveIndexKey($metaname.'_p', '', $pid, ''); |
||
0 ignored issues
–
show
It seems like
$pid defined by $this->getPIDNoLock($page) on line 394 can also be of type boolean ; however, dokuwiki\Search\Indexer::saveIndexKey() does only seem to accept integer , maybe add an additional type check?
If a method or function can return multiple different values and unless you are sure that you only can receive a single value in this context, we recommend to add an additional type check: /**
* @return array|string
*/
function returnsDifferentValues($x) {
if ($x) {
return 'foo';
}
return array();
}
$x = returnsDifferentValues($y);
if (is_array($x)) {
// $x is an array.
}
If this a common case that PHP Analyzer should handle natively, please let us know by opening an issue. ![]() |
|||
435 | } |
||
436 | |||
437 | return true; |
||
438 | } |
||
439 | |||
440 | /** |
||
441 | * Clear the whole index |
||
442 | * |
||
443 | * @return bool If the index has been cleared successfully |
||
444 | */ |
||
445 | public function clear() { |
||
446 | global $conf; |
||
447 | |||
448 | if (!$this->lock()) return false; |
||
449 | |||
450 | @unlink($conf['indexdir'].'/page.idx'); |
||
451 | @unlink($conf['indexdir'].'/title.idx'); |
||
452 | @unlink($conf['indexdir'].'/pageword.idx'); |
||
453 | @unlink($conf['indexdir'].'/metadata.idx'); |
||
454 | $dir = @opendir($conf['indexdir']); |
||
455 | if($dir!==false){ |
||
456 | while(($f = readdir($dir)) !== false){ |
||
457 | if(substr($f,-4)=='.idx' && |
||
458 | (substr($f,0,1)=='i' || substr($f,0,1)=='w' |
||
459 | || substr($f,-6)=='_w.idx' || substr($f,-6)=='_i.idx' || substr($f,-6)=='_p.idx')) |
||
460 | @unlink($conf['indexdir']."/$f"); |
||
461 | } |
||
462 | } |
||
463 | @unlink($conf['indexdir'].'/lengths.idx'); |
||
464 | |||
465 | // clear the pid cache |
||
466 | $this->pidCache = array(); |
||
467 | |||
468 | $this->unlock(); |
||
469 | return true; |
||
470 | } |
||
471 | |||
472 | /** |
||
473 | * Split the text into words for fulltext search |
||
474 | * |
||
475 | * TODO: does this also need &$stopwords ? |
||
476 | * |
||
477 | * @triggers INDEXER_TEXT_PREPARE |
||
478 | * This event allows plugins to modify the text before it gets tokenized. |
||
479 | * Plugins intercepting this event should also intercept INDEX_VERSION_GET |
||
480 | * |
||
481 | * @param string $text plain text |
||
482 | * @param boolean $wc are wildcards allowed? |
||
483 | * @return array list of words in the text |
||
484 | * |
||
485 | * @author Tom N Harris <[email protected]> |
||
486 | * @author Andreas Gohr <[email protected]> |
||
487 | */ |
||
488 | public function tokenizer($text, $wc=false) { |
||
489 | $wc = ($wc) ? '' : '\*'; |
||
490 | $stopwords =& idx_get_stopwords(); |
||
491 | |||
492 | // prepare the text to be tokenized |
||
493 | $evt = new Event('INDEXER_TEXT_PREPARE', $text); |
||
494 | if ($evt->advise_before(true)) { |
||
495 | if (preg_match('/[^0-9A-Za-z ]/u', $text)) { |
||
496 | $text = \dokuwiki\Utf8\Asian::separateAsianWords($text); |
||
497 | } |
||
498 | } |
||
499 | $evt->advise_after(); |
||
500 | unset($evt); |
||
501 | |||
502 | $text = strtr($text, |
||
503 | array( |
||
504 | "\r" => ' ', |
||
505 | "\n" => ' ', |
||
506 | "\t" => ' ', |
||
507 | "\xC2\xAD" => '', //soft-hyphen |
||
508 | ) |
||
509 | ); |
||
510 | if (preg_match('/[^0-9A-Za-z ]/u', $text)) |
||
511 | $text = \dokuwiki\Utf8\Clean::stripspecials($text, ' ', '\._\-:'.$wc); |
||
512 | |||
513 | $wordlist = explode(' ', $text); |
||
514 | foreach ($wordlist as $i => $word) { |
||
515 | $wordlist[$i] = (preg_match('/[^0-9A-Za-z]/u', $word)) ? |
||
516 | \dokuwiki\Utf8\PhpString::strtolower($word) : strtolower($word); |
||
517 | } |
||
518 | |||
519 | foreach ($wordlist as $i => $word) { |
||
520 | if ((!is_numeric($word) && strlen($word) < IDX_MINWORDLENGTH) |
||
521 | || array_search($word, $stopwords, true) !== false) |
||
522 | unset($wordlist[$i]); |
||
523 | } |
||
524 | return array_values($wordlist); |
||
525 | } |
||
526 | |||
527 | /** |
||
528 | * Get the numeric PID of a page |
||
529 | * |
||
530 | * @param string $page The page to get the PID for |
||
531 | * @return bool|int The page id on success, false on error |
||
532 | */ |
||
533 | public function getPID($page) { |
||
534 | // return PID without locking when it is in the cache |
||
535 | if (isset($this->pidCache[$page])) return $this->pidCache[$page]; |
||
536 | |||
537 | if (!$this->lock()) |
||
538 | return false; |
||
539 | |||
540 | // load known documents |
||
541 | $pid = $this->getPIDNoLock($page); |
||
542 | if ($pid === false) { |
||
543 | $this->unlock(); |
||
544 | return false; |
||
545 | } |
||
546 | |||
547 | $this->unlock(); |
||
548 | return $pid; |
||
549 | } |
||
550 | |||
551 | /** |
||
552 | * Get the numeric PID of a page without locking the index. |
||
553 | * Only use this function when the index is already locked. |
||
554 | * |
||
555 | * @param string $page The page to get the PID for |
||
556 | * @return bool|int The page id on success, false on error |
||
557 | */ |
||
558 | protected function getPIDNoLock($page) { |
||
559 | // avoid expensive addIndexKey operation for the most recently requested pages by using a cache |
||
560 | if (isset($this->pidCache[$page])) return $this->pidCache[$page]; |
||
561 | $pid = $this->addIndexKey('page', '', $page); |
||
0 ignored issues
–
show
|
|||
562 | // limit cache to 10 entries by discarding the oldest element as in DokuWiki usually only the most recently |
||
563 | // added item will be requested again |
||
564 | if (count($this->pidCache) > 10) array_shift($this->pidCache); |
||
565 | $this->pidCache[$page] = $pid; |
||
566 | return $pid; |
||
567 | } |
||
568 | |||
569 | /** |
||
570 | * Get the page id of a numeric PID |
||
571 | * |
||
572 | * @param int $pid The PID to get the page id for |
||
573 | * @return string The page id |
||
574 | */ |
||
575 | public function getPageFromPID($pid) { |
||
576 | return $this->getIndexKey('page', '', $pid); |
||
577 | } |
||
578 | |||
579 | /** |
||
580 | * Find pages in the fulltext index containing the words, |
||
581 | * |
||
582 | * The search words must be pre-tokenized, meaning only letters and |
||
583 | * numbers with an optional wildcard |
||
584 | * |
||
585 | * The returned array will have the original tokens as key. The values |
||
586 | * in the returned list is an array with the page names as keys and the |
||
587 | * number of times that token appears on the page as value. |
||
588 | * |
||
589 | * @param array $tokens list of words to search for |
||
590 | * @return array list of page names with usage counts |
||
591 | * |
||
592 | * @author Tom N Harris <[email protected]> |
||
593 | * @author Andreas Gohr <[email protected]> |
||
594 | */ |
||
595 | public function lookup(&$tokens) { |
||
596 | $result = array(); |
||
597 | $wids = $this->getIndexWords($tokens, $result); |
||
598 | if (empty($wids)) return array(); |
||
599 | // load known words and documents |
||
600 | $page_idx = $this->getIndex('page', ''); |
||
601 | $docs = array(); |
||
602 | foreach (array_keys($wids) as $wlen) { |
||
603 | $wids[$wlen] = array_unique($wids[$wlen]); |
||
604 | $index = $this->getIndex('i', $wlen); |
||
605 | foreach($wids[$wlen] as $ixid) { |
||
606 | if ($ixid < count($index)) |
||
607 | $docs["$wlen*$ixid"] = $this->parseTuples($page_idx, $index[$ixid]); |
||
608 | } |
||
609 | } |
||
610 | // merge found pages into final result array |
||
611 | $final = array(); |
||
612 | foreach ($result as $word => $res) { |
||
613 | $final[$word] = array(); |
||
614 | foreach ($res as $wid) { |
||
615 | // handle the case when ($ixid < count($index)) has been false |
||
616 | // and thus $docs[$wid] hasn't been set. |
||
617 | if (!isset($docs[$wid])) continue; |
||
618 | $hits = &$docs[$wid]; |
||
619 | foreach ($hits as $hitkey => $hitcnt) { |
||
620 | // make sure the document still exists |
||
621 | if (!page_exists($hitkey, '', false)) continue; |
||
622 | if (!isset($final[$word][$hitkey])) |
||
623 | $final[$word][$hitkey] = $hitcnt; |
||
624 | else |
||
625 | $final[$word][$hitkey] += $hitcnt; |
||
626 | } |
||
627 | } |
||
628 | } |
||
629 | return $final; |
||
630 | } |
||
631 | |||
632 | /** |
||
633 | * Find pages containing a metadata key. |
||
634 | * |
||
635 | * The metadata values are compared as case-sensitive strings. Pass a |
||
636 | * callback function that returns true or false to use a different |
||
637 | * comparison function. The function will be called with the $value being |
||
638 | * searched for as the first argument, and the word in the index as the |
||
639 | * second argument. The function preg_match can be used directly if the |
||
640 | * values are regexes. |
||
641 | * |
||
642 | * @param string $key name of the metadata key to look for |
||
643 | * @param string $value search term to look for, must be a string or array of strings |
||
644 | * @param callback $func comparison function |
||
645 | * @return array lists with page names, keys are query values if $value is array |
||
646 | * |
||
647 | * @author Tom N Harris <[email protected]> |
||
648 | * @author Michael Hamann <[email protected]> |
||
649 | */ |
||
650 | public function lookupKey($key, &$value, $func=null) { |
||
651 | if (!is_array($value)) |
||
652 | $value_array = array($value); |
||
653 | else |
||
654 | $value_array =& $value; |
||
655 | |||
656 | // the matching ids for the provided value(s) |
||
657 | $value_ids = array(); |
||
658 | |||
659 | $metaname = idx_cleanName($key); |
||
660 | |||
661 | // get all words in order to search the matching ids |
||
662 | if ($key == 'title') { |
||
663 | $words = $this->getIndex('title', ''); |
||
664 | } else { |
||
665 | $words = $this->getIndex($metaname.'_w', ''); |
||
666 | } |
||
667 | |||
668 | if (!is_null($func)) { |
||
669 | foreach ($value_array as $val) { |
||
670 | foreach ($words as $i => $word) { |
||
671 | if (call_user_func_array($func, array($val, $word))) |
||
672 | $value_ids[$i][] = $val; |
||
673 | } |
||
674 | } |
||
675 | } else { |
||
676 | foreach ($value_array as $val) { |
||
677 | $xval = $val; |
||
678 | $caret = '^'; |
||
679 | $dollar = '$'; |
||
680 | // check for wildcards |
||
681 | if (substr($xval, 0, 1) == '*') { |
||
682 | $xval = substr($xval, 1); |
||
683 | $caret = ''; |
||
684 | } |
||
685 | if (substr($xval, -1, 1) == '*') { |
||
686 | $xval = substr($xval, 0, -1); |
||
687 | $dollar = ''; |
||
688 | } |
||
689 | if (!$caret || !$dollar) { |
||
690 | $re = $caret.preg_quote($xval, '/').$dollar; |
||
691 | foreach(array_keys(preg_grep('/'.$re.'/', $words)) as $i) |
||
692 | $value_ids[$i][] = $val; |
||
693 | } else { |
||
694 | if (($i = array_search($val, $words, true)) !== false) |
||
695 | $value_ids[$i][] = $val; |
||
696 | } |
||
697 | } |
||
698 | } |
||
699 | |||
700 | unset($words); // free the used memory |
||
701 | |||
702 | // initialize the result so it won't be null |
||
703 | $result = array(); |
||
704 | foreach ($value_array as $val) { |
||
705 | $result[$val] = array(); |
||
706 | } |
||
707 | |||
708 | $page_idx = $this->getIndex('page', ''); |
||
709 | |||
710 | // Special handling for titles |
||
711 | if ($key == 'title') { |
||
712 | foreach ($value_ids as $pid => $val_list) { |
||
713 | $page = $page_idx[$pid]; |
||
714 | foreach ($val_list as $val) { |
||
715 | $result[$val][] = $page; |
||
716 | } |
||
717 | } |
||
718 | } else { |
||
719 | // load all lines and pages so the used lines can be taken and matched with the pages |
||
720 | $lines = $this->getIndex($metaname.'_i', ''); |
||
721 | |||
722 | foreach ($value_ids as $value_id => $val_list) { |
||
723 | // parse the tuples of the form page_id*1:page2_id*1 and so on, return value |
||
724 | // is an array with page_id => 1, page2_id => 1 etc. so take the keys only |
||
725 | $pages = array_keys($this->parseTuples($page_idx, $lines[$value_id])); |
||
726 | foreach ($val_list as $val) { |
||
727 | $result[$val] = array_merge($result[$val], $pages); |
||
728 | } |
||
729 | } |
||
730 | } |
||
731 | if (!is_array($value)) $result = $result[$value]; |
||
732 | return $result; |
||
733 | } |
||
734 | |||
735 | /** |
||
736 | * Find the index ID of each search term. |
||
737 | * |
||
738 | * The query terms should only contain valid characters, with a '*' at |
||
739 | * either the beginning or end of the word (or both). |
||
740 | * The $result parameter can be used to merge the index locations with |
||
741 | * the appropriate query term. |
||
742 | * |
||
743 | * @param array $words The query terms. |
||
744 | * @param array $result Set to word => array("length*id" ...) |
||
745 | * @return array Set to length => array(id ...) |
||
746 | * |
||
747 | * @author Tom N Harris <[email protected]> |
||
748 | */ |
||
749 | protected function getIndexWords(&$words, &$result) { |
||
750 | $tokens = array(); |
||
751 | $tokenlength = array(); |
||
752 | $tokenwild = array(); |
||
753 | foreach ($words as $word) { |
||
754 | $result[$word] = array(); |
||
755 | $caret = '^'; |
||
756 | $dollar = '$'; |
||
757 | $xword = $word; |
||
758 | $wlen = wordlen($word); |
||
759 | |||
760 | // check for wildcards |
||
761 | if (substr($xword, 0, 1) == '*') { |
||
762 | $xword = substr($xword, 1); |
||
763 | $caret = ''; |
||
764 | $wlen -= 1; |
||
765 | } |
||
766 | if (substr($xword, -1, 1) == '*') { |
||
767 | $xword = substr($xword, 0, -1); |
||
768 | $dollar = ''; |
||
769 | $wlen -= 1; |
||
770 | } |
||
771 | if ($wlen < IDX_MINWORDLENGTH && $caret && $dollar && !is_numeric($xword)) |
||
772 | continue; |
||
773 | if (!isset($tokens[$xword])) |
||
774 | $tokenlength[$wlen][] = $xword; |
||
775 | if (!$caret || !$dollar) { |
||
776 | $re = $caret.preg_quote($xword, '/').$dollar; |
||
777 | $tokens[$xword][] = array($word, '/'.$re.'/'); |
||
778 | if (!isset($tokenwild[$xword])) |
||
779 | $tokenwild[$xword] = $wlen; |
||
780 | } else { |
||
781 | $tokens[$xword][] = array($word, null); |
||
782 | } |
||
783 | } |
||
784 | asort($tokenwild); |
||
785 | // $tokens = array( base word => array( [ query term , regexp ] ... ) ... ) |
||
786 | // $tokenlength = array( base word length => base word ... ) |
||
787 | // $tokenwild = array( base word => base word length ... ) |
||
788 | $length_filter = empty($tokenwild) ? $tokenlength : min(array_keys($tokenlength)); |
||
789 | $indexes_known = $this->indexLengths($length_filter); |
||
790 | if (!empty($tokenwild)) sort($indexes_known); |
||
791 | // get word IDs |
||
792 | $wids = array(); |
||
793 | foreach ($indexes_known as $ixlen) { |
||
794 | $word_idx = $this->getIndex('w', $ixlen); |
||
795 | // handle exact search |
||
796 | if (isset($tokenlength[$ixlen])) { |
||
797 | foreach ($tokenlength[$ixlen] as $xword) { |
||
798 | $wid = array_search($xword, $word_idx, true); |
||
799 | if ($wid !== false) { |
||
800 | $wids[$ixlen][] = $wid; |
||
801 | foreach ($tokens[$xword] as $w) |
||
802 | $result[$w[0]][] = "$ixlen*$wid"; |
||
803 | } |
||
804 | } |
||
805 | } |
||
806 | // handle wildcard search |
||
807 | foreach ($tokenwild as $xword => $wlen) { |
||
808 | if ($wlen >= $ixlen) break; |
||
809 | foreach ($tokens[$xword] as $w) { |
||
810 | if (is_null($w[1])) continue; |
||
811 | foreach(array_keys(preg_grep($w[1], $word_idx)) as $wid) { |
||
812 | $wids[$ixlen][] = $wid; |
||
813 | $result[$w[0]][] = "$ixlen*$wid"; |
||
814 | } |
||
815 | } |
||
816 | } |
||
817 | } |
||
818 | return $wids; |
||
819 | } |
||
820 | |||
821 | /** |
||
822 | * Return a list of all pages |
||
823 | * Warning: pages may not exist! |
||
824 | * |
||
825 | * @param string $key list only pages containing the metadata key (optional) |
||
826 | * @return array list of page names |
||
827 | * |
||
828 | * @author Tom N Harris <[email protected]> |
||
829 | */ |
||
830 | public function getPages($key=null) { |
||
831 | $page_idx = $this->getIndex('page', ''); |
||
832 | if (is_null($key)) return $page_idx; |
||
833 | |||
834 | $metaname = idx_cleanName($key); |
||
835 | |||
836 | // Special handling for titles |
||
837 | if ($key == 'title') { |
||
838 | $title_idx = $this->getIndex('title', ''); |
||
839 | array_splice($page_idx, count($title_idx)); |
||
840 | foreach ($title_idx as $i => $title) |
||
841 | if ($title === "") unset($page_idx[$i]); |
||
842 | return array_values($page_idx); |
||
843 | } |
||
844 | |||
845 | $pages = array(); |
||
846 | $lines = $this->getIndex($metaname.'_i', ''); |
||
847 | foreach ($lines as $line) { |
||
848 | $pages = array_merge($pages, $this->parseTuples($page_idx, $line)); |
||
849 | } |
||
850 | return array_keys($pages); |
||
851 | } |
||
852 | |||
853 | /** |
||
854 | * Return a list of words sorted by number of times used |
||
855 | * |
||
856 | * @param int $min bottom frequency threshold |
||
857 | * @param int $max upper frequency limit. No limit if $max<$min |
||
858 | * @param int $minlen minimum length of words to count |
||
859 | * @param string $key metadata key to list. Uses the fulltext index if not given |
||
860 | * @return array list of words as the keys and frequency as values |
||
861 | * |
||
862 | * @author Tom N Harris <[email protected]> |
||
863 | */ |
||
864 | public function histogram($min=1, $max=0, $minlen=3, $key=null) { |
||
865 | if ($min < 1) |
||
866 | $min = 1; |
||
867 | if ($max < $min) |
||
868 | $max = 0; |
||
869 | |||
870 | $result = array(); |
||
871 | |||
872 | if ($key == 'title') { |
||
873 | $index = $this->getIndex('title', ''); |
||
874 | $index = array_count_values($index); |
||
875 | foreach ($index as $val => $cnt) { |
||
876 | if ($cnt >= $min && (!$max || $cnt <= $max) && strlen($val) >= $minlen) |
||
877 | $result[$val] = $cnt; |
||
878 | } |
||
879 | } |
||
880 | elseif (!is_null($key)) { |
||
881 | $metaname = idx_cleanName($key); |
||
882 | $index = $this->getIndex($metaname.'_i', ''); |
||
883 | $val_idx = array(); |
||
884 | foreach ($index as $wid => $line) { |
||
885 | $freq = $this->countTuples($line); |
||
886 | if ($freq >= $min && (!$max || $freq <= $max)) |
||
887 | $val_idx[$wid] = $freq; |
||
888 | } |
||
889 | if (!empty($val_idx)) { |
||
890 | $words = $this->getIndex($metaname.'_w', ''); |
||
891 | foreach ($val_idx as $wid => $freq) { |
||
892 | if (strlen($words[$wid]) >= $minlen) |
||
893 | $result[$words[$wid]] = $freq; |
||
894 | } |
||
895 | } |
||
896 | } |
||
897 | else { |
||
898 | $lengths = idx_listIndexLengths(); |
||
899 | foreach ($lengths as $length) { |
||
900 | if ($length < $minlen) continue; |
||
901 | $index = $this->getIndex('i', $length); |
||
902 | $words = null; |
||
903 | foreach ($index as $wid => $line) { |
||
904 | $freq = $this->countTuples($line); |
||
905 | if ($freq >= $min && (!$max || $freq <= $max)) { |
||
906 | if ($words === null) |
||
907 | $words = $this->getIndex('w', $length); |
||
908 | $result[$words[$wid]] = $freq; |
||
909 | } |
||
910 | } |
||
911 | } |
||
912 | } |
||
913 | |||
914 | arsort($result); |
||
915 | return $result; |
||
916 | } |
||
917 | |||
918 | /** |
||
919 | * Lock the indexer. |
||
920 | * |
||
921 | * @author Tom N Harris <[email protected]> |
||
922 | * |
||
923 | * @return bool|string |
||
924 | */ |
||
925 | protected function lock() { |
||
926 | global $conf; |
||
927 | $status = true; |
||
928 | $run = 0; |
||
929 | $lock = $conf['lockdir'].'/_indexer.lock'; |
||
930 | while (!@mkdir($lock, $conf['dmode'])) { |
||
931 | usleep(50); |
||
932 | if(is_dir($lock) && time()-@filemtime($lock) > 60*5){ |
||
933 | // looks like a stale lock - remove it |
||
934 | if (!@rmdir($lock)) { |
||
935 | $status = "removing the stale lock failed"; |
||
936 | return false; |
||
937 | } else { |
||
938 | $status = "stale lock removed"; |
||
939 | } |
||
940 | }elseif($run++ == 1000){ |
||
941 | // we waited 5 seconds for that lock |
||
942 | return false; |
||
943 | } |
||
944 | } |
||
945 | if (!empty($conf['dperm'])) { |
||
946 | chmod($lock, $conf['dperm']); |
||
947 | } |
||
948 | return $status; |
||
949 | } |
||
950 | |||
951 | /** |
||
952 | * Release the indexer lock. |
||
953 | * |
||
954 | * @author Tom N Harris <[email protected]> |
||
955 | * |
||
956 | * @return bool |
||
957 | */ |
||
958 | protected function unlock() { |
||
959 | global $conf; |
||
960 | @rmdir($conf['lockdir'].'/_indexer.lock'); |
||
961 | return true; |
||
962 | } |
||
963 | |||
964 | /** |
||
965 | * Retrieve the entire index. |
||
966 | * |
||
967 | * The $suffix argument is for an index that is split into |
||
968 | * multiple parts. Different index files should use different |
||
969 | * base names. |
||
970 | * |
||
971 | * @param string $idx name of the index |
||
972 | * @param string $suffix subpart identifier |
||
973 | * @return array list of lines without CR or LF |
||
974 | * |
||
975 | * @author Tom N Harris <[email protected]> |
||
976 | */ |
||
977 | protected function getIndex($idx, $suffix) { |
||
978 | global $conf; |
||
979 | $fn = $conf['indexdir'].'/'.$idx.$suffix.'.idx'; |
||
980 | if (!file_exists($fn)) return array(); |
||
981 | return file($fn, FILE_IGNORE_NEW_LINES); |
||
982 | } |
||
983 | |||
984 | /** |
||
985 | * Replace the contents of the index with an array. |
||
986 | * |
||
987 | * @param string $idx name of the index |
||
988 | * @param string $suffix subpart identifier |
||
989 | * @param array $lines list of lines without LF |
||
990 | * @return bool If saving succeeded |
||
991 | * |
||
992 | * @author Tom N Harris <[email protected]> |
||
993 | */ |
||
994 | protected function saveIndex($idx, $suffix, &$lines) { |
||
995 | global $conf; |
||
996 | $fn = $conf['indexdir'].'/'.$idx.$suffix; |
||
997 | $fh = @fopen($fn.'.tmp', 'w'); |
||
998 | if (!$fh) return false; |
||
999 | fwrite($fh, join("\n", $lines)); |
||
1000 | if (!empty($lines)) |
||
1001 | fwrite($fh, "\n"); |
||
1002 | fclose($fh); |
||
1003 | if (isset($conf['fperm'])) |
||
1004 | chmod($fn.'.tmp', $conf['fperm']); |
||
1005 | io_rename($fn.'.tmp', $fn.'.idx'); |
||
1006 | return true; |
||
1007 | } |
||
1008 | |||
1009 | /** |
||
1010 | * Retrieve a line from the index. |
||
1011 | * |
||
1012 | * @param string $idx name of the index |
||
1013 | * @param string $suffix subpart identifier |
||
1014 | * @param int $id the line number |
||
1015 | * @return string a line with trailing whitespace removed |
||
1016 | * |
||
1017 | * @author Tom N Harris <[email protected]> |
||
1018 | */ |
||
1019 | protected function getIndexKey($idx, $suffix, $id) { |
||
1020 | global $conf; |
||
1021 | $fn = $conf['indexdir'].'/'.$idx.$suffix.'.idx'; |
||
1022 | if (!file_exists($fn)) return ''; |
||
1023 | $fh = @fopen($fn, 'r'); |
||
1024 | if (!$fh) return ''; |
||
1025 | $ln = -1; |
||
1026 | while (($line = fgets($fh)) !== false) { |
||
1027 | if (++$ln == $id) break; |
||
1028 | } |
||
1029 | fclose($fh); |
||
1030 | return rtrim((string)$line); |
||
1031 | } |
||
1032 | |||
1033 | /** |
||
1034 | * Write a line into the index. |
||
1035 | * |
||
1036 | * @param string $idx name of the index |
||
1037 | * @param string $suffix subpart identifier |
||
1038 | * @param int $id the line number |
||
1039 | * @param string $line line to write |
||
1040 | * @return bool If saving succeeded |
||
1041 | * |
||
1042 | * @author Tom N Harris <[email protected]> |
||
1043 | */ |
||
1044 | protected function saveIndexKey($idx, $suffix, $id, $line) { |
||
1045 | global $conf; |
||
1046 | if (substr($line, -1) != "\n") |
||
1047 | $line .= "\n"; |
||
1048 | $fn = $conf['indexdir'].'/'.$idx.$suffix; |
||
1049 | $fh = @fopen($fn.'.tmp', 'w'); |
||
1050 | if (!$fh) return false; |
||
1051 | $ih = @fopen($fn.'.idx', 'r'); |
||
1052 | if ($ih) { |
||
1053 | $ln = -1; |
||
1054 | while (($curline = fgets($ih)) !== false) { |
||
1055 | fwrite($fh, (++$ln == $id) ? $line : $curline); |
||
1056 | } |
||
1057 | if ($id > $ln) { |
||
1058 | while ($id > ++$ln) |
||
1059 | fwrite($fh, "\n"); |
||
1060 | fwrite($fh, $line); |
||
1061 | } |
||
1062 | fclose($ih); |
||
1063 | } else { |
||
1064 | $ln = -1; |
||
1065 | while ($id > ++$ln) |
||
1066 | fwrite($fh, "\n"); |
||
1067 | fwrite($fh, $line); |
||
1068 | } |
||
1069 | fclose($fh); |
||
1070 | if (isset($conf['fperm'])) |
||
1071 | chmod($fn.'.tmp', $conf['fperm']); |
||
1072 | io_rename($fn.'.tmp', $fn.'.idx'); |
||
1073 | return true; |
||
1074 | } |
||
1075 | |||
1076 | /** |
||
1077 | * Retrieve or insert a value in the index. |
||
1078 | * |
||
1079 | * @param string $idx name of the index |
||
1080 | * @param string $suffix subpart identifier |
||
1081 | * @param string $value line to find in the index |
||
1082 | * @return int|bool line number of the value in the index or false if writing the index failed |
||
1083 | * |
||
1084 | * @author Tom N Harris <[email protected]> |
||
1085 | */ |
||
1086 | protected function addIndexKey($idx, $suffix, $value) { |
||
1087 | $index = $this->getIndex($idx, $suffix); |
||
1088 | $id = array_search($value, $index, true); |
||
1089 | if ($id === false) { |
||
1090 | $id = count($index); |
||
1091 | $index[$id] = $value; |
||
1092 | if (!$this->saveIndex($idx, $suffix, $index)) { |
||
1093 | trigger_error("Failed to write $idx index", E_USER_ERROR); |
||
1094 | return false; |
||
1095 | } |
||
1096 | } |
||
1097 | return $id; |
||
1098 | } |
||
1099 | |||
1100 | /** |
||
1101 | * Get the list of lengths indexed in the wiki. |
||
1102 | * |
||
1103 | * Read the index directory or a cache file and returns |
||
1104 | * a sorted array of lengths of the words used in the wiki. |
||
1105 | * |
||
1106 | * @author YoBoY <[email protected]> |
||
1107 | * |
||
1108 | * @return array |
||
1109 | */ |
||
1110 | protected function listIndexLengths() { |
||
1111 | return idx_listIndexLengths(); |
||
1112 | } |
||
1113 | |||
1114 | /** |
||
1115 | * Get the word lengths that have been indexed. |
||
1116 | * |
||
1117 | * Reads the index directory and returns an array of lengths |
||
1118 | * that there are indices for. |
||
1119 | * |
||
1120 | * @author YoBoY <[email protected]> |
||
1121 | * |
||
1122 | * @param array|int $filter |
||
1123 | * @return array |
||
1124 | */ |
||
1125 | protected function indexLengths($filter) { |
||
1126 | global $conf; |
||
1127 | $idx = array(); |
||
1128 | if (is_array($filter)) { |
||
1129 | // testing if index files exist only |
||
1130 | $path = $conf['indexdir']."/i"; |
||
1131 | foreach ($filter as $key => $value) { |
||
1132 | if (file_exists($path.$key.'.idx')) |
||
1133 | $idx[] = $key; |
||
1134 | } |
||
1135 | } else { |
||
1136 | $lengths = idx_listIndexLengths(); |
||
1137 | foreach ($lengths as $key => $length) { |
||
1138 | // keep all the values equal or superior |
||
1139 | if ((int)$length >= (int)$filter) |
||
1140 | $idx[] = $length; |
||
1141 | } |
||
1142 | } |
||
1143 | return $idx; |
||
1144 | } |
||
1145 | |||
1146 | /** |
||
1147 | * Insert or replace a tuple in a line. |
||
1148 | * |
||
1149 | * @author Tom N Harris <[email protected]> |
||
1150 | * |
||
1151 | * @param string $line |
||
1152 | * @param string|int $id |
||
1153 | * @param int $count |
||
1154 | * @return string |
||
1155 | */ |
||
1156 | protected function updateTuple($line, $id, $count) { |
||
1157 | if ($line != ''){ |
||
1158 | $line = preg_replace('/(^|:)'.preg_quote($id,'/').'\*\d*/', '', $line); |
||
1159 | } |
||
1160 | $line = trim($line, ':'); |
||
1161 | if ($count) { |
||
1162 | if ($line) { |
||
1163 | return "$id*$count:".$line; |
||
1164 | } else { |
||
1165 | return "$id*$count"; |
||
1166 | } |
||
1167 | } |
||
1168 | return $line; |
||
1169 | } |
||
1170 | |||
1171 | /** |
||
1172 | * Split a line into an array of tuples. |
||
1173 | * |
||
1174 | * @author Tom N Harris <[email protected]> |
||
1175 | * @author Andreas Gohr <[email protected]> |
||
1176 | * |
||
1177 | * @param array $keys |
||
1178 | * @param string $line |
||
1179 | * @return array |
||
1180 | */ |
||
1181 | protected function parseTuples(&$keys, $line) { |
||
1182 | $result = array(); |
||
1183 | if ($line == '') return $result; |
||
1184 | $parts = explode(':', $line); |
||
1185 | foreach ($parts as $tuple) { |
||
1186 | if ($tuple === '') continue; |
||
1187 | list($key, $cnt) = explode('*', $tuple); |
||
1188 | if (!$cnt) continue; |
||
1189 | $key = $keys[$key]; |
||
1190 | if ($key === false || is_null($key)) continue; |
||
1191 | $result[$key] = $cnt; |
||
1192 | } |
||
1193 | return $result; |
||
1194 | } |
||
1195 | |||
1196 | /** |
||
1197 | * Sum the counts in a list of tuples. |
||
1198 | * |
||
1199 | * @author Tom N Harris <[email protected]> |
||
1200 | * |
||
1201 | * @param string $line |
||
1202 | * @return int |
||
1203 | */ |
||
1204 | protected function countTuples($line) { |
||
1205 | $freq = 0; |
||
1206 | $parts = explode(':', $line); |
||
1207 | foreach ($parts as $tuple) { |
||
1208 | if ($tuple === '') continue; |
||
1209 | list(/* $pid */, $cnt) = explode('*', $tuple); |
||
1210 | $freq += (int)$cnt; |
||
1211 | } |
||
1212 | return $freq; |
||
1213 | } |
||
1214 | } |
||
1215 |
If a method or function can return multiple different values and unless you are sure that you only can receive a single value in this context, we recommend to add an additional type check:
If this a common case that PHP Analyzer should handle natively, please let us know by opening an issue.