ahmadelsaeed/php8-resource-watcher

A simple resource watcher using Symfony Finder

1.1.1 2022-08-17 19:52 UTC

Requires

• php: ^7.2|^8.0
• symfony/finder: ^2.7|^3.0|^4.0|^5.0|v6.1.3

Requires (Dev)

• phpunit/phpunit: ^9.5
• symfony/filesystem: ^2.7|^3.0|^4.0|^5.0|v6.1.3

MIT

• Victor Puertas

• symfony
• finder
• resources
• watcher

README

A simple resource watcher for getting changes of your filesystem.

Installation

Use Composer to install this package:

composer require yosymfony/resource-watcher

How to use?

This package uses Symfony Finder to set the criteria to discover file changes.

use Symfony\Component\Finder\Finder;
use Yosymfony\ResourceWatcher\Crc32ContentHash;
use Yosymfony\ResourceWatcher\ResourceWatcher;
use Yosymfony\ResourceWatcher\ResourceCachePhpFile;

$finder = new Finder();
$finder->files()
    ->name('*.md')
    ->in(__DIR__);

$hashContent = new Crc32ContentHash();
$resourceCache = new ResourceCachePhpFile('/path-cache-file.php');
$watcher = new ResourceWatcher($resourceCache, $finder, $hashContent);
$watcher->initialize();

// delete a file

$result = $watcher->findChanges();

$result->getDeletedResources() // array of deleted filenames. e.g: "/home/yosymfony/README.md"

Finding changes

Every time the method findChanges() of the class ResourceWatcher is invoked, it returns an object type ResourceWatcherResult with information about all the changes producced in the filesystem. The ResourceWatcherResult class has the following methods:

• getNewFiles(): Returns an array with the paths of the new resources.
• getDeteledFiles(): Returns an array with the paths of deleted resources.
• getUpdatedFiles(): Returns an array with the paths of the updated resources.
• hasChanges(): Are they changes in your resources?.

Hashing alternatives

Two hashing classes are included in the package:

• Yosymfony\ResourceWatcher\Crc32ContentHash, which hashes the content of the file
• Yosymfony\ResourceWatcher\Crc32MetaDataHash, which hashes the filename and its last modified timestamp

Rebuild cache

To rebuild the resource cache uses rebuild() method of the class ResourceWatcher.

Relative paths with the resource cache

Using relative paths with the resource cache is possible thanks to the ResourceWatcher's method enableRelativePathWithCache:

$watcher = new ResourceWatcher($resourceCache, $finder, $hashContent);
$watcher->enableRelativePathWithCache()

The ResourceWatcherResult object will has relative paths.

Unit tests

You can run the unit tests with the following command:

$ composer test