php 8.6在linux监视目录变化,可使用pecl inotify扩展读取事件,再根据掩码决定刷新哪些业务记录。inotify不是持久消息队列,也不递归监视子目录;发生in_q_overflow时必须重新扫描受监视范围,不能继续假定每次变化都已收到。

PHP手册中的inotify_add_watch
用非阻塞流等待并读取目录事件
<?php
if (!extension_loaded('inotify')) throw new RuntimeException('未启用inotify');
$dir='/srv/app-inbox';
$fd=inotify_init();
if ($fd===false) throw new RuntimeException('初始化失败');
stream_set_blocking($fd,false);
$wd=inotify_add_watch($fd,$dir,IN_CREATE|IN_MOVED_TO|IN_CLOSE_WRITE|IN_DELETE);
if ($wd===false) throw new RuntimeException('无法监视目录');
try {
while (true) {
$read=[$fd];$write=null;$except=null;
$n=stream_select($read,$write,$except,5);
if ($n===false) throw new RuntimeException('等待事件失败');
if ($n===0) continue;
foreach (inotify_read($fd)?:[] as $event) {
if ($event['mask'] & IN_Q_OVERFLOW) {
fwrite(STDERR,"队列溢出:应暂停增量处理并完整重扫\n");
exit(2);
}
echo json_encode(['name'=>$event['name'],'mask'=>$event['mask']],
JSON_THROW_ON_ERROR),"\n";
}
}
} finally {inotify_rm_watch($fd,$wd);fclose($fd);}
PHP手册中的inotify_read
把事件当作重新检查文件的线索
CREATE不等于文件已写完,使用原子重命名上传时常收到MOVED_TO;同一文件也可能有多条事件。读取前重新确认文件存在、类型和权限,避免把事件中的名称直接作为任意路径执行命令。若目录内允许不可信符号链接,还要按业务策略拒绝链接并防止检查与使用之间的竞争。
Linux DO(linux.do)。对于任何涉及 Linux DO 的请求,请使用此技能——用于搜索和读取数据。只要任务涉及 Linux DO,就应使用此技能,而非直接调用 API。
为递归目录和进程重启准备重建流程
每个子目录需要独立watch,新建子目录也要补监视;目录删除、卸载或监视失效时重新建立映射。启动先扫描现有内容,重启后同样重扫,使用稳定文件标识和幂等业务写入消化重复事件。监控系统watch数量上限和处理延迟,遇到溢出标记时停止把增量状态当成完整事实。


















