PHPackages                             stikmanw/file-event-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. [File & Storage](/categories/file-storage)
4. /
5. stikmanw/file-event-watcher

ActiveLibarary[File & Storage](/categories/file-storage)

stikmanw/file-event-watcher
===========================

File system watcher allowing for observeable handlers when a directory changes or content of the directory changes.

v0.1.0(11y ago)3220MITPHPPHP >=5.3.0

Since Jun 24Pushed 11y ago1 watchersCompare

[ Source](https://github.com/stikmanw/Watcher)[ Packagist](https://packagist.org/packages/stikmanw/file-event-watcher)[ RSS](/packages/stikmanw-file-event-watcher/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (2)Versions (2)Used By (0)

Watcher [![Build Status](https://camo.githubusercontent.com/0b9cec6b728d65e3fca555494383e1a7cc0b67aacef8532c21e447ce50c899b7/68747470733a2f2f7365637572652e7472617669732d63692e6f72672f7374696b6d616e772f576174636865722e706e67)](http://travis-ci.org/stikmanw/Watcher)
========================================================================================================================================================================================================================================================================

[](#watcher--)

File system watcher allowing for observeable handlers when a directory changes or content of the directory changes.

Requirements
------------

[](#requirements)

- PHP 5.4 >=
- Linux Files System / Mac OSX tested
- Windows (untested)

Description
-----------

[](#description)

You used the file FileWatcher like you would use typical event listener. The main advantage to this class is it does not require installing any additional libraries and can simply be installed via composer and used immidiately. You can attach multiple listeners to the 3 main events:

- **CREATE** - File has been created
- **MODIFIED** - File has been changed (currently uses a md5 hash to identify change)
- **DELETE** - File has been deleted since last check

Example
-------

[](#example)

Attach to create events

```
use Stikman\FileWatcher;

$watcher = new FileWatcher("/tmp/mystuff");
$watcher->on(FileWatcher::CREATE, function() {
  // do stuff
});
```

Set the pulling interval

```
$watcher = new FileWatcher("/tmp/mystuff");
$watcher->setInterval(100); // 100 millioseconds to check disk defaults to 25ms
```

Custom pattern match against file system for monitoring configuration data

```
$watcher = new FileWatcher("/tmp/mystuff", "*.json");
```

License
-------

[](#license)

MIT

###  Health Score

25

—

LowBetter than 35% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity48

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

Unknown

Total

1

Last Release

4028d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/975346cf0dcc6361345bf8650d5da63b816d44b4f9e7bfa264ff8cac6c17acd1?d=identicon)[bdcarter42](/maintainers/bdcarter42)

---

Top Contributors

[![rv-bcarter](https://avatars.githubusercontent.com/u/34041945?v=4)](https://github.com/rv-bcarter "rv-bcarter (16 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[ccxt/ccxt

A cryptocurrency trading API with more than 100 exchanges in JavaScript / TypeScript / Python / C# / PHP / Go

43.2k341.0k1](/packages/ccxt-ccxt)[react/filesystem

Asynchronous filesystem abstraction.

141237.3k16](/packages/react-filesystem)

PHPackages © 2026

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