函式名稱:SolrQuery::setHighlight()
函式描述:設定 Solr 查詢物件的高亮引數
適用版本:Solr 4.0.0 以上版本
用法:
public SolrQuery SolrQuery::setHighlight ( bool $flag )
引數:
- $flag: 一個布林值,用於指定是否啟用高亮,預設為 false。
返回值:
- 返回一個 SolrQuery 物件,用於鏈式呼叫其他 SolrQuery 方法。
示例:
// 建立 Solr 查詢物件
$query = new SolrQuery();
// 啟用高亮
$query->setHighlight(true);
// 設定高亮欄位
$query->setHighlightFields('title, content');
// 設定高亮的字首和字尾
$query->setHighlightSimplePre('<em>');
$query->setHighlightSimplePost('</em>');
// 設定高亮的片段大小
$query->setHighlightFragsize(100);
// 設定高亮的最大片段數
$query->setHighlightSnippets(3);
// 執行查詢
$response = $client->query($query);
// 獲取高亮結果
$highlighting = $response->getHighlighting();
注意事項:
- 在呼叫 SolrQuery::setHighlight() 方法之前,需要先建立一個 SolrQuery 物件,並透過 Solr 客戶端執行查詢。
- 在啟用高亮之後,還需要使用其他相關方法來設定高亮的欄位、字首、字尾、片段大小和最大片段數等引數。
- 最後,透過 SolrResponse 物件的 getHighlighting() 方法可以獲取到高亮結果。