PHPackages                             pkboom/file-watcher - 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. pkboom/file-watcher

ActiveLibrary[Utility & Helpers](/categories/utility)

pkboom/file-watcher
===================

Watch file changes

0.2.8(11mo ago)015.2k↓23%3MITPHPPHP ^8.1CI failing

Since Dec 18Pushed 11mo ago1 watchersCompare

[ Source](https://github.com/pkboom/file-watcher)[ Packagist](https://packagist.org/packages/pkboom/file-watcher)[ Docs](https://github.com/pkboom/file-watcher)[ RSS](/packages/pkboom-file-watcher/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (3)Versions (11)Used By (3)

Simple file watcher
===================

[](#simple-file-watcher)

Filewatcher is a simple file watcher. You can run a callback based on file changes.

```
use Pkboom\FileWatcher\FileWatcher;
use React\EventLoop\Loop;

$watcher = FileWatcher::create((new Finder())->in('dir')->files());
// or
$watcher = FileWatcher::create('/path/to/file');

Loop::addPeriodicTimer(1, function () use ($watcher) {
    $watcher->find()->whenChanged(function () {
        //
    });
});
```

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

[](#installation)

```
composer require pkboom/file-watcher
```

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance51

Moderate activity, may be stable

Popularity27

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

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

Recently: every ~302 days

Total

10

Last Release

348d ago

PHP version history (3 changes)0.1PHP ^8.0

0.2.6PHP ^8.2

0.2.8PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/a5c267544335ffc241b0287e8fe001a7c2cc8e466be886226fce5c744f2e1abe?d=identicon)[pkboom](/maintainers/pkboom)

---

Top Contributors

[![pkboom](https://avatars.githubusercontent.com/u/13960169?v=4)](https://github.com/pkboom "pkboom (35 commits)")

---

Tags

pkboomfile-watcher

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/pkboom-file-watcher/health.svg)

```
[![Health](https://phpackages.com/badges/pkboom-file-watcher/health.svg)](https://phpackages.com/packages/pkboom-file-watcher)
```

###  Alternatives

[wnx/laravel-stats

Get insights about your Laravel Project

1.8k1.8M7](/packages/wnx-laravel-stats)[symplify/monorepo-builder

Not only Composer tools to build a Monorepo.

5205.3M82](/packages/symplify-monorepo-builder)[coenjacobs/mozart

Composes all dependencies as a package inside a WordPress plugin

4723.6M20](/packages/coenjacobs-mozart)[illuminate/session

The Illuminate Session package.

9937.4M753](/packages/illuminate-session)[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

728272.9k20](/packages/civicrm-civicrm-core)[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

96374.6k23](/packages/friendsoftypo3-content-blocks)

PHPackages © 2026

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