PHPackages                             qifen/console-sdk - 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. [CLI & Console](/categories/cli)
4. /
5. qifen/console-sdk

ActiveLibrary[CLI & Console](/categories/cli)

qifen/console-sdk
=================

3.0.0(3y ago)182MITPHPPHP >=8.0

Since May 12Pushed 9mo ago1 watchersCompare

[ Source](https://github.com/AugustSoon/qifen-console-sdk)[ Packagist](https://packagist.org/packages/qifen/console-sdk)[ RSS](/packages/qifen-console-sdk/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (2)Versions (21)Used By (0)

console-sdk
===========

[](#console-sdk)

安装
--

[](#安装)

```
composer require qifen/console-sdk
```

使用
--

[](#使用)

### 全文搜索

[](#全文搜索)

```
use Qifen\ConsoleSdk\Search\Application;

// 配置
$config = [
    'url' => 'http://api.xxx.com/', // 服务地址
    'appId' => '123456790', // appId
    'appSecret' => '123456790xxx',  // appSecret
];

// 1.初始化
$client = new Application($config);

// 2.设置索引，如不设置，会写入默认索引
$client = $client->setIndex('style');

// 3.写入
// 数据为数组格式，一次最多可写入1000条
// 数据项格式随意，但是每一条必须都包含相同的主键，默认主键是 id
// 如果主键为其他值，可在第二个参数中传入
// 写入的索引为通过 setIndex 设置的索引，也可以通过传入第三个参数写入指定索引
$data = [
    ['id' => 1, 'title' => '1', 'tags' => '1'],
    ['id' => 2, 'title' => '2', 'tags' => '2'],
];
// 默认主键和索引
$client->create($data);
// 指定主键
$client->create($data, 'pk');
// 指定主键和索引
$client->create($data， 'pk', 'post');

// 4.更新
// 数据为数组格式，一次最多可更新1000条
// 每一条数据都必须包含主键
// 更新的索引为通过 setIndex 设置的索引，也可以通过传入第二个参数更新指定索引
$data = [
    ['id' => 1, 'title' => '1.0'],
];
// 默认索引
$client->update($data);
// 指定索引
$client->update($data, 'post');

// 5.更新全文搜索可搜索字段
// 数据写入后全文搜索默认会搜索全部字段，如果要指定字段，需要更新可搜索字段
// 字段格式为数组，请确保数组中的字段是数据中存在的字段
$fields = ['title'];
// 默认索引
$client->updateSearchable($fields);
// 指定索引
$client->updateSearchable($fields, 'post');

// 6.更新可查询字段
// 数据写入后默认只能全文搜索，如果要指定查询条件，需要先更新可查询字段
// 字段格式为数组，请确保数组中的字段是数据中存在的字段
$fields = ['id', 'tags'];
// 默认索引
$client->updateFilter($fields);
// 指定索引
$client->updateFilter($fields, 'post');

// 7.更新可排序字段
// 数据写入后默认无法自定义排序规则，如果要指定排序规则，需要先更新可排序字段
// 字段格式为数组，请确保数组中的字段是数据中存在的字段
$fields = ['id', 'tags'];
// 默认索引
$client->updateSort($fields);
// 指定索引
$client->updateSort($fields, 'post');

// 8.更新排序规则
// 默认排序规则为 words, typo, proximity, attribute, sort, exactness
// 可以随意调整上面规则对顺序
// words-结果按匹配查询词的数量递减排序，首先返回包含所有查询词的文档
// typo-结果按越来越多的错别字排序，首先返回匹配查询词且拼写错误较少的文档
// proximity-结果按匹配的查询词之间的距离增加进行排序，返回查询词紧挨着出现且顺序与查询字符串相同的文档
// attribute-结果根据属性排名顺序进行排序，首先返回在更重要的属性中包含查询词的文档（对应 updateSearchable 方法）
// sort-结果根据查询时给定的排序参数进行排序
// exactness-结果按匹配词与查询词的相似度排序，返回包含与最先查询的词条完全相同的词条的文档
// 参考文档 https://docs.meilisearch.com/learn/core_concepts/relevancy.html#ranking-rules
$fields = ['words', 'typo', 'proximity', 'sort', 'attribute', 'exactness'];
// 默认索引
$client->updateRanking($fields);
// 指定索引
$client->updateRanking($fields, 'post');

// 9.删除数据
// 数据格式为数组，即要删除的主键集合
$ids = [1];
// 默认索引
$client->del($ids);
// 指定索引
$client->del($ids, 'post');

// 10.删除索引
// 删除索引和索引内的全部内容，此操作不可撤销，谨慎使用
// 默认索引
$client->clear();
// 指定索引
$client->clear('post');

// 11.搜索
// 参数说明
// $keyword 查询关键词
// $condition 查询条件，写法参考 https://docs.meilisearch.com/learn/advanced/filtering_and_faceted_search.html#using-filters
// $page 页数，默认1， 如果传 0 为不分页
// $limit 每页条数，默认 20
// $order 排序条件，数组格式，数组元素可以为字符串或数组，如果为字符串，即按照该字段 asc 排序，如果为数组，第一个元素为字段，第二个为排序规则，第二个省略则默认为 asc
// $index 指定索引
// 关键词搜索
$res = $client->query('关键词');
// 关键词搜索 + 指定查询条件（需要先更新可查询字段）
$res = $client->query('关键词', 'id = 1 OR tag = "2"');
// 关键词搜索 + 分页
$res = $client->query('关键词', '', 2, 20);
// 关键词搜索 + 不分页
$res = $client->query('关键词', '', 0, 1000);
// 关键词搜索 + 分页 + 排序（需要先更新可排序字段）
$res = $client->query('关键词', '', 1, 20, ["id", ["tag", "desc"]]);
// 关键词搜索 + 分页 + 指定索引
$res = $client->query('关键词', '', 1, 20, [], 'post');
// 返回格式
$res = [
    'list' => [],   // 数据列表
    'total' => 0,   // 查询到的数据总数
    'limit' => 20,  // 分页大小
    'offset' => 0,  // 开始位置
    'keyword' => '关键词', // 搜索的关键词
];
```

### 网页截图

[](#网页截图)

```
use Qifen\ConsoleSdk\Screenshot\Application;

// 配置
$config = [
    'url' => 'http://api.xxx.com/', // 服务地址
    'appId' => '123456790', // appId
    'appSecret' => '123456790xxx',  // appSecret
    'noticeUrl' => 'http://api.xxx.com/notice', // 回调地址
    'saveType' => 'qiniu',  // 保存类型，支持 oss、cos、qiniu
    // oss 参数
    'oss' => [
        'accessId' => '',
        'accessSecret' => '',
        'bucket' => '',
        'endpoint' => '',
    ],
    // cos 参数
    'cos' => [
        'region' => '',
        'app_id' => '',
        'secret_id' => '',
        'secret_key' => '',
        'bucket' => '',
    ],
    // 七牛参数
    'qiniu' => [
        'accessKey' => '',
        'secretKey' => '',
        'bucket' => '',
        'domain' => '',
    ],
];

// 1.初始化
$client = new Application($config);

// 2.截图
// 参数说明
// $url 要截图的 URL 地址
// $path 截图后的保存路径
// $width 图片宽度
$queueId = $client->screenshot('https://www.baidu.com', '/save_path/save_name.png', 800);
// 返回结果为队列ID，需自行保存，处理回调时使用
```

### 网页转PDF

[](#网页转pdf)

```
use Qifen\ConsoleSdk\Html2pdf\Application;

// 配置
$config = [
    'url' => 'http://api.xxx.com/', // 服务地址
    'appId' => '123456790', // appId
    'appSecret' => '123456790xxx',  // appSecret
    'noticeUrl' => 'http://api.xxx.com/notice', // 回调地址
    'saveType' => 'qiniu',  // 保存类型，支持 oss、cos、qiniu
    // oss 参数
    'oss' => [
        'accessId' => '',
        'accessSecret' => '',
        'bucket' => '',
        'endpoint' => '',
    ],
    // cos 参数
    'cos' => [
        'region' => '',
        'app_id' => '',
        'secret_id' => '',
        'secret_key' => '',
        'bucket' => '',
    ],
    // 七牛参数
    'qiniu' => [
        'accessKey' => '',
        'secretKey' => '',
        'bucket' => '',
        'domain' => '',
    ],
];

// 1.初始化
$client = new Application($config);

// 2.转PDF
// 参数说明
// $url 要转换的 URL 地址
// $path 转换完成后的保存路径
// $width 宽度，默认120mm
// $format 纸张格式，如果传了该参数，会忽略宽度参数
// 默认宽度
$queueId = $client->toPdf('https://www.baidu.com', '/save_path/save_name.pdf');
// 指定宽度
$queueId = $client->toPdf('https://www.baidu.com', '/save_path/save_name.pdf', '150mm');
// 指定纸张格式
$queueId = $client->toPdf('https://www.baidu.com', '/save_path/save_name.pdf', '', 'a4');
// 返回结果为队列ID，需自行保存，处理回调时使用
```

### 获取上传 token

[](#获取上传-token)

> 用于 word 转 html 和 PDF 转 html 时上传文件

```
use Qifen\ConsoleSdk\Upload\Application;

// 配置
$config = [
    'url' => 'http://api.xxx.com/', // 服务地址
    'appId' => '123456790', // appId
    'appSecret' => '123456790xxx',  // appSecret
    'noticeUrl' => 'http://api.xxx.com/notice', // 回调地址
    'saveType' => 'qiniu',  // 保存类型，支持 oss、cos、qiniu
    // oss 参数
    'oss' => [
        'accessId' => '',
        'accessSecret' => '',
        'bucket' => '',
        'endpoint' => '',
        'url' => '',    // 用来替换 word 和 pdf 中的图片地址
    ],
    // cos 参数
    'cos' => [
        'region' => '',
        'app_id' => '',
        'secret_id' => '',
        'secret_key' => '',
        'bucket' => '',
        'url' => '',    // 用来替换 word 和 pdf 中的图片地址
    ],
    // 七牛参数
    'qiniu' => [
        'accessKey' => '',
        'secretKey' => '',
        'bucket' => '',
        'domain' => '',
        'url' => '',    // 用来替换 word 和 pdf 中的图片地址
    ],
];

// 1.初始化
$client = new Application($config);

// 2.获取上传 token
// 参数说明
// $path 转换完成后的保存路径
$token = $client->getUploadToken('/save_path');
```

### 采集

[](#采集)

> 采集类型
>
> 1. chrome
>
> > 返回抓取到的所有 html
>
> 2. body
>
> > 返回抓取到的 body 部分
>
> 3. 节点类名 / 节点ID
>
> > 返回指定的节点部分，例如：.post #post
>
> 4. video / music
>
> > 返回抓取到的页面中的视频/音频，目前只支持微信公众号文章

```
use Qifen\ConsoleSdk\Collection\Application;

// 配置
$config = [
    'url' => 'http://api.xxx.com/', // 服务地址
    'appId' => '123456790', // appId
    'appSecret' => '123456790xxx',  // appSecret
    'noticeUrl' => 'http://api.xxx.com/notice', // 回调地址
];

// 1.初始化
$client = new Application($config);

// 2.采集
// 参数说明
// $url 要采集的 URL 地址
// $type 采集类型，默认 chrome
// 默认
$queueId = $client->collection('https://www.baidu.com');
// 采集视频
$queueId = $client->collection('https://www.baidu.com', 'video');
```

### 鉴黄

[](#鉴黄)

```
use Qifen\ConsoleSdk\Nsfw\Application;

// 配置
$config = [
    'url' => 'http://api.xxx.com/', // 服务地址
    'appId' => '123456790', // appId
    'appSecret' => '123456790xxx',  // appSecret
    'noticeUrl' => 'http://api.xxx.com/notice', // 回调地址
];

// 1.初始化
$client = new Application($config);

// 2.鉴黄-单个
$res = $client->identify('https://xxxxxxxx/.jpg');
// 自定义id，不传则默认为0，主要用于回调时区分是哪张图片
$res = $client->identify('https://xxxxxxxx/.jpg', 1);

// 3.鉴黄-批量
$list = [
    ['url' => 'https://xxxxxxxx/.jpg'], // id 不传的情况下为 0
    ['url' => 'https://xxxxxxxx/.jpg', 'id' => 1],
    ['url' => 'https://xxxxxxxx/.jpg', 'id' => 2],
    ['url' => 'https://xxxxxxxx/.jpg', 'id' => 3],
    ['url' => 'https://xxxxxxxx/.jpg', 'id' => 4],
];
$res = $client->identifyBatch($list);
```

### 纠错

[](#纠错)

```
use Qifen\ConsoleSdk\Correction\Application;

// 配置
$config = [
    'url' => 'http://api.xxx.com/', // 服务地址
    'appId' => '123456790', // appId
    'appSecret' => '123456790xxx',  // appSecret
    'noticeUrl' => 'http://api.xxx.com/notice', // 回调地址
];

// 1.初始化
$client = new Application($config);

// 2.纠错
// 文本内容
$content = [
    '一只小鱼船浮在平净的河面上',
    '我的家乡是有明的渔米之乡',
    '这场比赛我甘败下风',
    '这家伙还蛮格尽职守的'
];
// 默认ID，ID用于回调
$client->correction($content);
// 自定义ID
$client->correction($content, 1);
```

### chatgpt AI

[](#chatgpt-ai)

```
use Qifen\ConsoleSdk\Chatgpt\Application;

// 配置
$config = [
    'url' => 'http://api.xxx.com/', // 服务地址
    'appId' => '123456790', // appId
    'appSecret' => '123456790xxx',  // appSecret
    'noticeUrl' => 'http://api.xxx.com/notice', // 回调地址
];

// 1.初始化
$client = new Application($config);
$client->sendMessage($carry, '写一遍关于下雨天的作文，不少于4000字');
```

### 发票提交

[](#发票提交)

```
use Qifen\ConsoleSdk\Invoice\Application;

$config = [
    'url' => 'http://api.xxx.com/', // 服务地址
    'appId' => '123456790', // appId
    'appSecret' => '123456790xxx',  // appSecret
];

// 1. 初始化
$client = new Application($config);

// 2. 设置参数
$client->setName('纳税人姓名');
$client->setNumber('纳税人识别号');
$client->setAddress('公司注册地址');
$client->setTel('公司电话');
$client->setBank('开户行');
$client->setAccount('银行账号');
$client->setPhone('手机号码');
$client->setEmail('接收邮箱');

// 3. 设置参数后提交
$requestId = $client->submit();

// 4. 直接提交
$requestId = $client->submit([
    'name' => '纳税人姓名',
    'number' => '纳税人识别号',
    'address' => '公司注册地址',
    'tel' => '公司电话',
    'bank' => '开户行',
    'account' => '银行账号',
    'phone' => '手机号码',
    'email' => '接收邮箱',
]);
```

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance40

Moderate activity, may be stable

Popularity11

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 68.2% 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 ~61 days

Recently: every ~222 days

Total

20

Last Release

293d ago

Major Versions

1.11 → 2.02023-01-29

2.0.1 → 3.0.02023-02-13

PHP version history (3 changes)1.0PHP >=7.2

3.0.0PHP >=8.0

2.0.2PHP >=7.4

### Community

Maintainers

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

---

Top Contributors

[![MustBeBlue](https://avatars.githubusercontent.com/u/163366625?v=4)](https://github.com/MustBeBlue "MustBeBlue (15 commits)")[![xsxs89757](https://avatars.githubusercontent.com/u/32379836?v=4)](https://github.com/xsxs89757 "xsxs89757 (7 commits)")

### Embed Badge

![Health badge](/badges/qifen-console-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/qifen-console-sdk/health.svg)](https://phpackages.com/packages/qifen-console-sdk)
```

###  Alternatives

[nunomaduro/phpinsights

Instant PHP quality checks from your console.

5.6k10.8M424](/packages/nunomaduro-phpinsights)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)[mahocommerce/maho

Free and open source ecommerce platform, created in 2024 on the M1 platform, PHP 8.3+

1322.1k12](/packages/mahocommerce-maho)[acquia/orca

A tool for testing a company's software packages together in the context of a realistic, functioning, best practices Drupal build

32902.4k](/packages/acquia-orca)[typhonius/acquia_cli

A Robo CLI tool for integrating with Acquia CloudAPI

3132.6k](/packages/typhonius-acquia-cli)

PHPackages © 2026

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