This package is based on reactphp/event-loop and provides an easy-to-use interface to set filesystem watchers and detect changes.
The package is utilizing the abstraction of react-php to create an efficient file-watcher using the underlying platform package that is installed on the environment
| Extension | Status |
|---|---|
| ext-uv | Supported |
| ext-ev | Supported |
| ext-libevent | Supported (using in default watcher) |
| ext-event | Supported (using in default watcher) |
| ext-libev | Supported (using in default watcher) |
composer require nivpenso/react-file-watcher
use React\EventLoop\Factory;
use ReactFileWatcher\FileWatcherFactory;
use ReactFileWatcher\PathObjects\PathWatcher;
// create path to watch in the file system
$pathToWatch = new PathWatcher("/tmp/", true);
// creating the loop using ReactPHP.
$loop = Factory::create();
// creating the file watcher based on the loop.
$fileWatcher = FileWatcherFactory::create($loop);
// call the watch and execute the callback when detecting change event.
$fsevent = $fileWatcher->Watch([$pathToWatch], function($filename) {
var_dump($filename);
print PHP_EOL;
});This package comes with a demo that can be used. feel free to run it
- make sure one of the supported libraries is installed on your environment (suggested:
ext-uv) - run the following commands
# install dependecies
composer install --no-dev
# run the demo
php ./demo/test.php
After the process started you can start changing files under the path to watch (default: /tmp) and see the messages in the terminal.
In case you don't have a linux machine ready, or an environment set up you can use Docker to test it.
# In terminal A run this
docker-compose -f ./demo/docker-compose.yaml up
make a change inside the tmp folder of the container to see the change detection
# In terminal B run this
docker ps # to get the container-id
docker exec -it <container-id> /bin/bash
echo "change" > /tmp/1
On the first terminal you should see the process detect the change.
This package comes with tests in it. It uses the amazing package, PEST. You can either run the tests on local or use the provided docker file that already contains a ready to use environment with all the required extensions (ev, uv, libevent, event).
composer install
./vendor/bin/pest
docker-compose -f ./tests/docker-compose.yaml up