cecil / resource-watcher
使用Symfony Finder的简单资源监控器
资助包维护!
ArnaudLigny
Open Collective
Requires
- php: >=7.1
- symfony/finder: ^2.7|^3.0|^4.0|^5.0|^6.0
Requires (Dev)
- phpunit/phpunit: ^5.7|^8
- symfony/filesystem: ^2.7|^3.0|^4.0|^5.0
This package is auto-updated.
Last update: 2024-09-04 11:07:11 UTC
README
这是一个简单的文件系统更改资源监控器。
安装
使用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"
查找更改
每次调用类ResourceWatcher
的findChanges()
方法时,都会返回一个类型为ResourceWatcherResult
的对象,其中包含有关文件系统中产生的所有更改的信息。类ResourceWatcherResult
有以下方法:
getNewFiles()
:返回一个包含新资源路径的数组。getDeletedFiles()
:返回一个包含已删除资源路径的数组。getUpdatedFiles()
:返回一个包含已更新资源路径的数组。hasChanges()
:资源中有更改吗?。
哈希替代方案
该包包括两个哈希类
Yosymfony\ResourceWatcher\Crc32ContentHash
,该类对文件内容进行哈希处理Yosymfony\ResourceWatcher\Crc32MetaDataHash
,该类对文件名及其最后修改时间戳进行哈希处理
重建缓存
要重建资源缓存,请使用类ResourceWatcher
的rebuild()
方法。
使用资源缓存与相对路径
由于ResourceWatcher的方法enableRelativePathWithCache
,可以使用资源缓存与相对路径。
$watcher = new ResourceWatcher($resourceCache, $finder, $hashContent); $watcher->enableRelativePathWithCache()
ResourceWatcherResult
对象将包含相对路径。
单元测试
您可以使用以下命令运行单元测试
$ composer test