A symfony bundle to test if a string has a profanity in it.
Straight matching Checks string for profanity as it is against list of bad words. E.g. badword
Substitution Checks string for profanity with characters substituted for each letter. E.g. bâdΨ0rd
Obscured Checks string for profanity obscured with punctuation between. E.g. b|a|d|w|o|r|d
Combinations Also works with combinations of the above. E.g. b|â|d|Ψ|0|rr|d
- Install this package via composer.
php composer.phar require vangrg/profanity-bundle
- Add to your AppKernel.php:
new Vangrg\ProfanityBundle\VangrgProfanityBundle(),
- If you want to use a database to store your profanities:
php bin/console doctrine:schema:update --force
- For populate default profanities data:
php bin/console vangrg:profanities:populate
<?php
$check = $this->get('vangrg_profanity.checker');
$hasProfanity = $check->hasProfanity($badWords);
$cleanWords = $check->obfuscateIfProfane($badWords);
/* customized word list from array */
$badWords = array('bad', 'words');
/* or load from db */
$badWords = $this->getDoctrine()->getManagerForClass(Profanity::class)
->getRepository(Profanity::class)
->getProfanitiesArray();
$this->get('vangrg_profanity.storage')->setProfanities($badWords);
By default, the profanity checker will remove obscured characters from a string.
For example, it will treat the follow as the same:
badword
b|a d$w?o!r-d
b|â|d|Ψ|0|r|d
This can cause some issues (false positive in put a logo
treated as puta logo
); call clearSeparatorExpression()
to prevent this.
$check = $this->get('vangrg_profanity.checker');
$check->clearSeparatorExpression();
# add to config.yml
vangrg_profanity:
storage: your service # By default use 'vangrg_profanity.storage.default', custom storage service must implement "Vangrg\ProfanityBundle\Storage\ProfanitiesStorageInterface"
allow_bound_by_words: true # Also match profanities inside words e.g. a.r.s.esomething, somethingarse, but be careful also words like glasses
profanities_source:
file_name: # your custom filename with profanities
format: # profanities source format (default yaml), can be yaml, json or xml
<?php
namespace AppBundle\Entity;
use Doctrine\ORM\Mapping as ORM;
use Symfony\Component\Validator\Constraints as Assert;
use Vangrg\ProfanityBundle\Validator\Constraints as ProfanityAssert;
/**
* Post
*
* @ORM\Table(name="post")
* @ORM\Entity(repositoryClass="AppBundle\Repository\PostRepository")
*/
class Post
{
/**
* @var int
*
* @ORM\Column(name="id", type="integer")
* @ORM\Id
* @ORM\GeneratedValue(strategy="AUTO")
*/
private $id;
/**
* @var string
*
* @Assert\Length(min=8, max=64)
* @ProfanityAssert\ProfanityCheck
* @ORM\Column(name="title", type="string", length=64)
*/
private $title;
}
Bundle is built on the basis of the library https://github.com/mofodojodino/ProfanityFilter with an improvement in the logic of the filter