README

这是一个简单的文件系统变更监视器。

安装

使用 Composer 安装此包

composer require attla/resource-watcher

如何使用？

此包使用 Symfony Finder 来设置发现文件变更的条件。

use Symfony\Component\Finder\Finder;
use Attla\ResourceWatcher\Crc32ContentHash;
use Attla\ResourceWatcher\ResourceWatcher;
use Attla\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/Attla/README.md"

发现变更

每次调用类 ResourceWatcher 的方法 findChanges() 时，它都会返回一个类型为 ResourceWatcherResult 的对象，其中包含关于文件系统中所有变更的信息。 ResourceWatcherResult 类有以下方法

getNewFiles()：返回包含新资源路径的数组。
getDeletedFiles()：返回包含已删除资源路径的数组。
getUpdatedFiles()：返回包含已更新资源路径的数组。
hasChanges()：资源有变更吗？。

哈希替代方案

包中包含两个哈希类

Attla\ResourceWatcher\Crc32ContentHash，它对文件内容进行哈希处理
Attla\ResourceWatcher\Crc32MetaDataHash，它对文件名及其最后修改时间戳进行哈希处理

重建缓存

要重建资源缓存，请使用类 ResourceWatcher 的 rebuild() 方法。

与资源缓存一起使用相对路径

由于 ResourceWatcher 的方法 enableRelativePathWithCache，可以使用资源缓存与相对路径一起使用。

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

ResourceWatcherResult 对象将包含相对路径。

单元测试

您可以使用以下命令运行单元测试

$ composer test

attla / resource-watcher

维护者

详细信息