PHPackages andrey-helldar/blacklist-client - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. andrey-helldar/blacklist-client Abandoned → [johannebert/laravel-spam-protector](/?search=johannebert%2Flaravel-spam-protector)ArchivedLibrary andrey-helldar/blacklist-client =============================== The blacklist client package for connecting to the Blacklist Server v2.2.1(5y ago)2147MITPHPPHP ^7.1.3|^8.0 Since Sep 14Pushed 5y ago1 watchersCompare [ Source](https://github.com/andrey-helldar/blacklist-client)[ Packagist](https://packagist.org/packages/andrey-helldar/blacklist-client)[ RSS](/packages/andrey-helldar-blacklist-client/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (2)Versions (18)Used By (0) Blacklist client ================ [](#blacklist-client) The blacklist client package for connecting to the Blacklist Server. [![blacklist client](https://user-images.githubusercontent.com/10347617/64910390-93ca2500-d71e-11e9-8885-a1682298b78f.png)](https://user-images.githubusercontent.com/10347617/64910390-93ca2500-d71e-11e9-8885-a1682298b78f.png) [![StyleCI](https://camo.githubusercontent.com/a67c7d7b25e2986c48951dd77331eb19879f7c1b5130c5baf8a549cc704535ee/68747470733a2f2f7374796c6563692e696f2f7265706f732f3230363831353436382f736869656c64)](https://styleci.io/repos/206815468) [![Total Downloads](https://camo.githubusercontent.com/b3d47aaa06152dcfd79779aadf72df2dd41859754695e09ad2233a16b43bab30/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f616e647265792d68656c6c6461722f626c61636b6c6973742d636c69656e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/andrey-helldar/blacklist-client) [![Latest Stable Version](https://camo.githubusercontent.com/df7ac2a0b13a8d8c70e9e3469dab43d11b13d73022c4ee60bb82f8ec728c861b/68747470733a2f2f706f7365722e707567782e6f72672f616e647265792d68656c6c6461722f626c61636b6c6973742d636c69656e742f762f737461626c653f666f726d61743d666c61742d737175617265)](https://packagist.org/packages/andrey-helldar/blacklist-client) [![Latest Unstable Version](https://camo.githubusercontent.com/4664fd761ee9a83c59eee277f9ef6c556af3f9181fb7ecb0c9a1929b118eeb13/68747470733a2f2f706f7365722e707567782e6f72672f616e647265792d68656c6c6461722f626c61636b6c6973742d636c69656e742f762f756e737461626c653f666f726d61743d666c61742d737175617265)](https://packagist.org/packages/andrey-helldar/blacklist-client) [![License](https://camo.githubusercontent.com/61db314bc1cd359ccf59db9c99446794cfc816b5375f9f09dad6b532d45173d8/68747470733a2f2f706f7365722e707567782e6f72672f616e647265792d68656c6c6461722f626c61636b6c6973742d636c69656e742f6c6963656e73653f666f726d61743d666c61742d737175617265)](LICENSE) Content ------- [](#content) - [Installation](#installation) - [Using](#using) - [License](#license) Installation ------------ [](#installation) To get the latest version of Laravel Blacklist Client, simply require the project using [Composer](https://getcomposer.org): ``` composer require andrey-helldar/blacklist-client ``` Instead, you may of course manually update your require block and run `composer update` if you so choose: ``` { "require": { "andrey-helldar/blacklist-client": "^2.0" } } ``` Now, you can also publish the config file to change implementations (ie. interface to specific class): ``` php artisan vendor:publish --provider="Helldar\BlacklistClient\ServiceProvider" ``` Using ----- [](#using) First look at the [config](src/config/settings.php). ### check / exists [](#check--exists) To check the existence of a spammer in the database, you need to transfer the data type and value: ``` /* * DATABASE * foo@example.com - exists * bar@example.com - not exists */ use Helldar\BlacklistClient\Facades\Client; return Client::check('http://example.com'); // false return Client::check('192.168.1.1'); // false return Client::check('+0 (000) 000-00-00'); // false return Client::check('foo@example.com'); /* GuzzleHttp\Exception\ClientException with 423 code and content: * * {"error":{"code":400,"msg":["Checked foo@example.com was found in our database.]}} */ ``` For example: ``` use GuzzleHttp\Exception\ClientException; use Helldar\BlacklistClient\Facades\Client; class Foo { public function store(array $data) { if (! $this->isSpammer($data['email'])) { // storing data } } private function isSpammer(string $value): bool { try { return Client::check($value); } catch (ClientException $exception) { return true; } } } ``` ### store [](#store) To storing a spammer to the database, use the method `store` of the facade `Client`: ``` use Helldar\BlacklistClient\Facades\Client; return Client::store('foo@example.com', 'email'); return Client::store('http://example.com', 'url'); return Client::store('192.168.1.1', 'ip'); return Client::store('+0 (000) 000-00-00', 'phone'); ``` For example: ``` use Helldar\BlacklistClient\Facades\Client; $item = Client::store('foo@example.com', 'email'); return $item->expired_at; // 2019-09-27 23:25:27 ``` License ------- [](#license) This package is released under the [MIT License](LICENSE). ### Health Score 31 — LowBetter than 68% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity13 Limited adoption so far Community7 Small or concentrated contributor base Maturity71 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~33 days Recently: every ~112 days Total 15 Last Release 1955d ago Major Versions v1.5.2 → v2.0.02019-10-07 PHP version history (2 changes)v1.0.0PHP ^7.1.3 v2.2.0PHP ^7.1.3|^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/b77790e612f1c9beed1e1533e36eba4954fbd6da2a5c9f71e845cd0f5465f0ad?d=identicon)[Helldar](/maintainers/Helldar) --- Top Contributors [![andrey-helldar](https://avatars.githubusercontent.com/u/10347617?v=4)](https://github.com/andrey-helldar "andrey-helldar (1 commits)") --- Tags laravelspamblacklistantispamanti-spam ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/andrey-helldar-blacklist-client/health.svg) ``` [![Health](https://phpackages.com/badges/andrey-helldar-blacklist-client/health.svg)](https://phpackages.com/packages/andrey-helldar-blacklist-client) ``` ### Alternatives [akaunting/laravel-firewall Web Application Firewall (WAF) package for Laravel 999465.8k2](/packages/akaunting-laravel-firewall)[msurguy/honeypot Honeypot spam prevention 4381.2M12](/packages/msurguy-honeypot)[cleantalk/php-antispam PHP API for antispam service cleantalk.org. Invisible protection from spam, no captches, no puzzles, no animals and no math. 70600.8k2](/packages/cleantalk-php-antispam)[nucleos/antispam-bundle This bundle provides some basic features to reduce spam in symfony forms. 52105.1k](/packages/nucleos-antispam-bundle)[s1syphos/php-simple-captcha Simple captcha generator 2737.8k6](/packages/s1syphos-php-simple-captcha) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)