1. 运行下面指令下载、解压安装包
wget http://www.xunsearch.com/download/xunsearch-full-latest.tar.bz2
tar -xjf xunsearch-full-latest.tar.bz2
2.执行安装脚本,根据提示进行操作,主要是输入 xunsearch
软件包的安装目录,强烈建议单独 规划一个目录,而不是混到别的软件目录中。
cd xunsearch-full-1.3.0/
sh setup.sh
+=================================================+
| Installation completed successfully, Thanks you |
| 安装成功,感谢选择和使用 xunsearch |
+-------------------------------------------------+
| 说明和注意事项: |
| 1. 开启/重新开启 xunsearch 服务程序,命令如下: |
| /usr/local/xunsearch/bin/xs-ctl.sh restart
| 强烈建议将此命令写入服务器开机脚本中 |
| |
| 2. 所有的索引数据将被保存在下面这个目录中: |
| /usr/local/xunsearch/data
| 如需要转移到其它目录,请使用软链接。 |
| |
| 3. 您现在就可以在我们提供的开发包(SDK)基础上 |
| 开发您自己的搜索了。 |
| 目前只支持 PHP 语言,参见下面文档: |
| /usr/local/xunsearch/sdk/php/README
+=================================================+
3.待命令运行结束后,如果没有出错中断,则表示顺利安装完成,然后就可以启动/重新启动 xunsearch
的后台服务,下面命令中的 $prefix
请务必替换为您的安装目录,而不是照抄。
cd $prefix ; bin/xs-ctl.sh restart
Info: 出于性能和多数需求考虑
xunsearch
服务端和 SDK API 通讯时没有加密和验证处理, 并且默认情况xs-ctl.sh
启动的服务程序是绑定并监听在127.0.0.1
上。如果您的 SDK 调用和
xunsearch
服务端不在同一服务器,请使用 -b inet 方式启动脚本, 并注意借助类似iptables
的防火墙来控制xunsearch
的8383/8384
两个端口的访问权限。 启动脚本用法举例如下,以下均为合法使用方式:bin/xs-ctl.sh -b local start // 监听在本地回环地址 127.0.0.1 上 bin/xs-ctl.sh -b inet start // 监听在所有本地 IP 地址上 bin/xs-ctl.sh -b a.b.c.d start // 监听在指定 IP 上 bin/xs-ctl.sh -b unix start // 分别监听在 tmp/indexd.sock 和 tmp/searchd.sock
强烈建议您将此命令添加到开机启动脚本中,以便每次服务器重启后能自动启动搜索服务程序, 在 Linux
系统中您可以将脚本指令写进 /etc/rc.local
即可。
有必要指出的是,关于搜索项目的数据目录规划。搜索系统将所有数据保存在 $prefix/data
目录中。 如果您希望数据目录另行安排或转移至其它分区,请将 $prefix/data
作为软链接指向真实目录。
4.php /usr/local/xunsearch/sdk/php/util/RequiredCheck.php检查当前环境是否允许使用xunsearch
5.thinkphp5 把源码/usr/local/xunsearch/sdk/php/ 复制到vendor 重新命名xun
引入
配置文件在迅搜的sdk下的 /app/ demo.ini
可以配置多个搜索文件 ,后缀已ini 结尾参考以下链接
http://www.xunsearch.com/tools/iniconfig
----搜索
vendor("xun.lib.XS");
// 创建 XS 对象,关于项目配置文件请参见官网
$xs = new \XS('demo');
$search = $xs ->search; // 获取搜索对象
$search->setLimit(10);
// $docs = $search->setQuery( $keyword)->search(); // 搜索 ‘ 测试’
$docs = $search->setFuzzy()->search('水电费'); // 搜索 ‘ 测试’
----添加搜索
$xs = new \XS ('demo') ; // 创建 XS 对象,项目名称为:demo
$index = $xs ->index ; // 获取索引对象
$data = array(
'pid' => 3, // 此字段为主键,必须指定
'subject' => '是懂法守法为第三方',
'message' => '大范甘迪发鬼地方电费水电费',
'chrono' => time(),
);
// 创建文档对象
$doc = new \XSDocument;
// dump($doc);
$doc->setFields($data);
// 添加到索引数据库中
$a = $index->add($doc);
官方文档:
http://www.xunsearch.com/doc/php/guide/start.installation
w3c school
https://www.w3cschool.cn/xunsearch/jswpce.html