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(1y ago)016.3k↓79.7%3MITPHPPHP ^8.1CI failing

Since Dec 18Pushed 1y 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 2d 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

38

—

LowBetter than 83% of packages

Maintenance47

Moderate activity, may be stable

Popularity25

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

394d 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

[composer/composer

Composer helps you declare, manage and install dependencies of PHP projects. It ensures you have the right stack everywhere.

29.5k196.2M3.1k](/packages/composer-composer)[friendsofphp/php-cs-fixer

A tool to automatically fix PHP code style

13.5k251.2M25.2k](/packages/friendsofphp-php-cs-fixer)[symfony/stimulus-bundle

Integration with your Symfony app & Stimulus!

17417.5M294](/packages/symfony-stimulus-bundle)[illuminate/session

The Illuminate Session package.

9939.3M849](/packages/illuminate-session)[friendsoftypo3/content-blocks

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

103519.9k53](/packages/friendsoftypo3-content-blocks)[civicrm/civicrm-core

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

751291.4k43](/packages/civicrm-civicrm-core)

PHPackages © 2026

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