hyperf/docs/zh-cn/watcher.md

71 lines
2.1 KiB
Markdown
Raw Normal View History

# 热更新 Watcher
2020-07-02 13:38:17 +08:00
自从 `2.0` 版本使用了 `BetterReflection` 来收集扫描目录内的 `语法树``反射数据`,导致扫描速度相较 `1.1` 慢了不少。
> 首次启动,因为没有任何缓存,所以会比较慢,当二次启动时,会按照文件修改时间,进行动态收集,但因为仍需要实例化 `BetterReflection`,所以启动时间仍然比较长。
`Watcher` 组件除了解决上述启动问题,还提供了文件修改后立马重启的功能。
## 安装
```
composer require hyperf/watcher --dev
```
## 配置
### 发布配置
2020-07-02 13:38:17 +08:00
```bash
php bin/hyperf.php vendor:publish hyperf/watcher
```
### 配置说明
| 配置 | 默认值 | 备注 |
| :------------: | :--------------: | :-------------------------------------------------------: |
| driver | `ScanFileDriver` | 默认定时扫描文件驱动 |
| bin | `php` | 用于启动服务的脚本 例如 `php -d swoole.use_shortname=Off` |
| watch.dir | `app`, `config` | 监听目录 |
| watch.file | `.env` | 监听文件 |
| watch.interval | `2000` | 扫描间隔(毫秒) |
## 支持驱动
2020-07-02 13:38:17 +08:00
| 驱动 | 备注 |
| :----------------------------------: | :--------------: |
| Hyperf\Watcher\Driver\ScanFileDriver | 无需扩展 |
| Hyperf\Watcher\Driver\FswatchDriver | 需要安装 fswatch |
2020-07-02 13:38:17 +08:00
### `fswatch` 安装
2020-07-02 13:38:17 +08:00
Mac
2020-07-02 13:38:17 +08:00
```bash
brew install fswatch
```
其他
2020-07-02 13:38:17 +08:00
```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 环境下,稍微有点问题,后续会完善。
- 删除文件需要手动重启才能生效。