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.2k↓50%7[1 PRs](https://github.com/koala-framework/file-watcher/pulls)1BSD-2-ClausePHP

Since Apr 26Pushed 10mo 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 1mo 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

43

—

FairBetter than 91% of packages

Maintenance39

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

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

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[civicrm/civicrm-core

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

728272.9k20](/packages/civicrm-civicrm-core)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[drupal/core

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

19562.3M1.3k](/packages/drupal-core)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[wnx/laravel-stats

Get insights about your Laravel Project

1.8k1.8M7](/packages/wnx-laravel-stats)

PHPackages © 2026

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