PHP实时监控文件变化：inotify扩展应用教程

本文深入讲解了如何在Linux环境下利用PHP的inotify扩展实现高效、稳定的文件实时监控，涵盖环境准备（内核支持确认、扩展安装与多SAPI验证）、核心用法（位掩码精准监听、避免IN_ALL_EVENTS陷阱）、非阻塞事件处理（stream_select超时控制）以及关键避坑指南（资源泄漏防范、watch生命周期管理、日志轮转兜底策略），特别指出FPM下监听不可跨请求持久化等易错点，为构建生产级文件变更响应系统提供扎实可靠的技术路径。

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() 创建的监听器生命周期仅限单次请求，无法跨请求持续监听 —— 这是常见误用点。

用 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 本身解决不了。

本篇关于《PHP实时监控文件变化：inotify扩展应用教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！