inotify扩展仅支持Linux，需确认内核启用、PHP已加载且CLI/Web SAPI均生效；监听时用位掩码（如IN_MODIFY）、避免IN_ALL_EVENTS；须用stream_select防阻塞，并及时释放inotify资源以防泄漏。
inotify 扩展不能在 Windows 上使用，PHP 必须运行在 Linux 环境下，且内核需启用 inotify 支持（现代主流发行版默认开启）。
确认 inotify 扩展已启用并可用
很多 PHP 镜像或精简安装包默认不带 inotify 扩展。先检查是否加载成功：
php -m | grep inotify
若无输出，需手动安装（以 Ubuntu/Debian 为例）：
- 运行
sudo apt install php-inotify（PHP 8.1+ 可能需指定版本如php8.2-inotify） - 确认
/etc/php/*/cli/conf.d/*-inotify.ini存在且内容为extension=inotify - CLI 和 Web SAPI（如 Apache 或 FPM）需分别验证：
php -r "var_dump(function_exists('inotify_init'));"返回bool(true)才算生效
注意：FPM 模式下，inotify_init() 创建的监听器生命周期仅限单次请求，无法跨请求持续监听 —— 这是常见误用点。
立即学习“PHP免费学习笔记（深入）”；
用 inotify_add_watch 监听文件并捕获事件类型
inotify_add_watch() 的第二个参数是掩码（bitmask），不是字符串。常用组合有：
-
IN_MODIFY：文件内容被写入（最常用，但不触发重命名、删除） -
IN_CREATE | IN_MOVED_TO：新文件生成或被移入目录（监控日志轮转时必需） -
IN_DELETE_SELF：被监听的文件本身被删除（注意：此时 watch 描述符自动失效） - 避免滥用
IN_ALL_EVENTS，它会带来大量无关事件（如IN_ACCESS），影响性能和可读性
示例：监听 /var/log/app.log 的内容变更
$fd = inotify_init(); $watch = inotify_add_watch($fd, '/var/log/app.log', IN_MODIFY); // 后续用 stream_select() 或阻塞 read() 等待事件
用 stream_select 避免阻塞主线程（尤其 CLI 长任务）
直接调用 inotify_read($fd) 是阻塞的，一旦没事件就卡死。生产环境应配合 stream_select 做超时控制：
-
inotify_init()返回的是合法的 Unix 文件描述符，可直接用于stream_select - 必须将
$fd转为数组：$read = [$fd];，否则stream_select会静默失败 - 设置合理超时（如 1 秒），防止因网络 I/O 或其他逻辑拖慢事件响应
片段示意：
$fd = inotify_init();
inotify_add_watch($fd, '/tmp/test.txt', IN_MODIFY);
while (true) {
$read = [$fd];
$num_changed = stream_select($read, $write = null, $except = null, 1); // 1秒超时
if ($num_changed > 0 && in_array($fd, $read)) {
$events = inotify_read($fd);
foreach ($events as $e) {
if ($e['mask'] & IN_MODIFY) {
echo "文件被修改\n";
}
}
}
}
注意 inotify 资源限制与内存泄漏风险
Linux 对每个用户默认限制 inotify 实例数（/proc/sys/fs/inotify/max_user_instances，通常 128），也限制总 watch 数（max_user_watches，常为 8192）。长期运行的服务容易触顶：
- 每次
inotify_init()都消耗一个 instance；每次inotify_add_watch()消耗一个 watch —— 必须显式inotify_rm_watch($fd, $watch)+fclose($fd)释放 - PHP 7.4+ 中，
$fd是 resource 类型，未 fclose 会导致资源泄露；PHP 8.0+ 改为 object，但依然需调用inotify_close($fd) - 监控大量文件时，建议按目录粒度监听
IN_CREATE | IN_MOVED_TO，而非为每个日志文件单独加 watch
真正难处理的是轮转场景：原文件被 rename，新文件创建，旧 watch 失效但无通知 —— 这时候得靠定时 stat + inode 比对兜底，inotify 本身解决不了。
