composer run-script --list 用于列出 composer.json 中 scripts 字段定义的所有自定义脚本,包括 test、format 等手动执行命令及 post-install-cmd 等事件钩子,帮助开发者快速了解项目支持的自动化任务,区分内置事件与自定义脚本,提升协作效率。

composer run-script --list 命令用于列出当前项目中所有已定义的自定义脚本(scripts),这些脚本配置在 composer.json 文件的 "scripts" 字段下。
查看可用的自定义脚本
在开发过程中,你可能需要运行一些自动化任务,比如测试、代码格式化、清理缓存等。Composer 允许你在 composer.json 中定义这些命令,并通过 run-script 来执行。使用 --list 参数可以查看都有哪些脚本可供调用。
例如,如果你的 composer.json 包含:
{ "scripts": { "test": "phpunit", "format": "php-cs-fixer fix", "post-install-cmd": "echo 'Installed!'" } }运行:
composer run-script --list会输出类似:
scripts: test: phpunit format: php-cs-fixer fix post-install-cmd: echo 'Installed!'帮助团队成员了解项目命令
这个命令对新加入项目的开发者特别有用。不需要翻看文档或源码,只需一条命令就能知道项目支持哪些快捷脚本,提升协作效率。
区分内置脚本与自定义脚本
输出结果通常分为两类:
- Event Hooks:如 post-update-cmd、pre-install-cmd 等 Composer 自动触发的生命周期事件。
- Custom Scripts:你自己定义并可通过 composer run-script script-name 手动执行的脚本。
基本上就这些。它不执行脚本,只是展示有哪些脚本可用。










