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

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

koala-framework/file-watcher
============================

Library for watching for file system changes

v1.0.1(10y ago)1339.5k↑71.4%7[1 issues](https://github.com/koala-framework/file-watcher/issues)[1 PRs](https://github.com/koala-framework/file-watcher/pulls)1BSD-2-ClausePHP

Since Apr 26Pushed 12mo ago11 watchersCompare

[ Source](https://github.com/koala-framework/file-watcher)[ Packagist](https://packagist.org/packages/koala-framework/file-watcher)[ Docs](http://www.koala-framework.org/)[ RSS](/packages/koala-framework-file-watcher/feed)WikiDiscussions 2.0 Synced 2d ago

READMEChangelog (2)Dependencies (7)Versions (5)Used By (1)

File Watcher Php Library [![Build Status](https://camo.githubusercontent.com/b331a580078a703d7bcab362fac989c84f761fb8749da453663ca08d8b164152/68747470733a2f2f7472617669732d63692e6f72672f6b6f616c612d6672616d65776f726b2f66696c652d776174636865722e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/koala-framework/file-watcher)
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

[](#file-watcher-php-library-)

Php library for watching for file system changes.

Supports different backends for best cross platform usage.

### Backends

[](#backends)

- [watchmedo](https://pythonhosted.org/watchdog/) (Cross platform pything shell utility)
- [fswatch](http://emcrisostomo.github.io/fswatch/) (Cross-platform file change monitor with multiple backends)
- [inotifywait](http://linux.die.net/man/1/inotifywait) (Linux shell utility)
- [inotify](http://php.net/manual/en/book.inotify.php) (Php PECL extension)
- Polling fallback (Slow)

### Requirements

[](#requirements)

- Php 5.3+

### Installation

[](#installation)

Install using composer:

```
composer require koala-framework/file-watcher

```

### Example Usage

[](#example-usage)

```
$watcher = Kwf\FileWatcher\Watcher::create('.');
$watcher->addListener(Kwf\FileWatcher\Events::MODIFY, function($e) {
    var_dump($e->filename);
});
$watcher->start();

```

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance35

Infrequent updates — may be unmaintained

Popularity36

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 88.6% 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 ~971 days

Total

4

Last Release

807d ago

Major Versions

v1.0.1 → 2.0.x-dev2024-04-18

### Community

Maintainers

![](https://www.gravatar.com/avatar/395b4eb64319fa0febc26d2105ba5d7989eab16a9e8b1bb245f8705d1fb9ddac?d=identicon)[nsams](/maintainers/nsams)

![](https://avatars.githubusercontent.com/u/1013756?v=4)[Franz Unger](/maintainers/fraxachun)[@fraxachun](https://github.com/fraxachun)

---

Top Contributors

[![nsams](https://avatars.githubusercontent.com/u/50764?v=4)](https://github.com/nsams "nsams (39 commits)")[![mennoxx](https://avatars.githubusercontent.com/u/17993921?v=4)](https://github.com/mennoxx "mennoxx (4 commits)")[![paha77](https://avatars.githubusercontent.com/u/5096366?v=4)](https://github.com/paha77 "paha77 (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[matomo/matomo

Matomo is the leading Free/Libre open analytics platform

21.7k38.9k](/packages/matomo-matomo)[civicrm/civicrm-core

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

751291.4k43](/packages/civicrm-civicrm-core)[laravel/framework

The Laravel Framework.

34.8k543.8M20.1k](/packages/laravel-framework)[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)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

21866.0M1.7k](/packages/drupal-core)[friendsofphp/php-cs-fixer

A tool to automatically fix PHP code style

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

PHPackages © 2026

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