Profanity filter package would help you censor some of the bad words users put in your posts and/or comments.

dev-master / 1.0.x-dev 2016-02-29 16:21 UTC

This package is not auto-updated.

Last update: 2024-04-05 17:43:01 UTC


Latest Version on Packagist Software License Build Status Quality Score Total Downloads

Profanity Filter takes strings as input and removes any bad curse words that the string might have. It check the string for specific blacklist which must match as a sperate word to be considered as a curse word. If a curse word is found, then it will replace the curse word with a censor character the user chooses (default is *).

Default curse words from Shuttershock list of banned words

This package is intended to used with Laravel. Tested and working with laravel 5.1.

This code is based on Fastwebmedia/Profanity-Filter. A major part of it is taken from there and I added the things that I thought it required.


Via Composer

$ composer require LinkThrow/profanityfilter

###Laravel Add LinkThrow\ProfanityFilter\ProfanityFilterServiceProvider::class to your providers array.

If you wish to use the Facade then add 'Profanity' => LinkThrow\ProfanityFilter\Facades\Profanity::class

The package will automatically use the config file containing the list of banned words.


$swear_word = ['dog'];
$blacklist  = ['puppy'];
$replace    = ['a' => '(a|a\.|a\-|4|@|Á|á|À|Â|à|Â|â|Ä|ä|Ã|ã|Å|å|α|Δ|Λ|λ)'];

$profanity_filter = new LinkThrow\ProfanityFilter($swear_words, $blacklist, $replace);
echo $profanity_filter->clean('Dog, puppy badpuppy baddog!', '$');

The above code would return:

    'old_string' => 'Dog, puppy badpuppy baddog!',
    'new_string' => '$$$, $$$$$ badpuppy bad$$$!',
    'clean'      => false

Change log

Please see CHANGELOG for more information what has changed recently.


$ phpspec run


Please see CONTRIBUTING and CONDUCT for details.


If you discover any security related issues, please email instead of using the issue tracker.



The MIT License (MIT). Please see License File for more information.