PHPackages dreadnip/php-inotify - 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. dreadnip/php-inotify ActiveLibrary[Utility & Helpers](/categories/utility) dreadnip/php-inotify ==================== Wraps php inotify module into object and dispatch them using event dispatcher. v3.0.1(4y ago)0154MITPHPPHP ^8.1 Since Aug 11Pushed 4y agoCompare [ Source](https://github.com/dreadnip/php-inotify)[ Packagist](https://packagist.org/packages/dreadnip/php-inotify)[ RSS](/packages/dreadnip-php-inotify/feed)WikiDiscussions master Synced today READMEChangelog (2)Dependencies (5)Versions (8)Used By (0) php-inotify (fork) ================== [](#php-inotify-fork) This is a PHP8.1 fork of the excellent package by [krowinski](https://github.com/krowinski/php-inotify). Installation ============ [](#installation) ``` composer require dreadnip/php-inotify ``` Installing inotify extension for php ==================================== [](#installing-inotify-extension-for-php) To listen on event we need php extension called inotify. In most cases you just need to install using pecl: ``` pecl install inotify ``` (example in [dockerfile](https://github.com/krowinski/php-inotify/blob/master/Dockerfile)) Example ======= [](#example) You can find example in [example.php](https://github.com/krowinski/php-inotify/blob/master/example/example.php)and events that you can listen to [InotifyEventCodeEnum.php](https://github.com/krowinski/php-inotify/blob/master/src/Inotify/InotifyEventCodeEnum.php)Event implement JsonSerializable and \_\_toString. ``` Array ( [id] => 1 [eventCode] => 256 [eventDescription] => ON_CREATE - File or directory created in watched directory [uniqueId] => 0 [fileName] => 2 [pathName] => /tmp [customName] => test [pathWithFile] => /tmp/2 [timestamp] => 1565610455 ) Array ( [id] => 1 [eventCode] => 32 [eventDescription] => ON_OPEN - File was opened [uniqueId] => 0 [fileName] => 2 [pathName] => /tmp [customName] => test [pathWithFile] => /tmp/2 [timestamp] => 1565610455 ) Array ( [id] => 1 [eventCode] => 4 [eventDescription] => ON_ATTRIB - Metadata changed (e.g. permissions, mtime, etc.) [uniqueId] => 0 [fileName] => 2 [pathName] => /tmp [customName] => test [pathWithFile] => /tmp/2 [timestamp] => 1565610455 ) Array ( [id] => 1 [eventCode] => 8 [eventDescription] => ON_CLOSE_WRITE - File opened for writing was closed [uniqueId] => 0 [fileName] => 2 [pathName] => /tmp [customName] => test [pathWithFile] => /tmp/2 [timestamp] => 1565610455 ) Array ( [id] => 1 [eventCode] => 512 [eventDescription] => ON_DELETE - File or directory deleted in watched directory [uniqueId] => 0 [fileName] => 2 [pathName] => /tmp [customName] => test [pathWithFile] => /tmp/2 [timestamp] => 1565610456 ) ``` Where: ``` [id] => watch descriptor [eventCode] => bit mask of events [eventDescription] => human readable event description (can be UNKNOWN if not found in InotifyEventCodeEnum) [uniqueId] => is a unique id to connect related events (e.g. IN_MOVE_FROM and IN_MOVE_TO) [fileName] => name of a file (e.g. if a file was modified in a watched directory) [pathName] => watched resource you give in configuration [customName] => custom resource name for external parsing like "form-upload-dir" etc [pathWithFile] => helper that contact pathName and fileName [timestamp] => ... ``` ### Health Score 31 — LowBetter than 66% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity10 Limited adoption so far Community6 Small or concentrated contributor base Maturity72 Established project with proven stability 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 ~193 days Recently: every ~241 days Total 6 Last Release 1550d ago Major Versions v0.1.0 → v1.0.02019-08-12 v1.1.0 → v2.0.02021-10-26 v2.0.0 → 3.0.02022-04-01 PHP version history (3 changes)v0.1.0PHP >=7.1 v2.0.0PHP >=7.4 3.0.0PHP ^8.1 ### Community Maintainers ![](https://www.gravatar.com/avatar/179d3921ac9d44fa878e41369464e08f45f322cde7fcc6d3764dc7268f25e0b7?d=identicon)[sanderdlm](/maintainers/sanderdlm) --- Top Contributors [![krowinski](https://avatars.githubusercontent.com/u/1478555?v=4)](https://github.com/krowinski "krowinski (16 commits)") --- Tags inotify ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP\_CodeSniffer Type Coverage Yes ### Embed Badge ![Health badge](/badges/dreadnip-php-inotify/health.svg) ``` [![Health](https://phpackages.com/badges/dreadnip-php-inotify/health.svg)](https://phpackages.com/packages/dreadnip-php-inotify) ``` ### Alternatives [sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.5k5.9M733](/packages/sylius-sylius)[phpro/grumphp A composer plugin that enables source code quality checks. 4.3k16.7M1.0k](/packages/phpro-grumphp)[matomo/matomo Matomo is the leading Free/Libre open analytics platform 21.7k38.9k](/packages/matomo-matomo)[sulu/sulu Core framework that implements the functionality of the Sulu content management system 1.3k1.4M203](/packages/sulu-sulu)[civicrm/civicrm-core Open source constituent relationship management for non-profits, NGOs and advocacy organizations. 751291.4k40](/packages/civicrm-civicrm-core)[oro/platform Business Application Platform (BAP) 645143.5k114](/packages/oro-platform) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)