PHPackages                             acelaya/crawler-detect - 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. [Utility & Helpers](/categories/utility)
4. /
5. acelaya/crawler-detect

Abandoned → [jaybizzle/crawler-detect](/?search=jaybizzle%2Fcrawler-detect)Library[Utility & Helpers](/categories/utility)

acelaya/crawler-detect
======================

Fork of https://github.com/JayBizzle/Crawler-Detect/ with PHP 8.4 warnings fixed

v1.3.0(1y ago)0588MITPHPPHP >=7.1.0

Since Nov 24Pushed 1y agoCompare

[ Source](https://github.com/acelaya-forks/Crawler-Detect)[ Packagist](https://packagist.org/packages/acelaya/crawler-detect)[ Docs](https://github.com/JayBizzle/Crawler-Detect/)[ RSS](/packages/acelaya-crawler-detect/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (1)Versions (2)Used By (0)

[![](https://cloud.githubusercontent.com/assets/340752/23082173/1bd1a396-f550-11e6-8aba-4d3c75edea2f.png)](https://crawlerdetect.io/)

[crawlerdetect.io](https://crawlerdetect.io/)

[![GitHub Workflow Status](https://camo.githubusercontent.com/c01889cc2b4b5551f8861257d7a92486ae4646a08b0c04d9fded1996b287762c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f4a617942697a7a6c652f437261776c65722d4465746563742f746573742e796d6c3f6272616e63683d6d6173746572267374796c653d666c61742d737175617265)](https://github.com/JayBizzle/Crawler-Detect/actions)[![](https://camo.githubusercontent.com/2947fafedf41c6bf135767f76f34987e00c1e9ad94bd985758e637ef8e10075d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f4a617942697a7a6c652f437261776c65722d4465746563742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/jaybizzle/crawler-detect)[![](https://camo.githubusercontent.com/360b208796a03823093e2dbfb745907ee0e267396acf4953c4fc70e38b193c46/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d6666363962342e7376673f7374796c653d666c61742d737175617265)](https://github.com/JayBizzle/Crawler-Detect)[![](https://camo.githubusercontent.com/a8454bacd6c64484fd652d601f144327a954a34d7556b0c0f659477ca3bec84a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6a617962697a7a6c652f437261776c65722d4465746563742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/jaybizzle/crawler-detect)[![](https://camo.githubusercontent.com/c029450653d567865640242b05a8769da4072416e00aa62bc902486ea7602efd/68747470733a2f2f696d672e736869656c64732e696f2f636f766572616c6c732f4a617942697a7a6c652f437261776c65722d4465746563742f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://coveralls.io/github/JayBizzle/Crawler-Detect)

About CrawlerDetect
-------------------

[](#about-crawlerdetect)

CrawlerDetect is a PHP class for detecting bots/crawlers/spiders via the `user agent` and `http_from` header. Currently able to detect 1,000's of bots/spiders/crawlers.

### Installation

[](#installation)

```
composer require jaybizzle/crawler-detect

```

### Usage

[](#usage)

```
use Jaybizzle\CrawlerDetect\CrawlerDetect;

$CrawlerDetect = new CrawlerDetect;

// Check the user agent of the current 'visitor'
if($CrawlerDetect->isCrawler()) {
    // true if crawler user agent detected
}

// Pass a user agent as a string
if($CrawlerDetect->isCrawler('Mozilla/5.0 (compatible; Sosospider/2.0; +http://help.soso.com/webspider.htm)')) {
    // true if crawler user agent detected
}

// Output the name of the bot that matched (if any)
echo $CrawlerDetect->getMatches();
```

### Contributing

[](#contributing)

If you find a bot/spider/crawler user agent that CrawlerDetect fails to detect, please submit a pull request with the regex pattern added to the `$data` array in `Fixtures/Crawlers.php` and add the failing user agent to `tests/crawlers.txt`.

Failing that, just create an issue with the user agent you have found, and we'll take it from there :)

### Laravel Package

[](#laravel-package)

If you would like to use this with Laravel, please see [Laravel-Crawler-Detect](https://github.com/JayBizzle/Laravel-Crawler-Detect)

### Symfony Bundle

[](#symfony-bundle)

To use this library with Symfony 2/3/4, check out the [CrawlerDetectBundle](https://github.com/nicolasmure/CrawlerDetectBundle).

### YII2 Extension

[](#yii2-extension)

To use this library with the YII2 framework, check out [yii2-crawler-detect](https://github.com/AlikDex/yii2-crawler-detect).

### ES6 Library

[](#es6-library)

To use this library with NodeJS or any ES6 application based, check out [es6-crawler-detect](https://github.com/JefferyHus/es6-crawler-detect).

### Python Library

[](#python-library)

To use this library in a Python project, check out [crawlerdetect](https://github.com/moskrc/CrawlerDetect).

### JVM Library (written in Java)

[](#jvm-library-written-in-java)

To use this library in a JVM project (including Java, Scala, Kotlin, etc.), check out [CrawlerDetect](https://github.com/nekosoftllc/crawler-detect).

### .NET Library

[](#net-library)

To use this library in a .net standard (including .net core) based project, check out [NetCrawlerDetect](https://github.com/gplumb/NetCrawlerDetect).

### Ruby Gem

[](#ruby-gem)

To use this library with Ruby on Rails or any Ruby-based application, check out [crawler\_detect](https://github.com/loadkpi/crawler_detect) gem.

### Go Module

[](#go-module)

To use this library with Go, check out the [crawlerdetect](https://github.com/x-way/crawlerdetect) module.

*Parts of this class are based on the brilliant [MobileDetect](https://github.com/serbanghita/Mobile-Detect)*

[![Analytics](https://camo.githubusercontent.com/09dde57e6fafde2743475af0e95cb46b5b126d04f86f972351828c9962cab6ad/68747470733a2f2f67612d626561636f6e2e61707073706f742e636f6d2f55412d37323433303436352d312f437261776c65722d4465746563742f726561646d653f706978656c)](https://github.com/JayBizzle/Crawler-Detect)

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance38

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 Bus Factor1

Top contributor holds 73.2% 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

Unknown

Total

1

Last Release

533d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/73480af83259e096d154a8c4333e550c186b28ccb7a0d11f537b9aa57ad35392?d=identicon)[acelaya](/maintainers/acelaya)

---

Top Contributors

[![JayBizzle](https://avatars.githubusercontent.com/u/340752?v=4)](https://github.com/JayBizzle "JayBizzle (592 commits)")[![MaxGiting](https://avatars.githubusercontent.com/u/9828591?v=4)](https://github.com/MaxGiting "MaxGiting (89 commits)")[![GC-Mark](https://avatars.githubusercontent.com/u/1477806?v=4)](https://github.com/GC-Mark "GC-Mark (27 commits)")[![x-way](https://avatars.githubusercontent.com/u/53128?v=4)](https://github.com/x-way "x-way (24 commits)")[![Bilge](https://avatars.githubusercontent.com/u/470626?v=4)](https://github.com/Bilge "Bilge (7 commits)")[![acelaya](https://avatars.githubusercontent.com/u/2719332?v=4)](https://github.com/acelaya "acelaya (5 commits)")[![chopsol](https://avatars.githubusercontent.com/u/12293848?v=4)](https://github.com/chopsol "chopsol (5 commits)")[![clementmas](https://avatars.githubusercontent.com/u/8032241?v=4)](https://github.com/clementmas "clementmas (5 commits)")[![doggieliu](https://avatars.githubusercontent.com/u/66601667?v=4)](https://github.com/doggieliu "doggieliu (4 commits)")[![castevinz](https://avatars.githubusercontent.com/u/1838350?v=4)](https://github.com/castevinz "castevinz (4 commits)")[![Krakozaber](https://avatars.githubusercontent.com/u/2918147?v=4)](https://github.com/Krakozaber "Krakozaber (4 commits)")[![JefferyHus](https://avatars.githubusercontent.com/u/3521144?v=4)](https://github.com/JefferyHus "JefferyHus (3 commits)")[![IT-Joris](https://avatars.githubusercontent.com/u/122261387?v=4)](https://github.com/IT-Joris "IT-Joris (3 commits)")[![loadkpi](https://avatars.githubusercontent.com/u/17227196?v=4)](https://github.com/loadkpi "loadkpi (3 commits)")[![cwhsu1984](https://avatars.githubusercontent.com/u/1912413?v=4)](https://github.com/cwhsu1984 "cwhsu1984 (3 commits)")[![MikeVL](https://avatars.githubusercontent.com/u/118285?v=4)](https://github.com/MikeVL "MikeVL (3 commits)")[![peter279k](https://avatars.githubusercontent.com/u/9021747?v=4)](https://github.com/peter279k "peter279k (3 commits)")[![orynider](https://avatars.githubusercontent.com/u/433770?v=4)](https://github.com/orynider "orynider (2 commits)")[![timersys](https://avatars.githubusercontent.com/u/1206915?v=4)](https://github.com/timersys "timersys (2 commits)")[![alberto-bottarini](https://avatars.githubusercontent.com/u/1442934?v=4)](https://github.com/alberto-bottarini "alberto-bottarini (2 commits)")

---

Tags

crawlercrawler detectcrawler detectorphp crawler detectcrawlerdetect

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/acelaya-crawler-detect/health.svg)

```
[![Health](https://phpackages.com/badges/acelaya-crawler-detect/health.svg)](https://phpackages.com/packages/acelaya-crawler-detect)
```

###  Alternatives

[jaybizzle/crawler-detect

CrawlerDetect is a PHP class for detecting bots/crawlers/spiders via the user agent

2.3k96.7M215](/packages/jaybizzle-crawler-detect)[jaybizzle/laravel-crawler-detect

A Laravel package to detect web crawlers via the user agent

3232.6M17](/packages/jaybizzle-laravel-crawler-detect)[wa72/htmlpagedom

jQuery-inspired DOM manipulation extension for Symfony's Crawler

3383.9M34](/packages/wa72-htmlpagedom)[vdb/php-spider

A configurable and extensible PHP web spider

1.4k181.0k7](/packages/vdb-php-spider)[crwlr/crawler

Web crawling and scraping library.

37214.8k2](/packages/crwlr-crawler)[friends-of-hyva/magento2-crawler-session

Prevent crawlers from creating a session

155.8k](/packages/friends-of-hyva-magento2-crawler-session)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)