divineomega/laravel-offensive-validation-rule

Laravel validation rule that checks if a string is offensive.

v1.3.0 2020-03-21 20:47 UTC

Requires

• divineomega/is_offensive: ^1.4.0
• laravel/framework: ^5.5||^6.0||^7.0

Requires (Dev)

• orchestra/testbench: ^3.5
• phpunit/phpunit: ^6.0
• satooshi/php-coveralls: ^2.0

LGPL-3.0-only

• Jordan Hall

README

This package provides a Laravel validation rule that checks if a string is offensive. It can be useful to check user supplied data that may be publicly displayed, such as usernames or comments.

Installation

To install, just run the following Composer command.

composer require divineomega/laravel-offensive-validation-rule

Please note that this package requires Laravel 5.5 or above.

Usage

The following code snippet shows an example of how to use the offensive validation rule.

use DivineOmega\LaravelOffensiveValidationRule\Offensive;

$request->validate([
    'username' => ['required', new Offensive],
]);

Custom word lists

If the defaults are too strict (or not strict enough), you can optionally specify a custom list of offensive words and custom whitelist. Below is an example of using a custom blacklist and whitelist.

use DivineOmega\LaravelOffensiveValidationRule\Offensive;
use DivineOmega\IsOffensive\OffensiveChecker;

$blacklist = ['moist', 'stinky', 'poo'];
$whitelist = ['poop'];

$request->validate([
    'username' => ['required', new Offensive(new OffensiveChecker($blacklist, $whitelist))],
]);