PHPackages                             e2tmk/hunter - 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. [Search & Filtering](/categories/search)
4. /
5. e2tmk/hunter

ActiveLibrary[Search & Filtering](/categories/search)

e2tmk/hunter
============

Powerful utility for finding and processing Eloquent model records with a fluent, chainable API.

v1.2.3(9mo ago)151151[3 PRs](https://github.com/e2tmk/hunter/pulls)MITPHPPHP ^8.2CI passing

Since Jun 25Pushed 1mo agoCompare

[ Source](https://github.com/e2tmk/hunter)[ Packagist](https://packagist.org/packages/e2tmk/hunter)[ Docs](https://github.com/e2tmk/hunter)[ GitHub Sponsors](https://github.com/e2tmk)[ RSS](/packages/e2tmk-hunter/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)Dependencies (10)Versions (10)Used By (0)

 [![Hunter Logo](docs/public/Hunter_icon_purple-600.png)](docs/public/Hunter_icon_purple-600.png)

Hunter
======

[](#hunter)

[![Latest Version on Packagist](https://camo.githubusercontent.com/f6cbef044959d941d93163f4b223e0fd7c1f25337ff8e53ba124e784b87ac62e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6532746d6b2f68756e7465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/e2tmk/hunter)[![Total Downloads](https://camo.githubusercontent.com/d54ba211ca67b12b916098c1897a7fc1efaf7754b027323882a9b8ca8012aef1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6532746d6b2f68756e7465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/e2tmk/hunter)[![License](https://camo.githubusercontent.com/bb3f9407acf00fb2aa97a5034cfdda28576b898dea32e9a695f198be9f0498b5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6532746d6b2f736b656c65746f6e2d6d6f64756c652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/e2tmk/skeleton-module)

Powerful utility for finding and processing Eloquent model records with a fluent, chainable API.

Hunter provides a clean way to search for records based on specific criteria and execute multiple actions on them with comprehensive error handling, logging, and advanced flow control.

Installation
------------

[](#installation)

You can install the package via Composer:

```
composer require e2tmk/hunter
```

Quick Example
-------------

[](#quick-example)

```
use Hunter\Hunter;

// Process all pending orders
$result = hunter(Order::class)
    ->find('status', 'pending')
    ->then(function (Order $order) {
        $order->process();
    })
    ->hunt();

echo $result->summary(); // "Total: 15, Successful: 14, Failed: 1, Skipped: 0"
```

Features
--------

[](#features)

- 🔍 **Powerful Search**: Find records with flexible criteria
- 🔗 **Fluent API**: Chainable methods for clean code
- 🎯 **Multiple Actions**: Execute several actions per record
- ⚡ **Flow Control**: Skip, fail, or stop processing gracefully
- 📊 **Comprehensive Reporting**: Detailed statistics and error tracking

Documentation
-------------

[](#documentation)

📖 **[Complete Documentation](https://hunter.e2tmk.com)**

- [Getting Started](https://hunter.e2tmk.com)
- [Usage Examples](https://hunter.e2tmk.com/examples)
- [API Reference](https://hunter.e2tmk.com/api)

License
-------

[](#license)

The project is licensed under the [MIT License](LICENSE.md).

###  Health Score

43

—

FairBetter than 91% of packages

Maintenance75

Regular maintenance activity

Popularity19

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 61.8% 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 ~10 days

Total

5

Last Release

287d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/09cc8aa00be01687e2f2874430cacfe4fbb82306b738f9595e2489fd4926679d?d=identicon)[olivtradet](/maintainers/olivtradet)

---

Top Contributors

[![andrefelipe18](https://avatars.githubusercontent.com/u/96439642?v=4)](https://github.com/andrefelipe18 "andrefelipe18 (21 commits)")[![edeoliv](https://avatars.githubusercontent.com/u/76831154?v=4)](https://github.com/edeoliv "edeoliv (8 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)")[![kayedspace](https://avatars.githubusercontent.com/u/115418091?v=4)](https://github.com/kayedspace "kayedspace (1 commits)")

---

Tags

advanced-search-and-filteringchainable-apie2tmklaravelhuntere2tmk

###  Code Quality

TestsPest

Static AnalysisRector

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/e2tmk-hunter/health.svg)

```
[![Health](https://phpackages.com/badges/e2tmk-hunter/health.svg)](https://phpackages.com/packages/e2tmk-hunter)
```

###  Alternatives

[spatie/laravel-site-search

A site search engine

300129.1k](/packages/spatie-laravel-site-search)[hirethunk/verbs

An event sourcing package that feels nice.

513162.9k6](/packages/hirethunk-verbs)[nativephp/mobile

NativePHP for Mobile

82724.0k43](/packages/nativephp-mobile)[wnx/laravel-backup-restore

A package to restore database backups made with spatie/laravel-backup.

203330.1k2](/packages/wnx-laravel-backup-restore)[vormkracht10/laravel-mails

Laravel Mails can collect everything you might want to track about the mails that has been sent by your Laravel app.

24149.7k](/packages/vormkracht10-laravel-mails)[nativephp/desktop

NativePHP for Desktop

34020.6k3](/packages/nativephp-desktop)

PHPackages © 2026

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