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