PHP无内置文件监听机制，Linux下可用inotify扩展或inotifywait命令实现近实时响应，Windows仅能通过COM/WMI或外部程序妥协，轮询方案存在延迟与资源浪费问题。
PHP 本身没有内置的文件系统事件监听机制（比如“文件一创建就自动触发回调”），inotify、fswatch 或 FileSystemWatcher 这类能力不在 PHP 运行时范围内——它不主动监听，只能被动检查或靠外部工具桥接。
PHP 脚本里用 inotify 扩展监听文件创建（Linux）
这是最接近“实时响应”的原生方案，但需服务器支持：inotify 内核模块 + PHP inotify 扩展已启用（非默认安装）。
- 确认扩展已加载：
php -m | grep inotify，若无则需pecl install inotify并在php.ini中添加extension=inotify.so -
inotify_init()创建监听句柄，inotify_add_watch()注册目录 +IN_CREATE事件 - 必须用
stream_select()或循环inotify_read()捕获事件，PHP 不会自动中断执行——你得自己写阻塞/轮询逻辑 - 注意：只监听**当前目录下直接创建**的文件，子目录需单独加 watch；事件返回的是文件名，不含路径，需自行拼接
$fd = inotify_init();
inotify_add_watch($fd, '/path/to/watch', IN_CREATE);
while (true) {
$events = inotify_read($fd);
if ($events) {
foreach ($events as $event) {
if ($event['mask'] & IN_CREATE) {
echo "New file: " . $event['name'] . "\n";
// 这里放你的处理逻辑
}
}
}
}
用 inotifywait 命令行工具配合 PHP（更轻量、免扩展）
当无法装 PHP 扩展时，调用系统命令是更通用的做法，尤其适合脚本调度场景。
-
inotifywait属于inotify-tools包，Ubuntu/Debian 下用apt install inotify-tools安装 - PHP 用
proc_open()或shell_exec()启动长期监听进程，避免每次创建都启停开销 - 关键参数：
-m（持续监听）、-e create（只捕获创建事件）、--format '%w%f'输出完整路径 - 注意 stdout 缓冲：PHP 读取时需设
stream_set_blocking($pipes[1], false)或用fflush()配合，否则可能卡住
为什么不用 filemtime() 或 scandir() 轮询？
纯 PHP 轮询看似简单，但实际生产中问题明显：
立即学习“PHP免费学习笔记（深入）”；
- 延迟高：最小间隔受限于脚本执行周期（如 cron 每分钟一次 → 最大延迟 60 秒）
- 资源浪费：空转占用 CPU，尤其监控大目录时
scandir()开销陡增 - 竞态风险：文件创建后立刻被其他进程改名/移动，轮询可能错过或误判
- 无法区分“创建”和“重命名后出现”：
rename()也会让文件出现在目录里，但并非真正创建
Windows 下替代方案只有 ReadDirectoryChangesW（需 C 扩展或 COM）
PHP 官方不提供 Windows 文件监听接口，可行路径极少：
- 用
COM调用 WMI 查询Win32_Directory或CIM_Directory，但性能差、权限要求高、事件延迟秒级起 - 写一个小型 C++/Rust 程序监听，通过 socket 或文件管道与 PHP 通信 —— 复杂度远超需求
- 放弃实时性，改用
Get-ChildItem+LastWriteTime的 PowerShell 脚本定时扫描，再由 PHP 读取结果
跨平台项目务必提前确认部署环境：Linux + inotify 是唯一靠谱的实时路径，其余都是妥协方案。别指望 fopen() 成功就等于“触发了事件”——那只是你刚好在创建后打开了它。
