PHPackages                             shopwwi/webman-search - 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. shopwwi/webman-search

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

shopwwi/webman-search
=====================

search for the webman

v1.0.7(2y ago)204048[1 issues](https://github.com/shopwwi/webman-search/issues)MITPHPPHP &gt;=7.2 || ^8.0

Since May 30Pushed 2y agoCompare

[ Source](https://github.com/shopwwi/webman-search)[ Packagist](https://packagist.org/packages/shopwwi/webman-search)[ RSS](/packages/shopwwi-webman-search/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (8)Dependencies (3)Versions (9)Used By (0)

[!['Build Status'](https://camo.githubusercontent.com/2e8d8bcc23b7cbf1cc64f976a04c517b9583250e40b98d80a5e5176a2f5eefc9/68747470733a2f2f7472617669732d63692e6f72672f73686f707777692f7765626d616e2d7365617263682e7376673f6272616e63683d6d61696e)](https://github.com/shopwwi/webman-scout) [!['Latest Stable Version'](https://camo.githubusercontent.com/7acf4e2997cb0d564d1e15417b895536fef1b8735e327ebf83a2f638e371c3d4/68747470733a2f2f706f7365722e707567782e6f72672f73686f707777692f7765626d616e2d7365617263682f762f737461626c652e737667)](https://packagist.org/packages/shopwwi/webman-search) [!['Total Downloads'](https://camo.githubusercontent.com/de1b727feb7a176954967addde3518db6a0e93f671a2789dfd9c7ed8627bbd9d/68747470733a2f2f706f7365722e707567782e6f72672f73686f707777692f7765626d616e2d7365617263682f642f746f74616c2e737667)](https://packagist.org/packages/shopwwi/webman-search) [!['License'](https://camo.githubusercontent.com/83eabf41d1de02f31a4ea923914d820cab7462b45b97027970bb0522839ea464/68747470733a2f2f706f7365722e707567782e6f72672f73686f707777692f7765626d616e2d7365617263682f6c6963656e73652e737667)](https://packagist.org/packages/shopwwi/webman-search)

安装
==

[](#安装)

```
composer require shopwwi/webman-search

```

- 如果觉得方便了你 不要吝啬你的小星星哦 tycoonSong

使用方法
----

[](#使用方法)

### 搜索选定器

[](#搜索选定器)

- xunsearch 使用讯搜搜索选定器

```
composer require hightman/xunsearch

```

- meilisearch 使用meilisearch选定器

```
composer require meilisearch/meilisearch-php

```

- elasticsearch 使用elasticsearch选定器（需8.0以上版本）

```
composer require elasticsearch/elasticsearch

```

### 搜索选定器服务端安装

[](#搜索选定器服务端安装)

- meilisearch 安装方法查看 [https://docs.meilisearch.com/learn/getting\_started/quick\_start.html](https://docs.meilisearch.com/learn/getting_started/quick_start.html)
- xunsearch 安装方法查看
- elasticsearch 安装方法查看

### 搜索配置

[](#搜索配置)

- 配置config/plugin/shopwwi/search/app.php 内配置 默认不需要配置
- 生成密钥(如果生成了 启动meilisearch服务端的时候记得保持一致，其它搜索器不需要)

```
php webman shopwwi:search

```

- 选定器调用（默认调用config设置的默认）

```
    use \Shopwwi\WebmanSearch\Facade\Search;
    // id为主键字段  index为索引
    $search = Search::use('meilisearch',['id'=>'id','index'=>'index']);
```

- 执行命令方法

```
php webman search:create:index  // es搜索必须先执行此命令创建索引
php webman search:update:index  // 更新索引配置
php webman search:drop:index  //删除索引
```

- 写入文档

```
      $data = [
        ['id' => 1, 'title' => '我从来都不曾承认我其实是个大帅哥' ,'create_at' => 2022-03-24 08:08:08,'type' => 'A'],
        ['id' => 2, 'title' => '时间万物除我之外' ,'create_at' => 2022-03-24 09:08:08,'type' => 'B'],
        ['id' => 3, 'title' => '你看见我的小熊了吗？' ,'create_at' => 2022-03-24 10:08:08,'type' => 'B'],
        ['id' => 4, 'title' => '这是一个神奇的世界，因为你永远不会知道我在哪' ,'create_at' => 2022-03-24 10:08:08,'type' => 'C']
      ]
    $search->create($data); //批量写入 支持单条 写入一维数组即可
```

- 更新文档

```
      $data = [
        ['id' => 3, 'title' => '你看见我的小熊了吗？哈哈哈']
      ];
    $search->update($data);  // 批量修改 主键必须存在 单条修改写入一维数组
```

- 删除文档

```
    $search->destroy(3);  //则会删除id为3的数据
    $search->destroy([2,3]); //批量删除 id为2和3的数据
```

- 删除索引

```
    $search->clear();
```

- 数据查询

```
    use \Shopwwi\WebmanSearch\Facade\Search;
    // 基础查询关键词
    $result = $search->q('我')->get();
    // 全部查询 默认只显示20条
    $result = $search->get();
    //指定字段(默认指定所有)
    $result = $search->select(['id','title'])->get();
    //限定查询数量 默认为20
    $result = $search->limit(100)->q('我')->get();
    //带条件搜索（一定要设定可检索字段 不然无效，一般在初始化新增之后）
    // where($column, $operator = null, $value = null, string $boolean = 'AND') static 搜索
    // orWhere($column, $operator = null, $value = null) static 搜索或者

    Search::updateFilterableAttributes(['id','title','type','create_at']);
    $result = $search->where('type','B')->limit(100)->q('我')->get();
    $result = $search->where('type','!=','B')->limit(100)->q('我')->get();
    $result = $search->orWhere('type','B')->limit(100)->q('我')->get();
    // whereIn($column, $values, string $boolean = 'AND', bool $not = false) static 存在当中
    // orWhereIn(string $column, $values) static 搜索或者存在当然
    // whereNotIn(string $column,array $values, string $boolean = 'AND') static 搜索不存在当中
    // orWhereNotIn(string $column, $values) static 搜索或者不存在当中
    $result = $search->whereIn('type',['A','B'])->limit(100)->q('我')->get();
    $result = $search->whereNotIn('type',['A','B'])->limit(100)->q('我')->get();
    $result = $search->orWhereIn('type',['A','B'])->limit(100)->q('我')->get();
    $result = $search->orWhereNotIn('type',['A','B'])->limit(100)->q('我')->get();
    // whereRaw($sql,  $boolean = 'AND') static 原生数据查询
    $result = $search->where('type','B')->whereRaw('(id = 1 OR id = 2)')->limit(100)->q('我')->get();
    //whereBetween($column,array $values, string $boolean = 'AND')
    $result = $search->whereBetween('id',[1,5])->limit(100)->q('我')->get();
    //如果您的文档包含_geo数据，您可以使用_geoRadius内置过滤规则根据其地理位置过滤结果
    $result = $search->where('type','B')->whereRaw('_geoRadius(45.4628328, 9.1076931, 2000)')->limit(100)->q('我')->get();

    // 分页
    $result = $search->where('type','B')->limit(20)->q('我')->paginate(\request()->input('page',1));

    //关键词高亮
    $result = $search->where('type','B')->limit(20)->highlight(['title'])->q('我')->paginate(\request()->input('page',1));
```

- elasticSearch新升级whereRaw特定写法 支持query下的全部写法

```
    $search->whereRaw(['bool'=>['filter'=>[['term'=>['color'=>'red']],['term'=>['color'=>'blue']]]]]);
    $search->whereRaw(['bool'=>['must'=>[['term'=>['color'=>'red']],['term'=>['color'=>'blue']]]]]);
    // 如需使用aggs
    $result = $search->aggs(['avg_price'=>['avg'=>['field'=>'price']]])->q('华为')->get();
     // 获取原文返回内容
    $result->raw
```

- 获取建议词（如搜索s则会出现与s相关的汉字数组 ,meilisearch不支持，es请使用原sdk方法查询）

```

    $result = $search->limit(20)->q('s')->suggest();// 不带统计数，数量都为0
    $result = $search->limit(20)->q('s')->suggest(true); // 带统计数
```

- 获取指定文档

```
    $result = $search->first(2);
```

- 字段排序

```
    // 字段排序（一定要设定可排序字段 不然无效，一般在初始化新增之后）
    //1.使用orderBy方法
    $result = $search->where('type','B')->orderBy('create_at','desc')->orderBy('id')->limit(100)->q('我')->get();
    //2.全局设定
    $result = $search->where('type','B')->limit(100)->q('我')->get();
```

- 获取原SDK方法（各方法请查看各选定器包说明文档）

```
   //返回所选定器本身SDK方法
    $search = Search::use('meilisearch',['id'=>'id','index'=>'index'])->us();

    //如meilisearch调用任务方法
    $search->getTasks(); // 查询所有任务
```

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity24

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 86.7% 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 ~92 days

Recently: every ~84 days

Total

8

Last Release

797d ago

PHP version history (2 changes)v1.0.0PHP &gt;=7.2 || 8.0

v1.0.3PHP &gt;=7.2 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/df539cc9ed77b47bc184c26a9cb989e551f9afb1e8841ea02f25fe66b6b0ee91?d=identicon)[phcent](/maintainers/phcent)

---

Top Contributors

[![phcent](https://avatars.githubusercontent.com/u/70010565?v=4)](https://github.com/phcent "phcent (13 commits)")[![FLyLow1](https://avatars.githubusercontent.com/u/44692319?v=4)](https://github.com/FLyLow1 "FLyLow1 (2 commits)")

---

Tags

meilisearchwebman

### Embed Badge

![Health badge](/badges/shopwwi-webman-search/health.svg)

```
[![Health](https://phpackages.com/badges/shopwwi-webman-search/health.svg)](https://phpackages.com/packages/shopwwi-webman-search)
```

###  Alternatives

[statamic-rad-pack/meilisearch

meilisearch search driver for Statamic

1661.7k](/packages/statamic-rad-pack-meilisearch)[dwarfdk/laravel-meilitools

Additional tools for Laravel Scout integration with MeiliSearch

10022.4k](/packages/dwarfdk-laravel-meilitools)[omure/scout-advanced-meilisearch

Laravel Scout extension that allows to use meilisearch advanced features as well as has an extended collection driver for testing purposes.

123.9k](/packages/omure-scout-advanced-meilisearch)

PHPackages © 2026

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