函式名稱:SolrQuery::setHighlightFormatter()
函式描述:設定Solr查詢的高亮顯示格式化器。
適用版本:此函式適用於Solr PHP擴充套件的所有版本。
用法:
SolrQuery::setHighlightFormatter( string $formatter [, string $field_override ] ) : SolrQuery
引數:
$formatter
:要使用的高亮顯示格式化器的名稱。可選值有:"simple"、"html"、"regex"和"none"。對於自定義格式化器,可以傳遞格式化器類的名稱。$field_override
:要覆蓋的欄位名稱(可選)。如果提供了此引數,則使用指定的欄位名稱進行高亮顯示,而不是使用Solr查詢中定義的欄位。
返回值:返回SolrQuery物件本身,以便支援方法鏈。
示例:
$query = new SolrQuery("php"); // 建立一個Solr查詢物件
$query->setHighlight(true); // 開啟高亮顯示
// 設定高亮顯示格式化器為"html",覆蓋欄位為"title"
$query->setHighlightFormatter("html", "title");
// 執行查詢
$response = $client->query($query);
// 獲取高亮顯示結果
$highlighting = $response->getHighlighting();
$highlightedTitle = $highlighting["doc_id"]["title"][0];
echo "高亮顯示的標題:$highlightedTitle";
在上面的示例中,我們首先建立了一個Solr查詢物件,並設定查詢關鍵字為"php"。然後,我們開啟了高亮顯示功能,並使用setHighlightFormatter()
函式將高亮顯示格式化器設定為"html"。我們還使用setHighlightFormatter()
函式的第二個引數,將要覆蓋的欄位設定為"title"。最後,我們執行查詢,並從響應中獲取高亮顯示結果。最終,我們將高亮顯示的標題列印出來。