被讯搜虐得怀疑人生?这份笔记教你正确打开方式

Xunsearch (中文名:迅搜)是一套免费开源的专业中文全文检索解决方案,简单易用而且性能卓越能轻松处理海量数据的全文检索。它包含后端索引、搜索服务程序和前端脚本语言编写的开发工具包(称之为 SDK) 。本人看来,讯搜底层采用 C/C++ 编写,性能上不用怀疑,说到功能强大嘛。。恩,先保留着吧(毕竟现在有个如日中天的Elasticsearch),迅搜对比起es虽然功能上着实不够看,且分布式支持方面也不怎么样,客户端也主要面向PHP。。但凡是也有例外,在资源占用低和容易上手方面还是有一定突出优势的(es在资源使用方面就是个吃货呀),可以作为其他搜索引擎如es、solr等的补充。在此,总结一下迅搜的一些简单用法。

1。安装

建议使用centos,其他的debian类系统也行,在下也用deepin装过,被两个依赖虐了半天,记得是因为我的系统openssl软件版本高了,要卸了装个低一点的,哎,不提了。

步骤:

wget http://www.xunsearch.com/download/xunsearch-full-latest.tar.bz2

tar -xjf xunsearch-full-latest.tar.bz2

cd xunsearch-full-1.3.0/

sh setup.sh

装完后,cd 到你的安装目录里(一般是/usr/local/xunsearch) ,运行 bin/xs-ctl.sh restart 就OK了。

2.PHP-sdk

安装目录里有个叫sdk的,如下:

直接拿过来放到你的项目里吧。

如果您的搜索应用程序和 xunsearch 在同一台服务器,则无需复制任何代码,在开发的时候直接包含 入口文件 $prefix/sdk/php/lib/XS.php 即可。代码如下:

require_once '$prefix/sdk/php/lib/XS.php';

$prefix 是你的项目目录。

3.创建配置文件,导入数据

vim $prefix/sdk/php/app/demo.ini (这创建了个demo索引文件),默认连接本地的8383/8384端口并使用urf8编码,包含 id,category_id,name,content,addtime 5个字段。

索引文件代码

导入 MySQL 数据库的 dbname.tbl_post 表到 demo 项目中,并且平滑重建

Indexer.php --rebuild --source=mysql://root:s2mptBWWtpThaTR7@localhost/dbname --sql="SELECT * FROM tbl_post" --project= demo

这里屏幕会提示如下信息,表示完成数据提交:

INFO: reach end of file or error occured, total lines: 3

完成索引导入:成功 3 条,失败 0 条

刷新索引提交 ...

索引数据的提交是异步行为,所以录完数据并不是立刻就能检索到(当然,这个时间差也不会太大)。 所以为稳定起见请稍等几秒再进行下一步的搜索测试。

4. 写代码

1)添加文档

$data = array(

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

‘category_id’ =》6, //可用于聚合搜索

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

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

'addtime' => time()

);

// 创建文档对象,

$doc = new XSDocument;

$doc->setFields($data);

// 添加到索引数据库中$index->add($doc);

2)修改文档

$data = array(

'id' => 234, // 此字段为主键,是进行文档替换的唯一标识

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

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

'addtime' => time());

// 创建文档对象,

$doc = new XSDocument;

$doc->setFields($data);

// 更新到索引数据库中,

$index->update($doc);

3)删除文档

$index->del('123'); // 删除主键值为 123 的记录

$index->del(array('123', '789', '456'));

// 同时删除主键值为 123, 789, 456 的记录

4)搜索

流程:

构建搜索查询语句 query,然后调用 XSSearch::setQuery 设定它,根据需要设置附加的查询条件:通过 XSSearch::addWeight 干扰排名权重; 通过 XSSearch::addRange 添加字段搜索区间或范围; 通过 XSSearch::setFuzzy 开启模糊匹配,以获取更多搜索结果;进行必要的搜索结果限定:通过 XSSearch::setLimit 设置搜索结果数量和偏移;通过 XSSearch::setSort 设置搜索结果的排序方式,等等。执行搜索,并获取搜索结果,关于搜索结果的处理详见后面的章节

代码如下:

$query = '项目测试'; // 这里的搜索语句很简单,就一个短语

$search->setQuery($query); // 设置搜索语句

$search->addWeight('subject', 'xunsearch'); // 增加附加条件:提升标题中包含 'xunsearch' 的记录的权重

$search->setLimit(5, 10); // 设置返回结果最多为 5 条,并跳过前 10 条

$docs = $search->search(); // 执行搜索,将搜索结果文档保存在 $docs 数组中$count = $search->count(); // 获取搜索结果的匹配总数估算值

搜索中的串联操作

$docs = $search->setQuery('项目测试')->addWeight('subject', 'xunsearch')->setLimit(5, 10)->search();

构建搜索语句

搜索语句举例如下:

$search->search('上海人民公园'); // 检索 body 型字段及混合区

$search->search('上海 人民公园'); // 用空格连接 2 个关键词, 这种情况比上面的用法更明确

$search->search('subject:上海 人民公园'); // 特别要求 subject 字段包含 "上海"

$search->setFuzzy()->search('上海公园'); // 开启模糊搜索,搜索 "上海" 或 "公园"

多个词语之间的“并且”、“或者”、“异或”关系

默认情况,系统采用“并且”关系,即您输入的多个词语(空格分开或系统自动切分以后)必须全部包含。 您也可以通过 AND 将这些关键词显式的强制要求全部出现。相应的,如果您需要只包括其中一个词即可, 那么用 OR 将它们连接起来。更有趣的是,如果有些情况您只想要其中的一个词,并且不要两者同时出现, 那么就用 XOR 连接。参看下面的例子:

Note: 表达布尔关系的关键字必须全部大写,即:XOR, OR, AND

$search->search('杭州 西湖');

$search->search('杭州 AND 西湖'); // 这两者效果是相同的

$search->setFuzzy()->search('杭州 西湖');

$search->search('杭州 OR 西湖'); // 这两者效果相同,都是只要求匹配其中一个

要求搜索结果中不含特定关键词

如果您发现搜索结果中,有某一类信息是您不希望看见的,而且这些信息都包含特定的关键词,那么请用减号或 NOT 语法,就可以去除所有这些含有特定关键词的网页。例如,搜索 “神雕侠侣”,希望是关于武侠小说方面 的内容,却发现很多关于电视剧方面的网页。这时希望排除所有包含“电视剧”的搜索结果。

Note: 前一个关键词和减号之间必须有空格分开,否则会被当连字符处理,减号和后一个关键词之间不能有空格。

$search->search('神雕侠侣 -电视剧'); // 正确用法1

$search->search('神雕侠侣 NOT 电视剧'); // 正确用法2

$search->search('神雕侠侣-电视剧'); // 不符合预期目的

$search->search('神雕侠侣 - 电视剧'); // 不符合预期目的

$search->search('杭州 XOR 西湖'); // 表示必须包含其中一个词,并且不允许同时包含这两个词。

这里就不再累述了,更多的请看

http://www.xunsearch.com/doc/php/guide/search.query

最后送上一个自己封装的小函数:


//搜索名称函数,包含分页,限制数量,排序,字段值区间搜索

function demo_xun($name ='',$limit=6,$p = 1,$sort=[],$range=[]){

 // include '/usr/local/xunsearch/sdk/php/lib/XS.php'; //如果找不到迅搜对象可以打开这句

  $xs = new \XS('demo');

  $search = $xs->search;

  $search->setCharset('UTF-8');

  $search->setFuzzy();

  $search->setQuery($name);

  if(!empty($sort)){

    $search->setMultiSort($sort);

  }

  if($p!=1){

    $p = max(1, intval($p));

    $search->setLimit($limit, ($p - 1) * $limit);

  }else{

    $search->setLimit($limit);

  }

  if(empty($range)){

    $info = $search->search();

  }else{

    $info = $search->addRange($range[0], $range[1], $range[2])->search();

  }

  $data = [];

  if($info){

      foreach($info as $v){

          $data[] = [

              'id'=>$v->id,

              'category_id'=>$v->category_id,

              'name'=>$v->name,

              'content'=>$v->content,

              'addtime'=>$v->addtime

          ];

      }

  }

  return $data;

}


至此,迅搜的基本操作就介绍得差不多了,以后还会有其他技术笔记分享给大家,请期待。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,311评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,339评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,671评论 0 342
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,252评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,253评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,031评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,340评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,973评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,466评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,937评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,039评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,701评论 4 323
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,254评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,259评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,485评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,497评论 2 354
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,786评论 2 345