php-sensitive-word-filter

php-sensitive-word-filter

php 敏感词过滤类

介绍

php 实现的敏感词过滤器，敏感词支持使用内存（数组）存储及文件存储

设计了存储接口 \SensitiveWordFilter\Storage\IStorage 方便以后扩展其他存储

提供敏感词检查与过滤方法，并使用了装饰器，增加敏感词白名单保护功能，保护某些词不被过滤

---

功能

敏感词存储

• 存储在内存（数组）

• 存储在文件

敏感词过滤与检查

• 检查数据中是否含有敏感词

• 过滤数据中的敏感词

• 白名单保护，保护忽略被过滤的敏感词

---

类说明

IStorage SensitiveWordFilter/Storage/IStorage.php

敏感词存储接口

Type SensitiveWordFilter/Storage/Type.php

支持的敏感词存储类型

Factory SensitiveWordFilter/Storage/Factory.php

敏感词存储工厂类，根据类型创建存储对象

FileStorage SensitiveWordFilter/Storage/FileStorage.php

基于文件的敏感词存储类

MemoryStorage SensitiveWordFilter/Storage/MemoryStorage.php

基于内存的敏感词存储类

ISensitiveWordFilter SensitiveWordFilter/ISensitiveWordFilter.php

敏感词过滤器接口

Resource SensitiveWordFilter/Resource.php

敏感词列表来源

DefaultFilter SensitiveWordFilter/DefaultFilter.php

默认敏感词过滤器

WhiteListProtectFilter SensitiveWordFilter/WhiteListProtectFilter.php

支持白名单保护的敏感词过滤器（装饰器）

---

演示

// 检查是否包含敏感词
$resource = new \SensitiveWordFilter\Resource(\SensitiveWordFilter\Resource::MEMORY);
$resource->setWords(['a', 'b', 'c']);

$sensitive_word_storage = \SensitiveWordFilter\Storage\Factory::make(\SensitiveWordFilter\Storage\Type::MEMORY);
$sensitive_word_storage->setResource($resource);

$filter = new \SensitiveWordFilter\DefaultFilter($sensitive_word_storage);

$content = 'china';
var_dump($filter->isContain($content)); // true

$content = 'money';
var_dump($filter->isContain($content)); // false

// 过滤敏感词
$resource = new \SensitiveWordFilter\Resource(\SensitiveWordFilter\Resource::MEMORY);
$resource->setWords(['巴黎', '奥运', '金牌']);

$sensitive_word_storage = \SensitiveWordFilter\Storage\Factory::make(\SensitiveWordFilter\Storage\Type::MEMORY);
$sensitive_word_storage->setResource($resource);

$filter = new \SensitiveWordFilter\DefaultFilter($sensitive_word_storage);

$content = '巴黎2024奥运会，中国获得40面金牌，可喜可贺';
echo $filter->filter($content, '**'); // '**2024**会，中国获得40面**，可喜可贺';

更多功能演示可参考单元测试代码 SensitiveWordFilter Unit Test