README

资源监视器允许您监视资源的任何更改。这意味着您可以监视一个目录，然后监听该目录内文件或目录本身的任何更改。

安装

要安装Resource Watcher，将其添加到您的composer.json文件的requires键中。

"matthijsthoolen/resource-watcher": "2.0.*"

然后使用composer update更新您的项目。

使用方法

Resource Watcher最好从控制台使用。可以在watcher文件中找到一个控制台命令的示例。此文件已注释，以给您一个如何配置和使用资源监视器的想法。一旦您根据需要自定义了命令，您就可以从您的控制台运行它。

$ php watcher

您对资源所做的任何更改都将输出到控制台。

快速概览

要监视资源，您首先需要一个MatthijsThoolen\ResourceWatcher\Watcher的实例。此类有几个依赖项（MatthijsThoolen\ResourceWatcher\Tracker和Illuminate\Filesystem\Filesystem），也必须实例化。

$files = new Illuminate\Filesystem\Filesystem;
$tracker = new MatthijsThoolen\ResourceWatcher\Tracker;

$watcher = new MatthijsThoolen\ResourceWatcher\Watcher($tracker, $files);

现在我们有了监视器，我们可以为给定的资源创建一个监听器。

$listener = $watcher->watch('path/to/resource');

当您监视资源时，将返回一个MatthijsThoolen\ResourceWatcher\Listener的实例。有了这个，我们现在可以监听资源上的某些事件。

我们可以监听三个事件：modify、create和delete。您提供给监听器的回调函数接收两个参数，第一个是实现MatthijsThoolen\ResourceWatcher\Resource\ResourceInterface的实例，第二个是资源的绝对路径。

$listener->modify(function($resource, $path) {
    echo "{$path} has been modified.".PHP_EOL;
});

您也可以使用别名方法。

$listener->onModify(function($resource, $path) {
    echo "{$path} has been modified.".PHP_EOL;
});

您还可以监听这些事件中的任何一个。这次回调函数接收一组不同的参数，第一个是MatthijsThoolen\ResourceWatcher\Event的实例，其余两个与之前相同。

$listener->anything(function($event, $resource, $path) {

});

请记住，每次调用$watcher->watch()都将返回一个MatthijsThoolen\ResourceWatcher\Listener的实例，所以请确保您将监听器附加到正确的实例上！

一旦您监视了一些资源并设置了监听器，您就可以开始监视过程。

$watcher->start();

默认情况下，监视器每秒轮询一次更改。您可以通过将可选的第一个参数传递给start方法来调整此操作。轮询间隔以微秒为单位，因此1,000,000微秒是1秒。监视将继续，直到从控制台终止。要设置超时，将超时前的微秒数作为第二个参数传递。

start方法还可以提供一个回调函数作为可选的第三个参数。此回调函数将在检查资源更改之前触发。

$watcher->start(1000000, null, function($watcher) {
	// Perhaps perform some other check and then stop the watch.
	$watcher->stop();
});

框架集成

Laravel 4和Laravel 5

包括Laravel框架的服务提供程序。此服务提供程序将MatthijsThoolen\ResourceWatcher\Watcher的实例绑定到应用程序容器中的watcher键。

在app/config/app.php中注册MatthijsThoolen\ResourceWatcher\Integration\LaravelServiceProvider为提供者数组中的提供者。

$listener = $app['watcher']->watch('path/to/resource');

// Or if you don't have access to an instance of the application container.
$listener = app('watcher')->watch('path/to/resource');

许可

Resource Watcher在2-clause BSD许可下发布。有关更多详细信息，请参阅LICENSE文件。