PHPackages coercive/botkicker - 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. [Security](/categories/security) 4. / 5. coercive/botkicker ActiveLibrary[Security](/categories/security) coercive/botkicker ================== Coercive Security BotKicker 0.0.80(1mo ago)0677MITPHPPHP >=7.4 Since Feb 15Pushed 1mo ago1 watchersCompare [ Source](https://github.com/Coercive/BotKicker)[ Packagist](https://packagist.org/packages/coercive/botkicker)[ RSS](/packages/coercive-botkicker/feed)WikiDiscussions master Synced 2d ago READMEChangelog (10)Dependencies (2)Versions (81)Used By (0) Coercive Security BotKicker =========================== [](#coercive-security-botkicker) A simple detection based on black list Get --- [](#get) ``` composer require coercive/botkicker ``` List infos ---------- [](#list-infos) - PERISHABLE PRESS ULTIMATE USER-AGENT BLACKLIST - PERISHABLE PRESS ULTIMATE REFERRER BLACKLIST - CHONGQED REFERER BLACKLIST - MITCHELL KROG - BlackList file from apache set Warning info ------------ [](#warning-info) Some terms where placed in ambiguous list because of too large detection. You can find this ambiguous file are in each list directory. (work in progress) Kicker system ------------- [](#kicker-system) Basics ``` use Coercive\Security\BotKicker\UserAgentKicker; # Get Instance $kicker = new UserAgentKicker; // or othe kicker # Load a default list $kicker->loadCoerciveLists(); # or load custom list... # Basic bot detection if(!$kicker->detect()->getStatus()) { echo 'a bot is detected'; } else { # True if in whitelist or not in blacklist } ``` You can detect if UA need the robots.txt ``` if($kicker->isRobotsTxtRequested()) { /* do something */ } ``` (Dis)Allow empty ---------------- [](#disallow-empty) ``` # You can (dis)allow empty current detection $kicker->allowEmpty( true | false ); ``` IpKicker only ------------- [](#ipkicker-only) You can use the auto IP detection from IpKicker ``` # Get auto Ip list detection $list = (new IpKicker)->getCurrents(); ``` IpKicker can now detect Facebookbot and Bingbot ``` # Get auto Ip list detection $ipk = new IpKicker; $list = $ipk->getFacebookList(); $list = $ipk->isBing('157.55.39.1', true | false); # Linux Host cmd (true) / NsLookUp (false) ``` Trigger on custom element ------------------------- [](#trigger-on-custom-element) ``` # Example of custom datas $datas = ['bot1', 'bot2', 'bot3']; # Override auto detection $kicker->setCurrents($datas); # Show detection result $status = $kicker->detect(); var_dump( $status->getList() ); ``` Handle custom list ------------------ [](#handle-custom-list) You can set your own list (array format) ``` $kicker->setBlackList([ 'bad', 'bad too' ]); $kicker->setWhiteList([ 'good', 'good too' ]); ``` Or from file (txt brut format) ``` $kicker->setBlackListFromFiles([ '/path/file1', '/path/file2' ]); $kicker->setWhiteListFromFiles([ '/path/file1', '/path/file2' ]); ``` If some list are already loaded, you can add some items like that ``` $kicker->addToBlackList([ 'bad', 'bad too' ]); $kicker->addToWhiteList([ 'good', 'good too' ]); ``` Handle custom elements to verify -------------------------------- [](#handle-custom-elements-to-verify) ``` # Example of custom datas $datas = ['bot1', 'bot2', 'bot3']; # Override auto detection $kicker->setCurrents($datas); # Show detection result $status = $kicker->detect(); var_dump( $status->getStatus() ); # bool if ok or not var_dump( $status->getList() ); # array list of match elements var_dump( $status->getCurrents() ); # array current datas ``` Host / Ns Look Up ----------------- [](#host--ns-look-up) Get the domains list from IP ``` use Coercive\Security\BotKicker\HostLookUp; use Coercive\Security\BotKicker\NsLookUp; $look = new HostLookUp; # OR $look = new NsLookUp; $array = $look->getDomains('111.22.33.4'); ``` Get the ip list from domain ``` use Coercive\Security\BotKicker\HostLookUp; use Coercive\Security\BotKicker\NsLookUp; $look = new HostLookUp; # OR $look = new NsLookUp; $array = $look->getIps('www.example.com.'); ``` Match item ``` use Coercive\Security\BotKicker\HostLookUp; use Coercive\Security\BotKicker\NsLookUp; $look = new HostLookUp; # OR $look = new NsLookUp; # Match ip > domain $array = $look->match('111.22.33.4', 'www.example.com.'); # OR mactch with reverse (match ip > domain first and domain > ip after) $array = $look->match('111.22.33.4', 'www.example.com.', true); ``` ### Health Score 49 — FairBetter than 95% of packages Maintenance93 Actively maintained with recent releases Popularity13 Limited adoption so far Community7 Small or concentrated contributor base Maturity68 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 ~37 days Recently: every ~61 days Total 80 Last Release 34d ago PHP version history (2 changes)0.0.1PHP >=7 0.0.8PHP >=7.4 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/20288080?v=4)[Coercive](/maintainers/Coercive)[@Coercive](https://github.com/Coercive) --- Top Contributors [![Coercive](https://avatars.githubusercontent.com/u/20288080?v=4)](https://github.com/Coercive "Coercive (508 commits)") ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/coercive-botkicker/health.svg) ``` [![Health](https://phpackages.com/badges/coercive-botkicker/health.svg)](https://phpackages.com/packages/coercive-botkicker) ``` ### Alternatives [defuse/php-encryption Secure PHP Encryption Library 3.9k162.4M214](/packages/defuse-php-encryption)[roave/security-advisories Prevents installation of composer packages with known security vulnerabilities: no API, simply require it 2.9k97.3M6.4k](/packages/roave-security-advisories)[mews/purifier Laravel 5/6/7/8/9/10 HtmlPurifier Package 2.0k16.7M113](/packages/mews-purifier)[robrichards/xmlseclibs A PHP library for XML Security 41278.1M118](/packages/robrichards-xmlseclibs)[bjeavons/zxcvbn-php Realistic password strength estimation PHP library based on Zxcvbn JS 86917.5M63](/packages/bjeavons-zxcvbn-php)[enlightn/security-checker A PHP dependency vulnerabilities scanner based on the Security Advisories Database. 33732.2M110](/packages/enlightn-security-checker) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)