windsearch是一个基于中文分词,由纯php开发全文检索引擎,可快速搭建php站点的站内搜索,他没有任何繁琐的安装配置、不需要维护调优、不占用服务器内存、可与php项目完美融合在一起。
github地址:github.com/rock365/windsearch
必须极速安装~
使用composer安装:
composer require rock365/windsearch
或 使用git安装:
git clone git@github.com:rock365/windsearch.git
或 直接前往github: github.com/rock365/windsearch
还配置啥,立即开始用吧!
windsearch包含即用模式、专业模式,即用模式适合简单搜索场景,专业模式支持复杂搜索。
即用模式
“即用模式”可以立即导入数据,无任何配置,支持int主键、uuid主键,适合简单的搜索场景。即用模式的各种api均有fast
关键字。
“即用模式”的原理:对字符串进行ngram分词,搜索的结果是主键集合,你可以使用这些集合从mysql等数据库查询原始数据。
引入文件:
windsearch安装完成后,引入入口文件,注意具体文件路径
require_once 'yourdirname/vendor/autoload.php';
导入数据
// 实例化对象 $wind = new \windsearch\index\wind('test'); //test 当前索引库的名称 // 清空之前的数据(如果之前使用即用模式导入过数据) $wind->deletefastindex(); // 批次导入数据 // $res 是从数据库查询的数据 foreach($res as $v){ $text = $v['title']; $primarykey = $v['id']; // $text是需要搜索的具体内容,比如title;$primarykey是主键值,比如id的值 $wind->fastindexer($text, $primarykey); } //每导入一批数据,就调用此方法进行保存 $wind->fastbatchwrite(); // 所有数据全部导入完成后,接着构建索引(不一定非得紧接着调用,也可以在其它地方单独调用) $wind->fastbuildindex();
开始搜索
// 开始搜索 $wind = new \windsearch\index\wind('test'); // 调用搜索方法 // $page 第几页 $listrows 每页多少条 $res = $wind->fastsearch($text,$page,$listrows) // $res:返回的主键(比如id)集合,你可以使用id集合从mysql等数据库查询原始数据
每个索引库都可以使用即用模式导入数据,数据单独存放,跟专业模式的数据不冲突,由于即用模式属于某个索引库的下属模块,所以删除某个索引库时,同样会删除即用模式的索引数据,所以一个索引库名称尽量只使用一种模式。
注意,即用模式的搜索效果可能比不上专业模式,可根据情况作出取舍。
专业模式
(专业的部分配合文档使用更佳)
引入文件:
windsearch安装完成后,引入入口文件,注意具体文件路径
require_once 'yourdirname/vendor/autoload.php';
建索引库:
复制修改粘贴即可,跟mysql建表差不多
$mapping = [ //设置索引库的名称,比如对应的表名 'name' => 'test', // 字段配置 'field' => [ [ 'name' => 'id',// 主键名称 主键必须设置 'type' => 'primarykey', //数据类型为主键 必须设置 'primarykey_type' => 'int_incremental', // int递增 ], [ 'name' => 'title', 'index' => true, // 是否索引此字段 'type' => 'text', 'analyzer' => 'segment', // 配置分词方式 ], [ 'name' => 'tags', 'index' => true, 'type' => 'keyword', ] [ 'name' => 'score', 'type' => 'numeric', ], [ 'name' => 'time', 'type' => 'date' ], [ 'name' => 'descr', 'type' => 'text', ], ] ]; // 实例化对象 $wind = new \windsearch\index\wind('test'); //test 当前索引库的名称 //检查是否存在此索引库 $is_index = $wind->checkindex(); // 如果存在此索引库 if ($is_index) { //删除索引库 $wind->delindex(); } //创建索引库 $wind->createindex($mapping);
导入数据:
//实例化引擎 $wind = new \windsearch\index\wind('test'); // 初始化 $wind->buildindexinit(); // 开启分词,导入数据时,加true可加快速度 $wind->loadanalyzer(true); // 数据量小(内容少于一万条),则可以一次性全部导入 // selectall... // $result:一次性查询的所有内容 foreach ($result as $v) { $wind->indexer($v); } // 批量写入文件保存 $wind->batchwrite();
构建索引:
// 数据导入结束后,接着可立即调用此方法构建索引 // 注意,数据量大时,此步骤会比较耗时 $wind->buildindex();
开始搜索:
//实例化引擎 $wind = new \windsearch\index\wind('test'); //开启分词功能 $wind->loadanalyzer(); //开始搜索 // 搜索单个字段 $query = [ 'match' => [ 'field' => [ 'name' => 'title', 'query' => $text, ], 'list_rows' => $listrows, //每页多少条数据 'page' => $page, //第几页 ] ]; // 搜索接口 $res = $wind->search($query, $page, $listrows); // 返回的最终结果,可直接渲染到前台页面 $resarr = $res['result']['_source'];
以上就是php windsearch实现站内搜索功能的详细内容,更多关于php windsearch站内搜索的资料请关注代码网其它相关文章!
发表评论