hyperf/docs/zh-cn/watcher.md

# Watcher

自从 `2.0` 版本使用了 `BetterReflection` 来收集扫描目录内的 `语法树` 和 `反射数据`，导致扫描速度相较 `1.1` 慢了不少。

> 首次启动，因为没有任何缓存，所以会比较慢，当二次启动时，会按照文件修改时间，进行动态收集，但因为仍需要实例化 `BetterReflection`，所以启动时间仍然比较长。

`Watcher` 组件除了解决上述启动问题，还提供了文件修改后立马重启的功能。

## 安装

```
composer require hyperf/watcher --dev
```

## 配置

```bash
php bin/hyperf.php vendor:publish hyperf/watcher
```

|    配置    |     默认值      |                           备注                            |
| :--------: | :-------------: | :-------------------------------------------------------: |
|   driver   | `FswatchDriver` |                        fswatch驱动                        |
|    bin     |      `php`      | 用于启动服务的脚本 例如 `php -d swoole.use_shortname=Off` |
| watch.dir  | 'app', 'config' |                         监听目录                          |
| watch.file |     '.env'      |                         监听文件                          |

## 安装驱动

暂时只支持 `fswatch` 驱动。

Mac
```bash
brew install fswatch
```

其他
```bash
wget https://github.com/emcrisostomo/fswatch/releases/download/1.14.0/fswatch-1.14.0.tar.gz \
&& tar -xf fswatch-1.14.0.tar.gz \
&& cd fswatch-1.14.0/ \
&& ./configure \
&& make \
&& make install
```

## 启动

因为目录的关系，需要在项目根目录中运行。

```bash
php bin/hyperf.php server:watch
```

## 不足

- 暂时 Alpine Docker 环境下，稍微有点问题，后续会完善。