https://github.com/blaspsoft/blasp
🤬 🚫 Blasp is a profanity filter package for Laravel that helps detect and mask profane words in a given sentence. It offers a robust set of features for handling variations of offensive language, including substitutions, obscured characters, and doubled letters.
https://github.com/blaspsoft/blasp
content-moderation laravel php profanity-check profanity-detection profanity-filter profanity-library profanity-validator profanityfilter
Last synced: 2 months ago
JSON representation
🤬 🚫 Blasp is a profanity filter package for Laravel that helps detect and mask profane words in a given sentence. It offers a robust set of features for handling variations of offensive language, including substitutions, obscured characters, and doubled letters.
- Host: GitHub
- URL: https://github.com/blaspsoft/blasp
- Owner: Blaspsoft
- License: mit
- Created: 2024-10-19T19:06:34.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-02-27T21:59:48.000Z (5 months ago)
- Last Synced: 2025-05-15T12:03:40.740Z (2 months ago)
- Topics: content-moderation, laravel, php, profanity-check, profanity-detection, profanity-filter, profanity-library, profanity-validator, profanityfilter
- Language: PHP
- Homepage:
- Size: 198 KB
- Stars: 241
- Watchers: 2
- Forks: 17
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Blasp - Profanity Filter for Laravel
Blasp is a profanity filter package for Laravel that helps detect and mask profane words in a given sentence. It offers a robust set of features for handling variations of offensive language, including substitutions, obscured characters, and doubled letters.
## Installation
You can install the package via Composer:
```bash
composer require blaspsoft/blasp
```
## Usage
### Basic Usage
To use the profanity filter, simply call the `Blasp::check()` method with the sentence you want to check for profanity.
```php
use Blaspsoft\Blasp\Facades\Blasp;
$sentence = 'This is a fucking shit sentence';
$check = Blasp::check($sentence);
```
The returned object will contain the following properties:
- **sourceString**: The original string you passed.
- **cleanString**: The string with profanities masked (e.g., replaced with `*`).
- **hasProfanity**: A boolean indicating whether the string contains profanity.
- **profanitiesCount**: The number of profanities found.
- **uniqueProfanitiesFound**: An array of unique profanities found in the string.
### Example
```php
$sentence = 'This is a fucking shit sentence';
$blasp = Blasp::check($sentence);
$blasp->getSourceString(); // "This is a fucking shit sentence"
$blasp->getCleanString(); // "This is a ******* **** sentence"
$blasp->hasProfanity(); // true
$blasp->getProfanitiesCount(); // 2
$blasp->getUniqueProfanitiesFound(); // ['fucking', 'shit']
```
### Profanity Detection Types
Blasp can detect different types of profanities based on variations such as:
1. **Straight match**: Direct matches of profane words.
2. **Substitution**: Substituted characters (e.g., `pro0fán1ty`).
3. **Obscured**: Profanities with separators (e.g., `p-r-o-f-a-n-i-t-y`).
4. **Doubled**: Repeated letters (e.g., `pprrooffaanniittyy`).
5. **Combination**: Combinations of the above (e.g., `pp-rof@n|tty`).
### Laravel Validation Rule
Blasp also provides a custom Laravel validation rule called `blasp_check`, which you can use to validate form input for profanity.
#### Example
```php
$request->merge(['sentence' => 'This is f u c k 1 n g awesome!']);
$validated = $request->validate([
'sentence' => ['blasp_check'],
]);
```
### Configuration
Blasp uses a configuration file (`config/blasp.php`) to manage the list of profanities, separators, and substitutions. You can publish the configuration file using the following Artisan command:
```bash
php artisan vendor:publish --tag="blasp-config"
```
### Custom Configuration
You can specify custom profanity and false positive lists using the `configure()` method:
```php
use Blaspsoft\Blasp\Facades\Blasp;
$blasp = Blasp::configure(
profanities: $your_custom_profanities,
falsePositives: $your_custom_false_positives
)->check($text);
```
This is particularly useful when you need different profanity rules for specific contexts, such as username validation.
### Cache Management
Blasp uses Laravel's cache system to improve performance. The package automatically caches profanity expressions and their variations. To clear the cache, you can use the provided Artisan command:
```bash
php artisan blasp:clear
```
This command will clear all cached Blasp expressions and configurations.
## License
Blasp is open-sourced software licensed under the [MIT license](LICENSE).