浅谈xunsearch、mysql使用及错误总结

使用mysql数据库作为数据源时，xunsearch出错，总结。

我的项目名称为sssde，配置文件sssde.ini如下：

project.name = sssdeproject.default_charset = utf-8server.index = 8383server.search = 8384[ssid]type = id[subject]type = title

建立索引的语句（我是使用util/Indexer.php建立索引的）：util/Indexer.php  项目名   --source=mysql://mysql用户名:访问密码@ip地址:端口号/databaseName  --sql='select  字段名   from  表名'    --clean   --rebuild

例如我的项目名为"sssde"，数据库为本地数据库，mysql用户名和密码为"root",“root”，databasename为GPuser，那么我的语句就是：

util/Indexer.php sssde   --source=mysql://root:root@localhost/GPuser/ --sql='select uid,unickname from user_base'  --clean

注意：

--clean是指先清空原来的索引再建立索引

--rebuild是指重建索引

使用上面的建立索引命令，需要先进入的“根目录/sdk/php”文件夹下。

错误一    Missing value of primary key (FIELD:ssid)

这句是指建立索引时，缺少主键。提示如图：

原因：配置文件中的字段[ssid]，匹配不到数据源中的数据，至于为什么没有匹配到，请阅读源代码。这种情况多出现在数据源为数据库的情况下。

解决方法：修改配置文件，将字段[ssid]改成与数据表中的字段名，也就是和数据库保持一致。如果数据源非数据库，那么请尝试修改字段名为别的，尽量简单多试几次。

修改后的配置文件如下：

project.name = sssdeproject.default_charset = utf-8server.index = 8383server.search = 8384[uid]type = id[subject]type = title

错误二    建立索引成功，查到的结果为0

建立索引成功，但是，搜索时候却总是没有任何结果（你要保证在正常的情况下，能够搜到结果）。如下图：

我遇到的情况的原因是：在建立索引时，主键（也就是，ini文件中，type=id的那个字段）建立索引成功，但是要用于搜索的那个字段（[subject]）没有建立索引，所以，当然没有搜索结果。

解决方案：修改配置文件sssde.ini，将字段[subject]改名为[unickname]，这样字段名就和数据库里字段名一样了。然后再查询，成功了！！！！！！

原因：不清楚，但是至此，我已经完全不想再信官网上那句“字段名不必和数据库中的字段一致”这句话。

修改后的sssde.ini文件为：

project.name = sssdeproject.default_charset = utf-8server.index = 8383server.search = 8384[uid]type = id[unickname]type = title

使用一  关于是数据库建立索引时，读取数据的条数

参读了util/Indexer.php和util/XSDataSource.class.php的源码后，发现使用Indexer.php工具建立索引，每次从数据库中读取到1000条记录。控制这个数据的参数是“PLIMIT”，它在util/XSDataSource.class.php的129行附近。源码如下：

/** * SQL 数据库源 *  * @author hightman <[e-mail]> * @version 1.0.0 * @package XS.util  */class XSDatabaseDataSource extends XSDataSource{<span style="color:#ff0000;">const PLIMIT = 10000;</span>private $sql, $offset, $limit;private $db; /* @var $db XSDatabase *//** * 返回数据库输出字符集 * @return mixed 如果数据库不支持 UTF-8 转换则返回 false */

只要修改这个变量即可改变读取数据库速度。相信大家很清楚了吧！

使用二  关于编写自己的搜索接口

在阅读了util/Quest.php的代码后，对程序有了一定的了解。现在简单谈谈如何编写一个搜索接口的问题。

首先，必须引入文件“lib/XS.php”。使用require_once来导入即可。与require相比，require_once不会重复引入同一个文件。

接着，我们需要得到一个XS对象，这个对象像是一个存放数据和对象仓库，包罗了所有我们在项目中需要用到的对象，比如索引对象index，搜索对象search等等。新建XS对象后，获得search对象，然后通过对search进行参数设置就可以完成我们的搜索了。

上面的话，应该还是不清楚，没关系，接下来，我们一起阅读代码:

<?php//不建议在测试和开发时，使用这句话。因为它会隐藏好多错误，信息，使得改错工作变得麻烦。//error_reporting( E_ALL&~E_NOTICE );//xunsearch的安装目录$prefix = "/usr/local/xunsearch";//加载XS.php，这步是必须的require_once("$prefix/sdk/php/lib/XS.php");//获得XS对象。这个参数是项目名，XS会根据项目名自动到app目录下寻找对应的.ini文件，并加载。$xs = new XS("sssde");if (empty($xs)){//如果上面的方法失效，那就使用绝对路径的方法试一试了。$xs = new XS("$prefix/sdk/php/app/sssde.ini");}//设置编码集，放置乱码$xs->defaultCharset = "UTF-8";//获得搜索对象$search = $xs->getSearch();/**  $query  要查询的词句   string  $fuzzy  是否模糊查询   bool  $synon  是否同义词查询  bool  $limit_num    查询结果的数目  int    $limit_offset 相对第一条记录的偏移量     int  这是我封装的函数，这个函数应该仅仅支持单词查询*/function search($query, $limit_num=20, $limit_begin=0, $fuzzy=true, $synon=true){//没有这句，将无法使用上面的search变量Global $search;//设置是否开启模糊查询$search->setFuzzy($fuzzy);//设置是否开启同义词查询$search->setAutoSynonyms($synon);//使用$query,可以搜索到好多结果，组成结果集。设置这一项，我们从结果集中取到部分结果返回，满足分页的需要。$limit_offset指定的相对0号结果偏移位置。$limit_num,控制读取的条数。$search->setLimit($limit_num, $limit_begin);//设置查询的请求句子，之所以这么说，是因为$query可以是"窝么 AND  你们  NOT 吃饭"这样的句子。如果输入"我们 您"，那么它将默认是AND连接$search->setQuery($query);//搜索，并用变量$docs存储取到的结果数组。这里每个doc为一个XSDocument对象$docs = $search->search();//获得本次查询的结果总数（这是个估值）        $matched = $search->getLastCount();        //获得搜索数据库中数据的总量        $total = $search->getDbTotal();//将结果存储在这个对象中，并将其返回        $results = new Results();$results->set_total_num($matched);//本次返回if(count($docs) == 0){echo "------------------------$query---get 0 results---------------------------\n";return null;}else{$res = "------------------------$query---get ".strval($matched)." results---------------------------\n";//将结果一一取出foreach($docs as $doc){//标题高亮$subject = $search->highlight($doc->subject);//echo "$subject--\n";if(!empty($doc)){$data = $doc->getFields();$result = new Result($data['uid'], $data['unickname']);$results->add_result($result);$res .= $data['unickname']." \t#".$data['uid']."\n";}}echo $res;return $results;}}class Results{private $total_num = 0;private $result_array = array();public function add_result($result){array_push($this->result_array, $result);}public function set_total_num($value){$this->total_num = $value;}public function get_total_num(){return $this->total_num;}public function get_result_array(){return $this->result_array;}}class Result{public $uid = -1;public $unickname = '';public function __construct($uid,$unick){$this->uid = $uid;$this->unickname = $unick;}}//测试search("部落");search("字");search("笑");search("尼玛");search("刘");