安装&使用流程

Download and install Composer:

curl -sS https://getcomposer.org/installer | php

php composer.phar

安装扩展

composer require lustre/php-dfa-sensitive

如果你需要手动引入

require './vendor/autoload.php';use DfaFilter\SensitiveHelper;

构建敏感词库树

// 获取感词库索引数组$wordData = array(    '察象蚂',    '拆迁灭',    '车牌隐',    '成人电',    '成人卡通',    ......);// get one helper$handle = SensitiveHelper::init()->setTree($wordData);

// 获取感词库文件路径$wordFilePath = 'tests/data/words.txt';// get one helper$handle = SensitiveHelper::init()->setTreeByFile($wordFilePath);

检测是否含有敏感词

$islegal = $handle->islegal($content);

敏感词过滤

// 敏感词替换为*为例（会替换为相同字符长度的*）$filterContent = $handle->replace($content, '*', true); // 或敏感词替换为***为例 $filterContent = $handle->replace($content, '***');

标记敏感词

 $markedContent = $handle->mark($content, '<mark>', '</mark>');

获取文字中的敏感词

// 获取内容中所有的敏感词$sensitiveWordGroup = $handle->getBadWord($content);// 仅且获取一个敏感词$sensitiveWordGroup = $handle->getBadWord($content, 1);

如何使用单元测试进行测试

安装PHPUnit

$ wget https://phar.phpunit.de/phpunit.phar$ chmod +x phpunit.phar$ mv phpunit.phar /usr/local/bin/phpunit

使用composer自动加载php命名空间

$ composer update

运行单元测试

$ phpunit tests/BaseTest.php