Download the PHP package diego-ninja/banthis without Composer

On this page you can find all versions of the php package diego-ninja/banthis. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package banthis

BanThis - A censor and word filtering library for PHP 8.2+

Latest Version on Packagist Total Downloads PHP Version License: MIT GitHub last commit Hits-of-Code wakatime

BanThis is a PHP package for profanity filtering. The PHP script uses regex to intelligently look for "leetspeak"-style numeric or symbol replacements.

This package is an evolution of snipe/banbuilder adapted and refactored to modern php versions.

📦 Installation

To install BanThis, simply include it in your projects's composer.json.

"diego-ninja/banthis": "^1",

There are no additional dependencies required for this package to work.

🚀 Usage

Setting the Dictionary

You can set or add dictionaries to the Censor instance.

Adding words from an array

You can add words directly from an array.

Managing the whitelist

You can add words to the whitelist to exclude them from being censored.

Setting the replacement character

You can set the character or string that will replace the censored words.

⚙️ How it works

In a nutshell, this code takes an array of bad words and compares it to an array of common filter-evasion tactics. It then does a string replacement to insert regex parameters into your badwords array, and then evaluates your input string to that expanded banned word list.

So in your bad words array, you might have:

 [0] => 'ass'

The preg_replace functions replace all of the possible shenanigan letters with regex patterns (in lieu of adding the variants onto the end of the array), so the 'ass' in your array gets turned into this, right before the preg_replace checks for matches:

 [0] => /(a|a\.|a\-|4|@|Á|á|À|Â|à|Â|â|Ä|ä|Ã|ã|Å|å|α)(s|s\.|s\-|5|\$|§)(s|s\.|s\-|5|\$|§)/i

This means that a word can have none, one or any variety of leet replacements and it will still trip the trigger. Part of the leet filter includes stripping out letter-dash and letter-dots.

This means that the following all evaluate to the "bitch":

🔬 Tests

To run the unit tests on this package, simply run vendor/bin/phpunit from the package directory.

🙏 Credits

This project is developed and maintained by 🥷 Diego Rin in his free time.

Special thanks to:

If you find this project useful, please consider giving it a ⭐ on GitHub!


All versions of banthis with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package diego-ninja/banthis contains the following files

Loading the files please wait ....