Laravel Qcloud Content Security
T-Sec 天御内容安全服务使用了深度学习技术，识别文本/图片中出现的可能令人反感、不安全或不适宜内容，支持用户配置词库/图片黑名单，识别自定义的识别类型。
Installing
$ composer require overtrue/laravel-qcs -vvv
Config
请在 config/services.php 中配置以下内容：
//...
// 文字识别服务
'tms' => [
'secret_id' => env('TMS_SECRET_ID'),
'secret_key' => env('TMS_SECRET_KEY'),
'endpoint' => env('TMS_ENDPOINT'),
],
// 图片审核/识别服务
'ims' => [
'secret_id' => env('IMS_SECRET_ID'),
'secret_key' => env('IMS_SECRET_KEY'),
'endpoint' => env('IMS_ENDPOINT'),
],
API
获取检查结果
调用对应 API 返回数组结果，返回值结构请参考官方 API 文档。
文本
接口请求频率限制：1000次/秒。
use Overtrue\LaravelQcs\Tms;
array Tms::check(string $input);
图片
- 接口请求频率限制：100次/秒。
- 图片检测接口为图片文件内容，大小不能超过5M
- 图片将会缩放成 300*300 后检查
use Overtrue\LaravelQcs\Ims;
array Ims::check(string $contents);
💡 $contents可以为：图片内容、图片本地路径或 URL。
检查并返回是否通过
use Overtrue\LaravelQcs\Tms;
use Overtrue\LaravelQcs\Ims;
bool Tms::validate(string $contents, string $strategy = 'strict')
bool Ims::validate(string $contents, string $strategy = 'strict')
直接替换敏感文本内容
直接将检测到的敏感词替换为 *：
use Overtrue\LaravelQcs\Tms;
string Tms::mask(string $input, string $char = '*', string $strategy = 'strict');
// 示例：
echo Tms::mask('这是敏感内容哦');
// "这是**哦"
在模型中使用
文本校验（CheckTextWithTms）
use Illuminate\Database\Eloquent\Model;
use Overtrue\LaravelQcs\Traits\CheckTextWithTms;
class Post extends Model
{
// 文本校验
use CheckTextWithTms;
protected array $tmsCheckable = ['name', 'description'];
protected string $tmsCheckStrategy = 'strict'; // 可选，默认使用最严格模式
//...
}
文本打码（MaskTextWithTms）
检测到敏感内容时不抛出异常，而是替换为 * 号。
use Illuminate\Database\Eloquent\Model;
use Overtrue\LaravelQcs\Traits\MaskTextWithTms;
class Post extends Model
{
use MaskTextWithTms;
protected $tmsMaskable = ['name', 'description'];
protected $tmsMaskStrategy = 'review'; // 开启打码的策略情况，可选，默认使用最严格模式
//...
}
使用表单校验规则
$this->validate($request, [
'name' => 'required|tms',
'avatar' => 'required|url|ims',
'description' => 'required|tms:strict',
'logo_url' => 'required|url|ims:logo',
]);
配置策略
你可以通过以下方式注册一个或多个自定义校验规则，决定是否通过校验：
// 文字
Tms::setStrategy('strict', function($result) {
return $result['Suggestion'] === 'Pass';
});
// 图片
Ims::setStrategy('logo', function($result) {
return $result['Suggestion'] === 'Pass';
});
Events
| Event | Description |
|---|---|
Overtrue\LaravelQcs\Events\ModelAttributeTextMasked |
模型属性值打码后触发. 可获取 $model 和 $attribute |
异常处理
验证失败将抛出以下异常：
Overtrue\LaravelQcs\InvalidTextException$contents- (string) 被检测的文本内容$response- (array) API 原始返回值
Overtrue\LaravelQcs\InvalidImageException$response- (array) API 原始返回值
Contributing
You can contribute in one of three ways:
- File bug reports using the issue tracker.
- Answer questions or fix bugs on the issue tracker.
- Contribute new features or update the wiki.
The code contribution process is not very formal. You just need to make sure that you follow the PSR-0, PSR-1, and PSR-2 coding guidelines. Any new code contributions must be accompanied by unit tests where applicable.
PHP 扩展包开发
想知道如何从零开始构建 PHP 扩展包？
请关注我的实战课程，我会在此课程中分享一些扩展开发经验 —— 《PHP 扩展包实战教程 - 从入门到发布》
License
MIT
42 Dec 15, 2022
477 Dec 1, 2022
8 Aug 17, 2022
11 May 7, 2022
12 Sep 26, 2022
170 Nov 20, 2022
131 Oct 30, 2022
44.1k Jan 7, 2023
11 Apr 23, 2022
655 Jan 3, 2023
1.2k Jan 1, 2023
417 Jan 3, 2023
132 Nov 27, 2022
10 Nov 2, 2022
3 Nov 28, 2022
5 Feb 8, 2022
708 Dec 22, 2022
0 Jul 24, 2021
56 Dec 16, 2022
2.2k Jan 5, 2023
26 Sep 9, 2022
53 Oct 17, 2022
50 Dec 5, 2022
100 Jan 4, 2023
320 Dec 12, 2022
82 Nov 24, 2022