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中添加：
“scripts”: {
“build”: “php scripts/build.php”,
“test:watch”: “php vendor/bin/phpunit –colors=always”
}
这样你就可以用 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 文件，保存时自动跑测试：
watchexec -e php -w src/ -w tests/ –on-change “composer test:watch”
它会自动忽略 vendor/ 和 node_modules/，也支持自定义忽略规则（比如 --ignore "**/cache/**"）。
3. 替代方案：用 inotifywait（Linux 专用）或 fswatch（macOS/Linux）
如果你偏好原生工具：
- Linux 上可用
inotifywait（来自inotify-tools包）：
inotifywait -m -e create,modify,move,delete -r src/ tests/ | while read line; do composer test:watch; done
- macOS/Linux 可用
fswatch：brew install fswatch，然后：
fswatch -o src/ tests/ | xargs -n1 -I{} composer test:watch
注意这些命令需要额外处理并发触发（比如快速连存多次），建议加简单防抖（如 sleep 0.1）或用 watchexec 更省心。
4. 进阶：监听 + 自动重载开发服务（如 PHP 内置服务器）
如果你想改代码后自动重启内置服务器（类似 Laravel 的 php artisan serve 热更新），可以组合使用：
- 启动一个后台 PHP 服务（比如
php -S localhost:8000 router.php） - 用
watchexec监听并 kill + restart：
watchexec -e php -w . –on-change “pkill -f ‘php -S’ 2>/dev/NULL; php -S localhost:8000 router.php &”
更健壮的做法是用 concurrently 或 nodemon --exec php（需全局安装 nodemon），但那已超出 Composer 脚本范畴。
基本上就这些。Composer 脚本只是入口，真正监听靠外部工具。选 watchexec 最省事，配置少、兼容好、行为稳。不需要写复杂逻辑，也不用引入一堆 node.js 依赖。