Blasp - Laravel 的不良言论过滤器

1. 项目介绍

Blasp 是一个为 Laravel 设计的不良言论过滤器包，它能够检测并遮蔽给定句子中的不当词汇。Blasp 提供了一系列强大的功能来处理各种不当言论的变体，包括字符替换、模糊字符和双倍字母等。

2. 项目快速启动

首先，确保你已经安装了 Laravel。然后通过以下步骤快速启动 Blasp 项目：

# 使用 Composer 安装 Blasp 包
composer require blaspsoft/blasp

# 发布配置文件
php artisan vendor:publish --tag="blasp-config"

# 配置文件位于 config/blasp.php，你可以在此自定义不良词汇列表

在控制器或服务中，你可以这样使用 Blasp：

use Blaspsoft\Blasp\Facades\Blasp;

$sentence = 'This is a fucking shit sentence.';
$blasp = Blasp::check($sentence);

// 获取原始字符串
echo $blasp->getSourceString(); // "This is a fucking shit sentence."

// 获取处理后的字符串
echo $blasp->getCleanString(); // "This is a ******* **** sentence."

// 检查是否含有不良词汇
echo $blasp->hasProfanity(); // true

// 获取不良词汇数量
echo $blasp->getProfanitiesCount(); // 2

// 获取找到的不良词汇列表
print_r($blasp->getUniqueProfanitiesFound()); // ['fucking', 'shit']

3. 应用案例和最佳实践

使用 Blasp 验证表单输入是一个常见场景。以下是一个如何在控制器中使用 Blasp 验证规则来验证表单数据的例子：

use Illuminate\Http\Request;

$request->merge([
    'sentence' => 'This is f u c k 1 n g awesome!'
]);

$validated = $request->validate([
    'sentence' => ['blasp_check']
]);

此外，你还可以自定义不良词汇和误报列表来适应特定的场景，比如用户名验证：

use Blaspsoft\Blasp\Facades\Blasp;

$blasp = Blasp::configure([
    'profanities' => $your_custom_profanities,
    'falsePositives' => $your_custom_false_positives
])->check($text);

4. 典型生态项目

Blasp 可以与其他 Laravel 生态系统中的项目一起使用，例如：

• 使用 Laravel 的缓存系统来提高性能。
• 集成 Laravel 验证系统，为表单输入提供不良词汇验证。
• 通过 Artisan 命令清除缓存，保持应用运行高效。

以上就是关于 Blasp 的简单介绍和快速启动指南，你可以根据实际需求进一步自定义和优化。