cecil/resource-watcher

使用Symfony Finder的简单资源监控器

4.0.0 2024-01-04 09:44 UTC

This package is auto-updated.

Last update: 2024-09-04 11:07:11 UTC


README

这是一个简单的文件系统更改资源监控器。

Build Status Latest Stable Version

安装

使用Composer安装此包

composer require yosymfony/resource-watcher

如何使用?

此包使用Symfony Finder来设置发现文件更改的准则。

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"

查找更改

每次调用类ResourceWatcherfindChanges()方法时,都会返回一个类型为ResourceWatcherResult的对象,其中包含有关文件系统中产生的所有更改的信息。类ResourceWatcherResult有以下方法:

  • getNewFiles():返回一个包含新资源路径的数组。
  • getDeletedFiles():返回一个包含已删除资源路径的数组。
  • getUpdatedFiles():返回一个包含已更新资源路径的数组。
  • hasChanges():资源中有更改吗?。

哈希替代方案

该包包括两个哈希类

  • Yosymfony\ResourceWatcher\Crc32ContentHash,该类对文件内容进行哈希处理
  • Yosymfony\ResourceWatcher\Crc32MetaDataHash,该类对文件名及其最后修改时间戳进行哈希处理

重建缓存

要重建资源缓存,请使用类ResourceWatcherrebuild()方法。

使用资源缓存与相对路径

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

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

ResourceWatcherResult对象将包含相对路径。

单元测试

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

$ composer test