实践中 XunSearch（讯搜）更新索引方案对比

时间：2024-01-01 10:44:57

检测PHP－SDK的运行条件（查看是否支持XunSearch）   $prefix/sdk/php/util/RequiredCheck.php $prefix #替换成你的安装目录

使用 XunSearch（讯搜）有很多种使用方法  和 更新索引的方法；

搜索语法
• 查询语句和流行的搜索引擎相似，通过空格把搜索词、句连接起来即可，字段检索使用 field:XXX 的格式。
• 允许使用 AND/OR/NOT/XOR  等显式地布尔关系组合，可以使用小括号 () 包围表达优先级。
• 支持使用双引号对较长搜索词进行精确匹配，要求字段设计时勾选“精确”项。
   $search->search(‘ 杭州 西湖’); //  搜索同时包含这2个词的结果
   $search->search(‘ 杭州 OR  西湖’); //  搜索包含其中一个词的结果
   $search->search(‘subject:杭州 西湖’); //  包括西湖并且标题包含杭州的结果
获取结果
• 设置数量及偏移
   $search->setLimit(5, 15);  //  设置最多返回 5 条，并跳过前 15 条，即返回第 16-20 条结果
• 获取搜索结果

$docs = $search->setQuery(‘ 测试’)->search();  //  搜索 ‘ 测试’

   foreach ($docs as $doc) {

       $subject = $search->highlight($doc->subject); //  高亮处理标题

       echo $doc->rank() . ‘. ‘ . $subject . ‘ [‘ . $doc->percent() . ‘%] - ‘ . date(‘Y-m-d’) . “n”;

       echo $doc->message . “nn”;

   }

　• 获取搜索结果数量 ( 估算值)

$count = $search->getLastCount(); //  获取最后一次 $search->search()  的匹配数量
   $count = $search->count(‘测试’); //  直接检索包含 ‘ 测试’  的数量　

热门搜索

　　　　通过 XSSearch::getHotQuery  方法获取热门搜索词，返回的数组以关键词为键名，搜索指数为值。

  　　 $words = $search->getHotQuery(); //  获取前 6 个总热门搜索词

  　　 $words = $search->getHotQuery(6, ‘lastnum’); //  获取前 10 个上周热门词

　　相关搜索

　　　　通过 XSSearch::getRelatedQuery  方法获取热门搜索词，返回相关搜索词组成的数组。

   　　$words = $search->getRelatedQuery(); //  获取前 6 个和最近一次 setQuery()  相关的搜索词

   　　$words = $search->getRelatedQuery(‘测试’, 10);  //  获取 10 个和 ‘ 测试’  相关的搜索词

　　　搜索纠错

　　　　由于输入过快或拼音输入中文很容易出现错误，XSSearch::getCorrectedQuery 方法返回纠正后的关键词组成的数组。 　　　　

　　　　$docs = $search->setQuery(‘ 侧试’)->search();  //  正常进行搜索误打的 ‘ 侧试’

   　　  $corrected = $search->getCorrectedQuery(); //  尝试修正

   　　 if (count($corrected) > 0) { // 有修正词则列出

       　　echo “ 您是不是要找：n”;

      　　 foreach ($corredted as $word) echo $word . “n”;

  　　 }　　　 

　　搜索建议

　　　　类似常见搜索引擎那样，当用户在输入框键入少量字、拼音、声母时进行智能补全，可以节省用户的输入时间。

   　　$words = $search->getExpandedQuery(‘c’); //  返回 array(‘ 测试’)

  　　 $words = $search->getExpandedQuery(‘ 测’); //  返回 array(‘ 测试’)

  　　　 $words = $search->getExpandedQuery(‘cs’);  //  返回 array(‘ 测试’)

附加XunSearch搜索结果code

#引入接口文件，其实你懂的，就是一个类

require './lib/XS.php';   //  引入 xunsearch sdk

if(isset($_POST['sub']) && $_POST['keyword'] != ''){

     $keyword = trim($_POST['keyword']);    //接收关键词

     $xs = new XS('source');    // demo  为项目名称，配置文件是：$sdk/app/demo.in i

      //$index = $xs->index;   //  获取索引对象

      $search = $xs->search;   //  获取搜索对象

      $search->setLimit(20);

      $docs = $search->setQuery( $keyword)->search();  //  搜索 ‘ 测试’

     echo "<table border='1' bordercolor='green' cellspacing='0'><tr><th>标题</th></tr>";

      foreach ($docs as $doc) {

               $subject = $search->highlight($doc->product_name); //  高亮处理标题

            echo "<tr><td>".$subject."</td></tr>";

      }

       echo "</table>";  

     // $search->setQuery($keyword);

     // 获取前 6 个和默认搜索语句 "西湖" 相关搜索词

    // $words = $search->getRelatedQuery();

    // print_r($words);

最常见的就有批量更新和增量更新索引，话不多说，直接看代码；

＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝   单独更新索引  ＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝

1－  添加文档   （就是直接添加单条数据记录到索引库中）

$xs = new XS('njw');
$index = $xs->index;

$data = array(

'pid' => 234, // 此字段为主键，必须指定

'subject' => '测试文档的标题',

'message' => '测试文档的内容部分',

'chrono' => time()

);

//创建文档对象

$doc = new XSDocument;

$doc->setFields($data);

​//添加到索引数据库中

$index->add($doc);

　　

2－ 更新文档 （其中$data里必须包含有主键字段，这样索引库才会被更新成功）

$xs = new XS('njw');

$index = $xs->index;

$data = array(

'pid' => 234, // 此字段为主键，必须指定

'subject' => '测试文档的标题',

'message' => '测试文档的内容部分',

'chrono' => time()

);

//创建文档对象

$doc = new XSDocument;

$doc->setFields($data);

//更新到索引数据库中

$index->update($doc);

附加其它索引操作说明：
   $index->add($doc);  //  添加文档，不检测便索引库内是否已有同一主键数据
   $index->update($doc); //  更新文档，若有同主键数据则替换之
   $index->del(‘123’); //  删除主键值为 234 的文档
   $index->del(array(‘123’,‘456’)); //  删除主键值为 123 及 456 的文档




　　


＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝  批量更新  ＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝


3－ 平滑批量重建更新索引 （批量更新索引，）




header('Content-Type:text/html;charset=utf-8;');

require_once '../../../local/xunsearch/sdk/php/lib/XS.php';

include "./mysql_conn.php";

try{

$xs = new XS('njw');

//平滑重建索引

//宣布开始重建索引

$xs->index->beginRebuild();

$sql = "select g.id id,g.title title,g.norms norms,i.picture picture from b2b_goods g INNER JOIN b2b_goods_images i ON g.id=i.goods_id limit";

$result = $db->query($sql);

while( $row = $result -> fetch_assoc ()) {

$doc = new XSDocument;

$doc->setFields($row);

//添加到索引数据库中

$xs->index->add($doc);

$xs->index->update($doc);

}

//告诉服务器重建索引完成

$xs->index->endRebuild();

}catch(XSException $e){

echo $e;

}





　　


4 － 使用缓冲区批量重建更新索引 （批量更新操作）




header('Content-Type:text/html;charset=utf-8;');

require_once '../../../local/xunsearch/sdk/php/lib/XS.php';

include "./mysql_conn.php";

try{

    $xs = new XS('njw');

    //使用索引缓冲区

    $xs->index->openBuffer();

    $sql = "select g.id id,g.title title,g.norms norms,i.picture picture from b2b_goods g INNER JOIN b2b_goods_images i ON g.id=i.goods_id";

    $result = $db->query($sql);

    while( $row = $result -> fetch_assoc ()) {

        $doc = new XSDocument;

        $doc->setFields($row);

        //添加到索引数据库中

        $xs->index->add($doc);

        $xs->index->update($doc);

    }

    //告诉服务器重建索引完成

    $xs->index->closeBuffer();

}catch(XSException $e){

    echo $e;

}





　　


清空索引和索引同步


当搜索字段文件变更或出现严重不同步时，建议清空索引。




 // 当搜索字段文件变更或出现严重不同步时，建议清空索引。

 $index->clean(); //  一执行立即生效

索引同步

出于性能优化设计，上面所看到的索引操作都是异步操作。也就是说您通过 PHP  调用的 API 返回后，索引变动是先保存在服务端的队列中，由服务端根据负荷延迟一并写入索引库。这个时间差我们控制在合理范围内，通常是几秒钟时间。但如果您在批量更新后希望立即同步，可以这样：

$index->flushIndex();





　　
相关文章