0

0

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

穿越時空

穿越時空

发布时间:2025-12-17 20:23:48

|

253人浏览过

|

来源于php中文网

原创

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

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

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

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

先把你希望自动运行的逻辑封装成一个可执行的 PHP 脚本或 Artisan 命令(如果是 Laravel),然后在 composer.jsonscripts 段注册为 Composer 脚本:

  • 例如,创建一个 scripts/build.php 文件,内容是编译前端资源或生成文档
  • 然后在 composer.json 中添加:
"scripts": {
  "build": "php scripts/build.php",
  "test:watch": "php vendor/bin/phpunit --colors=always"
}

这样你就可以用 composer buildcomposer 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)

如果你偏好原生工具:

蚂蚁PPT
蚂蚁PPT

AI在线智能生成PPT

下载
  • Linux 上可用 inotifywait(来自 inotify-tools 包):
inotifywait -m -e create,modify,move,delete -r src/ tests/ | while read line; do composer test:watch; done
  • macOS/Linux 可用 fswatchbrew 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 &"

更健壮的做法是用 concurrentlynodemon --exec php(需全局安装 nodemon),但那已超出 Composer 脚本范畴。

基本上就这些。Composer 脚本只是入口,真正监听靠外部工具。选 watchexec 最省事,配置少、兼容好、行为稳。不需要写复杂逻辑,也不用引入一堆 Node.js 依赖。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2829

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1695

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1554

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

1056

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1505

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1256

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1609

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1307

2023.11.13

c++空格相关教程合集
c++空格相关教程合集

本专题整合了c++空格相关教程,阅读专题下面的文章了解更多详细内容。

0

2026.01.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
【web前端】Node.js快速入门
【web前端】Node.js快速入门

共16课时 | 2万人学习

ThinkPHP6.x API接口--十天技能课堂
ThinkPHP6.x API接口--十天技能课堂

共14课时 | 1.1万人学习

微信小程序开发--云开发篇
微信小程序开发--云开发篇

共15课时 | 0.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号