# FileMonitor文件监控组件
**背景:**
Workerman是常驻内存运行的,常驻内存可以避免重复读取磁盘、重复解释编译PHP,以便达到最高性能。所以更改业务代码后需要手动reload或者restart才能生效。
同时workerman提供一个监控文件更新的服务,该服务检测到有文件更新后会自动运行reload,从新载入PHP文件。开发者将其放入到项目中随着项目启动即可。
**文件监控服务下载地址:**
1、无依赖版本:<https://github.com/walkor/workerman-filemonitor>
2、依赖inotify版本:<https://github.com/walkor/workerman-filemonitor-inotify> (需要安装[inotify扩展](http://php.net/manual/zh/book.inotify.php))
**两个版本区别:**
地址1版本使用的是每秒轮询文件更新时间的方法判断文件是否更新,
地址2利用Linux内核[inotify](http://baike.baidu.com/view/2645027.htm)机制,文件更新时系统会主动通知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部分的判断去掉即可。
- 序言
- 原理
- 开发必读
- 入门指引
- 特性
- 简单的开发示例
- 安装
- 环境要求
- 下载安装
- 启动停止
- 开发流程
- 开发前必读
- 目录结构
- 开发规范
- 基本流程
- 通讯协议
- 通讯协议作用
- 定制通讯协议
- 一些例子
- Worker类
- 构造函数
- 属性
- id
- count
- name
- protocol
- transport
- reusePort
- connections
- stdoutFile
- pidFile
- logFile
- user
- reloadable
- daemonize
- globalEvent
- 回调属性
- onWorkerStart
- onWorkerReload
- onConnect
- onMessage
- onClose
- onBufferFull
- onBufferDrain
- onError
- 接口
- runAll
- stopAll
- listen
- TcpConnection类
- 属性
- id
- protocol
- worker
- maxSendBufferSize
- defaultMaxSendBufferSize
- maxPackageSize
- 回调属性
- onMessage
- onClose
- onBufferFull
- onBufferDrain
- onError
- 接口
- send
- getRemoteIp
- getRemotePort
- close
- destroy
- pauseRecv
- resumeRecv
- pipe
- AsyncTcpConnection类
- 构造函数
- connect
- reconnect
- transport
- Timer定时器类
- add
- del
- 定时器注意事项
- WebServer
- 调试
- 基本调试
- 查看运行状态
- 网络抓包
- 跟踪系统调用
- 常用组件
- GlobalData数据共享组件
- GlobalDataServer
- GlobalDataClient
- Channel分布式通讯组件
- ChannelServer
- channelClient
- 例子-集群推送
- 例子-分组发送
- FileMonitor文件监控组件
- MySQL组件
- workerman/mysql
- swoole/mysql(异步)
- redis组件
- swoole/redis
- 异步http组件
- swoole/http-client
- 异步消息队列组件
- react/zmq
- react/stomp
- 异步dns组件
- swoole/dns
- 常见问题
- 心跳
- 客户端链接失败原因
- 是否支持多线程
- 与其它框架整合
- 运行多个workerman
- 支持哪些协议
- 如何设置进程数
- 查看客户端连接数
- 对象和资源的持久化
- 例子无法工作
- 启动失败
- 停止失败
- 支持多少并发
- 更改代码不生效
- 向指定客户端发送数据
- 如何主动推送消息
- 在其它项目中推送
- 如何实现异步任务
- status里send_fail的原因
- Windows下开发Linux下部署
- 是否支持socket.io
- 终端关闭导致workerman关闭
- 与nginx apache的关系
- 禁用函数检查
- 平滑重启原理
- 为Flash开843端口
- 如何广播数据
- 如何建立udp服务
- 监听ipv6
- 关闭未认证的链接
- 传输加密-ssl/tsl
- 创建wss服务
- 创建https服务
- workerman作为客户端
- 作为ws/wss客户端
- PHP的几种回调写法
- 附录
- Linux内核调优
- 压力测试
- 安装扩展
- websocket协议
- ws协议
- text协议
- frame协议
- 不支持的函数/特性
- 版权信息