php无法实时监听文件变化，需借助inotifywait等外部工具或改用node.js/python等常驻服务；轮询仅适用于低频调试，且须控制频率、加缓存、去重。
PHP本身不支持实时监听文件变化
PHP是脚本语言，执行完就退出，没有内置的文件系统事件监听机制。想靠 fopen()、file_get_contents() 或轮询 filemtime() 来“实时”捕获更新，本质上都是伪实时——有延迟、占资源、易漏变。
真正可行的路径只有两条：要么用外部工具（如 inotifywait）配合PHP调用；要么把监控逻辑移出PHP，交给常驻进程或系统服务。
Linux下用 inotifywait + PHP 脚本联动最实用
这是生产环境最轻量、可控性最强的方案。核心思路是让 inotifywait 持续监听，一旦触发事件，通过 exec() 或管道把变更路径传给PHP处理脚本。
-
inotifywait -m -e modify,create,delete /path/to/watch中-m表示持续监听，-e指定事件类型，避免监听attrib等无关变更 - PHP侧不要在Web请求中直接调用
inotifywait—— 会阻塞HTTP响应；应启动为独立后台进程，例如：nohup php watch.php > /dev/null 2>&1 & - 推荐用
proc_open()启动并读取inotifywait的stdout，比shell_exec()更稳定，能避免输出截断 - 注意权限：运行PHP进程的用户必须对目标目录有
read和execute权限（否则无法进入目录监听）
PHP轮询方案只适合低频、临时调试
如果只是开发时验证逻辑，或监控日志等更新不频繁的文件，可用 filemtime() 配合 sleep() 实现简易轮询。但务必控制频率和范围：
立即学习“PHP免费学习笔记（深入）”；
- 单次轮询间隔至少
1秒，高频轮询（如100ms）会显著拉升CPU和I/O负载 - 不要用
stat()或is_file()替代filemtime()—— 前者开销更大，且不能区分“内容未变但属性变了”的情况 - 建议加一层简单缓存：把上次记录的
mtime存在apcu_store()或临时文件里，避免每次重复读取磁盘元数据 - 轮询脚本若跑在Web上下文，必须设置
set_time_limit(0)和ignore_user_abort(true)，否则用户关闭页面就会中断
跨平台方案要警惕 inotify 的 Linux 专属限制
Windows 和 macOS 没有 inotify，强行移植会失败。替代方案需按系统切换：
- macOS 可用
fsevents工具（需额外安装），或改用watchman（Facebook开源，支持三端） - Windows 推荐用
PowerShell的Register-ObjectEvent监听FileSystemWatcher，再通过命名管道或临时文件与PHP通信 - 纯PHP跨平台库如
symfony/filesystem的FilesystemWatcher类，底层仍是轮询，不解决实时性问题 - 真正统一的方案是放弃PHP做监听，改用 Node.js 的
chokidar或 Python 的watchdog启一个独立服务，PHP只负责HTTP调用它暴露的API
最容易被忽略的是事件重复触发：比如编辑器保存时可能先清空再写入，导致 modify 和 create 连发两次；或者NFS挂载点延迟上报。实际处理前，建议加个 usleep(100000) 去抖，或用 fileinode() + filemtime() 组合去重校验。
