Failed Conditions
Push — travis-php74 ( 84311c...10ffd5 )
by Henry
02:57
created

inc/Search/Indexer.php (17 issues)

Upgrade to new PHP Analysis Engine

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
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.

Loading history...
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.

Loading history...
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.

Loading history...
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.

Loading history...
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.

Loading history...
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.

Loading history...
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.

Loading history...
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.

Loading history...
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.

Loading history...
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.

Loading history...
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.

Loading history...
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.

Loading history...
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.

Loading history...
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.

Loading history...
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.

Loading history...
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.

Loading history...
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
Bug Compatibility introduced by
The expression $this->addIndexKey('page', '', $page); of type false|integer|string adds the type string to the return on line 566 which is incompatible with the return type documented by dokuwiki\Search\Indexer::getPIDNoLock of type boolean|integer.
Loading history...
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