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 轮询看似简单,但实际生产中问题明显: