WorkerMan 3.x 手册

文件监控组件

背景:

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部分的判断去掉即可。