SphinxClient::buildExcerpts
(PECL sphinx >= 0.1.0)
SphinxClient::buildExcerpts — Build text snippets
说明
public SphinxClient::buildExcerpts
( array
$docs
, string $index
, string $words
[, array $opts
] ) : arrayConnects to searchd, requests it to generate excerpts (snippets) from the given documents, and returns the results.
参数
-
docs -
Array of strings with documents' contents.
-
index -
Index name.
-
words -
Keywords to highlight.
-
opts -
Associative array of additional highlighting options (see below).
| Option | Description |
|---|---|
| "before_match" | A string to insert before a keyword match. Default is "<b>". |
| "after_match" | A string to insert after a keyword match. Default is "</b>". |
| "chunk_separator" | A string to insert between snippet chunks (passages). Default is " ... ". |
| "limit" | Maximum snippet size, in symbols (codepoints). Integer, default is 256. |
| "around" | How much words to pick around each matching keywords block. Integer, default is 5. |
| "exact_phrase" | Whether to highlight exact query phrase matches only instead of
individual keywords. Boolean, default is FALSE. |
| "single_passage" | Whether to extract single best passage only. Boolean, default is FALSE. |
返回值
Returns array of snippets on success 或者在失败时返回 FALSE.