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.3.0(2mo ago)151161[3 PRs](https://github.com/e2tmk/hunter/pulls)MITPHPPHP ^8.4CI passing

Since Jun 25Pushed 3mo 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 today

READMEChangelog (5)Dependencies (20)Versions (12)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

46

—

FairBetter than 92% of packages

Maintenance83

Actively maintained with recent releases

Popularity18

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity61

Established project with proven stability

 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 ~59 days

Recently: every ~73 days

Total

6

Last Release

78d ago

PHP version history (2 changes)v1.0.0PHP ^8.2

v1.3.0PHP ^8.4

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/20531676?v=4)[olivtradet](/maintainers/olivtradet)[@olivtradet](https://github.com/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-permission

Permission handling for Laravel 12 and up

12.9k102.4M1.4k](/packages/spatie-laravel-permission)[wnx/laravel-backup-restore

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

213420.1k2](/packages/wnx-laravel-backup-restore)[spatie/laravel-pdf

Create PDFs in Laravel apps

1.0k4.8M47](/packages/spatie-laravel-pdf)[laravel/ai

The official AI SDK for Laravel.

1.0k3.2M194](/packages/laravel-ai)[dedoc/scramble

Automatic generation of API documentation for Laravel applications.

2.1k11.2M100](/packages/dedoc-scramble)[nativephp/mobile

NativePHP for Mobile

1.1k75.1k91](/packages/nativephp-mobile)

PHPackages © 2026

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