PHPackages                             flex/xunsearch - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Search &amp; Filtering](/categories/search)
4. /
5. flex/xunsearch

ActiveLibrary[Search &amp; Filtering](/categories/search)

flex/xunsearch
==============

xunsearch【讯搜全文索引】composer package

v3.0.6(3y ago)05.7k1MITPHPPHP &gt;=5.6

Since Sep 4Pushed 3y agoCompare

[ Source](https://github.com/inbjo/xunsearch)[ Packagist](https://packagist.org/packages/flex/xunsearch)[ RSS](/packages/flex-xunsearch/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (5)Dependencies (2)Versions (10)Used By (1)

Xunsearch for PHP
=================

[](#xunsearch-for-php)

---

[![](https://camo.githubusercontent.com/7c8f01c7a261b85f6a040f1a943128afb9b09e3b00a333ef6a1f7dc940fce0cb/68747470733a2f2f7472617669732d63692e6f72672f5368616f5a654d696e672f78756e7365617263682e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/ShaoZeMing/xunsearch)[![](https://camo.githubusercontent.com/cca7639ca6c4299b637feecd6fcd078c05cfca949485da692f092dd4fe77495b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f5368616f5a654d696e672f78756e7365617263682e737667)](https://packagist.org/packages/shaozeming/xunsearch)[![](https://camo.githubusercontent.com/2416c3fc41a5522574f46155d7c2f48219560c3bbbd79ddc3c075484460450c4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f5368616f5a654d696e672f78756e7365617263682e737667)](https://packagist.org/packages/stichoza/shaozeming/xunsearch)

前置说明：
-----

[](#前置说明)

### 请先安装xunsearch 服务端：

[](#请先安装xunsearch-服务端)

- 普通编译安装(推荐)

```

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

cd xunsearch-full-1.4.10/
sh setup.sh
//第一次安装的话，过程可能会稍显漫长，请不必着急，您大可泡杯茶一边喝一边等待即可。

cd $prefix ; bin/xs-ctl.sh restart

更多详情请移步：http://www.xunsearch.com/doc/php/guide/start.installation

```

- docker 安装

```
Docker 方式安装服务端
---------------------

//下载映像：

docker pull hightman/xunsearch

//启动映像：

docker run --name xunsearch -d \
-p 8383:8383 -p 8384:8384 \
-v /var/xunsearch/data:/usr/local/xunsearch/data \
hightman/xunsearch:latest

//以上启动参数可自行修改，该方式仅运行服务端

```

Installing
----------

[](#installing)

```
$ composer require shaozeming/xunsearch -v
```

### configuration

[](#configuration)

- 老师搜索库配置 配置结构和官方ini文件类似，只不过替换为了php 数组形式方式展示，请照着官方文档和本配置文件对比，葫芦画瓢：

```
// config/xunsearch.php

    'default' => 'teacher',   //默认搜索库

    'databases' => [

//        老师搜索库配置 配置结构和官方ini文件类似，只不过替换为了php 数组形式方式展示，请照着官方文档和本配置文件对比，葫芦画瓢：http://www.xunsearch.com/doc/php/guide/ini.guide
        'teacher' => [
            'project.name' => 'teacher',
            'project.default_charset' => 'utf-8',
            'server.index' => '127.0.0.1:8383',
            'server.search' => '127.0.0.1:8384',
            'id' => [
                'type' => 'id',
            ],
            'email' => [
                'index' => 'mixed',
            ],
            'name' => [
                'index' => 'mixed',
            ],
            'desc' => [
                'index' => 'mixed',
            ],

        ],

        //学生搜索库
        'student' => [
            'project.name' => 'student',
            'project.default_charset' => 'utf-8',
            'server.index' => '127.0.0.1:8383',
            'server.search' => '127.0.0.1:8384',
            'id' => [
                'type' => 'id',
            ],
            'email' => [
                'index' => 'mixed',
            ],
            'name' => [
                'index' => 'mixed',
            ],
            'desc' => [
                'index' => 'mixed',
            ],

        ],

//        ...
    ],
```

Example:

```
        define('XS_APP_ROOT', 'your/config_file_path/dir/');  //可以定义配置文件目录
        $xs = new XunsearchService();

       $data =[
            ['id' => 1, 'email' => '928240096@qq.com', 'name' => 'Shao ZeMing 邵泽明 邵澤明', 'lesson' => '朗诵主持,Reciting Hosting,朗誦主持，','desc'=>'我是谁，我在哪儿，我要做什么，我不告诉你'],
            ['id' => 2, 'email' => '12315@qq.com', 'name' => 'Chris Dong 董胜君  董勝君', 'lesson' => '朗诵主持,Reciting Hosting,朗誦主持，演講辯論，speech debate，演讲辩论','desc'=>'如果有一天，我走了，你应该知道我去了哪儿'],
            ['id' => 3, 'email' => 'shao-ze-ming@outlook.com', 'name' => '二傻子 Two fools', 'lesson' => '朗诵主持,Reciting Hosting,朗誦主持，','desc'=>'最近头发掉的厉害，我该怎么办好呀'],
            ['id' => 4, 'email' => 'szm19920426@qq.com', 'name' => '君莫笑 jun mo xiao 君莫笑', 'lesson' => '写作批改,writing correction,寫作批改,国学经典,National Classics,國學經典','desc'=>'哎呀，脑壳疼，脑壳疼，脑壳疼'],
            ['id' => 5, 'email' => '1270912585@qq.com', 'name' => '李四，li si 李四', 'lesson' => '朗诵主持,Reciting Hosting,朗誦主持，演講辯論，speech debate，演讲辩论，国学经典,National Classics,國學經典','desc'=>'你知道我对你不静静是喜欢'],
        ];

//        $result =  $xs->addIndex($data);  //添加索引
//        $result = $xs->search('泽明');   //搜索默认索引数据库
//        $result = $xs->setSort('id',true)->setLimit(15)->search('ming');  //搜索排序,或分页
//        $result = $xs->setDatabase('student')->search('shao');  //搜索自定义索引数据库
          $result = $xs->setDatabase('student')->search('shao');  //搜索自定义索引数据库

        //$newData=[....]
        //$result =  $xs->updateIndex($newData);  //更新单挑或多条索引
        //$result =  $xs->delIndex('3');  //删除单挑或多条索引
        //$result =  $xs->cleanIndex();   //清空索引

        print_r($result);
          * @return array  返回数组结构
                    return [
                              'doc'           => Object,      //搜索数据结果文档
                              'hot'           => array,       //热门词汇
                              'count'         => int,         //搜索结果统计
                              'total'         => int,         //数据库总数据
                              'corrected'     => array,       //搜索提示
                              'related'       => array,       //相关搜索
                              'search_cost'   => int,         //搜索所用时间
                              'total_cost'    => int,         //页面所用时间
                          ];
                  */

         /*
 示例结果：
Array
(
    [doc] => Array
        (
            [0] => XSDocument Object
                (
                    [_data:XSDocument:private] => Array
                        (
                            [id] => 1
                            [email] => 928240096@qq.com
                            [name] => Shao ZeMing 邵泽明 邵澤明
                            [lesson] => 朗诵主持,Reciting Hosting,朗誦主持，
                            [desc] => 我是谁，我在哪儿，我要做什么，我不告诉你
                            [255] =>
                        )

                    [_terms:XSDocument:private] =>
                    [_texts:XSDocument:private] =>
                    [_charset:XSDocument:private] => UTF-8
                    [_meta:XSDocument:private] => Array
                        (
                            [docid] => 1
                            [rank] => 1
                            [ccount] => 0
                            [percent] => 100
                            [weight] => 1.1440536975861
                        )

                )

        )

    [hot] => Array
        (
        )

    [count] => 1
    [total] => 5
    [corrected] => Array
        (
        )

    [related] => Array
        (
        )

    [search_cost] => 0.00080204010009766
    [total_cost] => 0.004767894744873
)
 */
```

License
-------

[](#license)

MIT

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity22

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 71.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~207 days

Recently: every ~146 days

Total

9

Last Release

1155d ago

Major Versions

v1.1 → v3.0.02018-09-11

### Community

Maintainers

![](https://www.gravatar.com/avatar/0071a236e8e4c14787e83570e000c43a84b09b404b9fd7c9e383b08eca426afe?d=identicon)[Xiazi](/maintainers/Xiazi)

---

Top Contributors

[![ShaoZeMing](https://avatars.githubusercontent.com/u/19376576?v=4)](https://github.com/ShaoZeMing "ShaoZeMing (15 commits)")[![inbjo](https://avatars.githubusercontent.com/u/11854149?v=4)](https://github.com/inbjo "inbjo (6 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/flex-xunsearch/health.svg)

```
[![Health](https://phpackages.com/badges/flex-xunsearch/health.svg)](https://phpackages.com/packages/flex-xunsearch)
```

###  Alternatives

[ruflin/elastica

Elasticsearch Client

2.3k50.4M203](/packages/ruflin-elastica)[opensearch-project/opensearch-php

PHP Client for OpenSearch

15224.3M65](/packages/opensearch-project-opensearch-php)[mailerlite/laravel-elasticsearch

An easy way to use the official PHP ElasticSearch client in your Laravel applications.

934529.3k2](/packages/mailerlite-laravel-elasticsearch)[massive/search-bundle

Massive Search Bundle

721.4M13](/packages/massive-search-bundle)[shyim/opensearch-php-dsl

OpenSearch/Elasticsearch DSL library

175.9M9](/packages/shyim-opensearch-php-dsl)[outl1ne/nova-multiselect-filter

Multiselect filter for Laravel Nova.

45802.7k3](/packages/outl1ne-nova-multiselect-filter)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
