Composer脚本是将shell命令、PHP脚本或Composer命令封装为可复用别名，通过composer run-script或简写composer xxx触发；支持数组顺序执行、内置别名引用、事件钩子自动执行及跨平台PHP脚本替代。

在 composer.json 的 scripts 段中定义自定义命令，本质是把 shell 命令、PHP 脚本或 Composer 命令封装成可复用的别名，通过 composer run-script xxx 或简写 composer xxx 触发。

在 scripts 中定义命令

在 composer.json 的 "scripts" 对象里添加键值对，键是命令名（如 "test"），值是待执行的命令字符串或数组：

• 单条命令直接写字符串："test": "phpunit"
• 多条命令用数组顺序执行（默认 shell 模式）："test": ["@clear-cache", "phpunit --colors=always"]
• 支持 Composer 内置命令别名，如 @dev、@prod，也可引用其他自定义脚本："clear-cache": "rm -rf var/cache/*"
• 若需跨平台兼容，推荐用 PHP 脚本代替 shell 命令（比如 Windows 不认 rm）

支持事件钩子的自动执行

Composer 脚本不仅可手动运行，还能绑定到生命周期事件，例如：

• "post-install-cmd"：运行 composer install 后触发
• "pre-autoload-dump"：生成自动加载文件前执行
• "post-update-cmd"：运行 composer update 后触发

这些钩子会自动执行，无需手动调用；多个脚本可用数组定义，顺序执行。

执行自定义脚本的几种方式

定义好后，有三种常用执行方式：

视野自助系统小型企业版2.0 Build 20050310

自定义设置的程度更高可以满足大部分中小型企业的建站需求，同时修正了上一版中发现的BUG，优化了核心的代码占用的服务器资源更少，执行速度比上一版更快 主要的特色功能如下： 1）特色的菜单设置功能，菜单设置分为顶部菜单和底部菜单，每一项都可以进行更名、选择是否隐 藏，排序等。 2）增加企业基本信息设置功能，输入的企业信息可以在网页底部的醒目位置看到。 3）增加了在线编辑功能，输入产品信息，企业介绍等栏

0 查看详情

• composer run-script test —— 显式调用，最清晰
• composer test —— 简写形式（Composer 2.2+ 支持，要求脚本名不含连字符或特殊字符）
• composer run-script test --no-ansi --verbose —— 加参数控制输出行为

注意：如果脚本名和 Composer 原生命令冲突（比如叫 "install"），必须用完整 run-script 形式，否则会执行原生命令。

调试与常见问题

脚本出错时，Composer 默认只显示返回码。开启调试更方便定位问题：

• 加 --verbose 查看完整命令和输出
• 加 --no-interaction 避免交互式命令卡住 CI 流程
• Windows 用户慎用 rm、mkdir -p 等 bash 特有命令，改用 php -r "exec('rd /s /q cache');" 或专用 PHP 脚本
• 环境变量可用 $COMPOSER_HOME、$PWD 等，但不要依赖未声明的自定义变量（不会自动注入）

基本上就这些。脚本能力不复杂但容易忽略细节，合理利用能显著简化日常开发和部署流程。

以上就是如何在 composer.json 的 scripts 中定义并执行自定义命令？的详细内容，更多请关注php中文网其它相关文章！

# php  # js  # json  # composer  # windows  # 环境变量  # win  # 常见问题  # 键值对  # php脚本  # 自定义  # 如何在  # 键值  # 上一  # 意大利  # 如何使用  # 复用  # 故障排除  # 情况下  # 多个  # 寿司怎么营销推广  # 建材网站推广费用情况  # 上饶县高端网站建设  # 网站内部免费推广方式  # 互联网营销推广哪家可靠  # 工具关键词排名策略  # 烟台怎么做seo  # 网站建设管理总结  # seo销售有前途吗  # 网站建设宣传收费