工具

更新时间:2023-07-05 11:59

本文档介绍一些工具类接口。

(更多平台支持,持续增加中...)

使用之前必须调用对应服务商的初始化接口,传入配置参数。

分词引擎 WordAnalysis

初始化

Lib\Api::Utils_WordAnalysis();

分词引擎 Api 调用

// 初始化分词引擎
$WordAnalysis = Lib\Api::Utils_WordAnalysis();

// 待分词的正文内容
$content = '猴哥、兔子、猫、狗、蛇、猴哥、鸡、老虎、动物、兔子、猫、狮子、老鼠、恐龙、猴哥、蛇、松鼠、恐龙。';

// 调用 getKeywords($content, $num) 获取指定数量的关键词
$tag = $WordAnalysis->getKeywords($content, 3);

// 返回英文逗号分隔的最终关键词内容
echo "tags:".$tag;

// 返回示例
// tags:猴哥,兔子,恐龙

参数说明

getKeywords($content, $num) 参数说明:

keyvalue 类型含义
contentstring待分词的正文内容
numint返回的关键词数量

返回参数

返回英文逗号分隔的最终关键词内容

tags:猴哥,兔子,恐龙

IP地址信息查询

初始化(两种库自选一种)

// 初始化 WitFrame本地 IP库查询
$ipquery = Lib\Api::Utils_IpQuery();

// 初始化 远程ip-api.com IP库查询
$ipquery = Lib\Api::Utils_IpQuery("ip-api");

IP地址查询 Api 调用

// 初始化WitFrame本地IP库查询
$ipquery = Lib\Api::Utils_IpQuery();

// 调用示例
$info = $ipquery->query('111.225.235.88');

// 返回json格式数据
print_r($info);

// 返回示例
// {"code":1,"ip":"111.225.235.88","geo":"河北省保定市","country":"","region":"","city":"","isp":"电信","latitude":"","longitude":""}

参数说明

query($ip) 参数说明:

keyvalue 类型含义
ipstring待查询ip地址

返回参数

json格式数据

{"code":1,"ip":"111.225.235.88","geo":"河北省保定市","country":"","region":"","city":"","isp":"电信","latitude":"","longitude":""}

返回参数说明

keyvalue 类型含义
ipstring查询ip地址
geostring地区完整信息
ispstring运营商
countrystring国际
regionstring省份
citystring城市
latitudestring维度
longitudestring经度

过滤词库 WordCensor

初始化

Lib\Api::Utils_WordCensor();

获取词库分类

$wordCensor = Lib\Api::Utils_WordCensor();

$type = $wordCensor->getType();

返回参数说明

Array
(
    [type] => Array
        (
            [name] => 名称
        )
)
keyvalue 类型含义
typeint类别ID

获取过滤词库

$wordCensor = Lib\Api::Utils_WordCensor();

$k = $wordCensor->getKeyWords(0, []);

参数说明

keyvalue 类型含义
updateVerint可选,更新的版本,0 为完整更新
typearray可选,需要获取的类别 ID 数组,空数组表示获取所有类别

返回参数说明

Array
(
    [ver] => Array
        (
            [type] => Array
                (
                    [敏感词1] => 
                    [敏感词2] => 
                    [敏感词3] => del 
                )
            )
        )
)                
keyvalue 类型含义
verint版本
typeint类型id

敏感词为数组的 key,默认值为空,如果值为 del 时代表此版本删除此敏感词

获取词库的正则

$wordCensor = Lib\Api::Utils_WordCensor();

$preg = $wordCensor->getFindWords([]);

参数说明

keyvalue 类型含义
typearray可选,需要获取的类别 ID 数组,空数组表示获取所有类别

返回参数说明

返回 preg_match 可用的参数数组