PHP XunSearch基本使用

image

基本实践

<?php
// 引入
require_once './sdk/xs/lib/XS.php';

// 创建对象
$xs = new XS('demo');

// 查询
$docs = $xs->search->search('测试');

// 输出
print_r($docs);

异常捕获

try
{
    $xs = new XS('demo');
    $docs = $xs->search->setQuery('测试')->setLimit(5)->search();
    foreach ($docs as $doc)
    {
        echo $doc->rank() . ". " . $doc->subject . " [" . $doc->percent() . "%]\n";
        echo $doc->message . "\n";
    }
}
catch (XSException $e)
{
    echo $e;               // 直接输出异常描述
    if (defined('DEBUG'))  // 如果是 DEBUG 模式，则输出堆栈情况
        echo "\n" . $e->getTraceAsString() . "\n";
}

XSDocument 文档

docid() 取得搜索结果文档的 docid 值 (实际数据库内的 id，一般用不到)
rank() 取得搜索结果文档的序号值 (第X条结果)
percent() 取得搜索结果文档的匹配百分比 (结果匹配度, 1~100)
weight() 取得搜索结果文档的权重值 (浮点数)
ccount() 取得搜索结果折叠的数量 (按字段折叠搜索时才有效)

添加操作

<?php
// 引入
require_once './sdk/xs/lib/XS.php';

try
{
    $xs = new XS('demo');
    $doc = new XSDocument();
    $doc->pid = 4;
    $doc->subject = "Hello,XS";
    $doc->message = "Hello,XS内容";
    $xs->index->add($doc);
}
catch (XSException $e)
{
    echo $e;               // 直接输出异常描述
    if (defined('DEBUG'))  // 如果是 DEBUG 模式，则输出堆栈情况
        echo "\n" . $e->getTraceAsString() . "\n";
}

<?php
// 引入
require_once './sdk/xs/lib/XS.php';

try
{
    $xs = new XS('demo');
    $doc = new XSDocument();
    $doc['pid'] = 5;
    $doc['subject'] = "Hello,XS";
    $doc['message'] = "Hello,XS内容";
    $xs->index->add($doc);
}
catch (XSException $e)
{
    echo $e;               // 直接输出异常描述
    if (defined('DEBUG'))  // 如果是 DEBUG 模式，则输出堆栈情况
        echo "\n" . $e->getTraceAsString() . "\n";
}

<?php
// 引入
require_once './sdk/xs/lib/XS.php';

try
{
    $xs = new XS('demo');
    $doc = new XSDocument();
    $doc ->setFields([
        'pid' => 6,
        'subject' => "Hello,XS",
        'message' => "Hello,XS内容"
    ]);

    $xs->index->add($doc);
}
catch (XSException $e)
{
    echo $e;               // 直接输出异常描述
    if (defined('DEBUG'))  // 如果是 DEBUG 模式，则输出堆栈情况
        echo "\n" . $e->getTraceAsString() . "\n";
}

建立索引的过程会有点延迟！

$index->add($doc)->flushIndex()

可以临时处理成同步的。

ini

string 字符型，适用多数情况，也是默认值
numeric 数值型，包含整型和浮点数，仅当字段需用于以排序或区间检索时才设为该类型，否则请使用 string　即可
date 日期型，形式为 YYYYmmdd 这样固定的 8 字节，如果没有区间检索或排序需求不建议使用
id 主键型，确保每条数据具备唯一值，是索引更新和删除的凭据，每个搜索项目必须有且仅有一个 id 字段，该字段的值不区分大小写
title 标题型，标题或名称字段，至多有一个该类型的字段
body 内容型，主内容字段, 即本搜索项目中内容最长的字段，至多只有一个该类型字段，本字段不支持字段检索

type = string
project.name = sample
project.default_charset = GBK
;server.index = 8383
;server.search = 8384

[pid]
type = id

[subject]
type = title

[message]
type = body

[dateline]
type = numeric

[author]
index = both

[authorid]

[tid]
index = self
tokenizer = full

[fid]
index = self
tokenizer = full

[flag]

更新、修改文档

如果索引数据库中已存在主键值相同的文档，那么相当于先删除原有的文档，再用当前文档替换它。 如果未存在主键值相同的文档，则效果和添加文档完全一致。

<?php
// 引入
require_once './sdk/xs/lib/XS.php';

$xs = new XS('my');
$data = array(
    'pid' => 2, // 此字段为主键，是进行文档替换的唯一标识
    'subject' => '测试文档的标题',
    'message' => '测试文档的内容部分',
    'chrono' => time()
);

// 创建文档对象
$doc = new XSDocument;
$doc->setFields($data);

// 更新到索引数据库中
$xs->index->update($doc)->flushIndex();

删除文档

1.按主键删除

<?php
// 引入
require_once './sdk/xs/lib/XS.php';

// 创建xs
$xs = new XS('my');
// 创建index
$index = $xs->index;
// 删除
$index->del('1')->flushIndex();

// 删除
$index->del(['4','5'])->flushIndex();

2.按内容删除

<?php
// 引入
require_once './sdk/xs/lib/XS.php';


$xs = new XS('my');

// 创建xs
$xs = new XS('my');
// 创建index
$index = $xs->index;
// 删除
$index->del('测试','subject')->flushIndex();

此外删除操作和添加文档一样，也是一个异步行为。

清空索引

// 创建xs
$xs = new XS('my');
// 创建index
$index = $xs->index;
// 删除
$index->clean();

平滑重建索引

<?php
// 引入
require_once './sdk/xs/lib/XS.php';

// 创建xs
$xs = new XS('my');
// 创建index
$index = $xs->index;
// 宣布开始重建索引
$index->beginRebuild();

// 然后在此开始添加数据
$data = array(
    'pid' => 2, // 此字段为主键，是进行文档替换的唯一标识
    'subject' => '测试文档的标题',
    'message' => '测试文档的内容部分',
    'chrono' => time()
);

// 创建文档对象
$doc = new XSDocument;
$doc->setFields($data);

$index->add($doc);


// 告诉服务器重建完比
$index->endRebuild();

使用索引缓冲区

一次性提交服务操作

<?php
// 引入
require_once './sdk/xs/lib/XS.php';

// 创建xs
$xs = new XS('my');
// 创建index
$index = $xs->index;

// 开启缓冲区，默认 4MB，如 $index->openBuffer(8) 则表示 8MB
$index->openBuffer();

// 然后在此开始添加数据
$data = array(
    'pid' => 2, // 此字段为主键，是进行文档替换的唯一标识
    'subject' => '测试文档的标题',
    'message' => '测试文档的内容部分',
    'chrono' => time()
);

// 创建文档对象
$doc = new XSDocument;
$doc->setFields($data);
// 在此进行批量的文档添加、修改、删除操作
$index->add($doc);
$index->add($doc);
$index->add($doc);
$index->add($doc);
$index->add($doc);
$index->add($doc);


$index->closeBuffer(); // 关闭缓冲区，必须和 openBuffer 成对使用

自定义 SCWS 词库

1.全局自定义词库

$prefix/etc/dict_user.txt

# Custom dictionary for scws (UTF-8 encoding)
# 每行一条记录，以 # 开头的号表示注释忽略
# 每行最多包含 4 个字段，依次代表 "词条" "TF" "IDF" "词性"
# 字段之间用空格或制表符分开，特殊词性 "!" 用于表示删除该词
# 参见 scws 自定义词典帮助：
# http://bbs.xunsearch.com/showthread.php?tid=1303
# $Id$
#
# WORD      TF      IDF     ATTR
# ------------------------------------------------------

2.项目自定义词库（这个貌似更好的读取）

$prefix/data/项目名称/dict_user.txt

转载https://www.cnblogs.com/jiqing9006/p/9254726.html
手册https://api.yuhal.com/file/xs_php_manual.chm

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成，浏览时请结合常识与多方信息审慎甄别。
平台声明：文章内容（如有图片或视频亦包括在内）由作者上传并发布，文章内容仅代表作者本人观点，简书系信息发布平台，仅提供信息存储服务。

相关阅读更多精彩内容

  • oracle错误集合
    ORA-00001: 违反唯一约束条件 (.) 错误说明：当在唯一索引所对应的列上键入重复值时，会触发此异常。 O...
    我想起个好名字阅读 11,008评论 0赞 9
  • 第五章 索引与算法 阅读总结
    索引是应用程序设计和开发的一个重要方面。 若索引太多， 应用程序的性能可能会受到影响。 而索引太少， 对查询性能又...
    好好学习Sun阅读 4,695评论 0赞 4
  • MySQL—day3（使用）
    一、 列属性 真正的对列的约束是依赖于数据的类型，但是这种约束比较单一，所以需要更多的约束，整个时候就是用到了字段...
    致自己_cb38阅读 3,214评论 0赞 0
  • 香樟
    香樟是我很喜欢的植物之一，在上海也比较常见，几乎所有的大学都会有香樟，马路也会有，当然以前发租界区域会以法国梧桐为...
    小草在成长Anna阅读 1,283评论 0赞 1
  • "摄影就是用光的艺术"——光位
    光位是指光源相对于被摄体的位置,即光线的方向与角度。 光位是摄影用光中需要考虑的重要环节。不同光位的造型效果和质感...
    胡子拉碴的菇凉阅读 7,190评论 0赞 0

友情链接更多精彩内容