Skip to content

文件监控组件

背景:

Workerman 是常驻内存运行的,常驻内存可以避免重复读取磁盘、重复解释编译 PHP,以便达到最高性能。所以更改业务代码后需要手动 reload 或者 restart 才能生效。

同时 workerman 提供一个监控文件更新的服务,该服务检测到有文件更新后会自动运行 reload,从新载入 PHP 文件。开发者将其放入到项目中随着项目启动即可。

文件监控服务下载地址:

1、无依赖版本:https://github.com/walkor/workerman-filemonitor

2、依赖 inotify 版本:https://github.com/walkor/workerman-filemonitor-inotify (需要安装 inotify 扩展)

两个版本区别:

地址 1 版本使用的是每秒轮询文件更新时间的方法判断文件是否更新,

地址 2 利用 Linux 内核 inotify 机制,文件更新时系统会主动通知 workerman。

一般使用第一个无依赖版本即可

使用方法

将 Applications/FileMonitor 目录拷贝到你项目的 Applications 目录下即可。

如果你的项目没有 Applications 目录,可以将 Applications/FileMonitor/start.php 文件拷贝到你的项目任意位置,在启动脚本中 require 到启动脚本中即可。

监控组件默认监控的是 Applications 目录,如果需要更改,可以修改 Applications/FileMonitor/start.php 中的 $monitor_dir 变量, $monitor_dir 的值建议是绝对路径。

注意:

  • windows 系统不支持 reload,无法使用此监控服务。
  • 只有在 debug 模式下才生效,daemon 下不会执行文件监控(为何不支持 daemon 模式见下面说明)。
  • 只有在 Worker::runAll 运行后加载的文件才能热更新,或者说只有在 onXXX 回调中加载的文件才能热更新。

为何不支持 daemon 模式?

daemon 模式一般为线上正式环境运行的模式。正式环境发布版本时,一般一次发布多个文件,文件之间也可能有依赖。由于多个文件同步到磁盘需要一定时间,会存在某个时刻磁盘上的文件不全的情况,如果这时候监控到了文件更新并执行了 reload,则会有找不到文件导致致命错误的风险。

另外正式环境中有时候会在线定位 bug,如果直接编辑代码保存,就会立刻生效,有可能出现语法错误导致线上服务不可用。正确的方法应该是保存代码后,通过 php -l yourfile.php 检查下是否有语法错误,然后再 reload 热更新代码。

如果开发者确实需要 daemon 模式开启文件监控及自动更新,可以自行更改 Applications/FileMonitor/start.php 代码,将 Worker::$daemonize 部分的判断去掉即可。

基于 MIT 许可发布