如何编写一个 Composer 脚本来监听文件变化并自动执行任务？

Composer 本身不提供文件监听功能，但可通过其脚本机制结合 watchexec 等外部工具实现自动执行任务；需先在 composer.json 中定义 scripts，再用 watchexec 监听文件变化并触发对应命令。

Composer 本身不提供文件监听功能，它只是一个依赖管理工具。但你可以通过 Composer 的脚本机制，结合外部工具（如 inotifywait、watchexec 或 php-watch）来实现“监听文件变化并自动执行任务”的效果。关键在于：用 Composer 定义可调用的命令，再用监听工具触发它。

1. 在 composer.json 中定义要自动执行的任务

先把你希望自动运行的逻辑封装成一个可执行的 PHP 脚本或 Artisan 命令（如果是 Laravel），然后在 composer.json 的 scripts 段注册为 Composer 脚本：

• 例如，创建一个 scripts/build.php 文件，内容是编译前端资源或生成文档
• 然后在 composer.json 中添加：

这样你就可以用 composer build 或 composer test:watch 手动运行了。

2. 使用 watchexec 实现跨平台监听（推荐）

watchexec 是轻量、跨平台、无依赖的监听工具，支持 Windows/macOS/Linux。安装后直接绑定 Composer 脚本即可：

• macOS / Linux：用 Homebrew 或 cargo 安装：brew install watchexec
• Windows：用 Scoop：scoop install watchexec
• 监听 src/ 和 tests/ 下的 PHP 文件，保存时自动跑测试：

它会自动忽略 vendor/ 和 node_modules/，也支持自定义忽略规则（比如 --ignore "**/cache/**"）。

3. 替代方案：用 inotifywait（Linux 专用）或 fswatch（macOS/Linux）

如果你偏好原生工具：

标签： 文件监听 php linux laravel js 前端 node.js json node go composer w