composer exec 可直接运行 vendor/bin/ 下 工具 ,自动以项目根目录为工作目录并 继承 环境变量 与 Composer 配置;支持指定 php 解释器、安全传参及调用 composer.json 中定义的 scripts 别名。

直接用 composer exec 就能运行 vendor/bin/ 下的 工具 ,无需手动写完整路径或切换目录。它会自动在项目根目录下查找并执行对应命令,还能继承当前 环境变量 和 Composer 配置(比如脚本别名、平台配置等)。
基础用法:运行任意 vendor/bin 下的可执行文件
只要工具已安装进 vendor/bin/(比如 phpunit、phpcs、larastan),就可以这样运行:
composer exec phpunit composer exec phpcs --standard=PSR12 src/ composer exec larastan --level=5 app/
Composer 会自动在 vendor/bin/ 中查找可执行文件,并以项目根目录为工作目录启动它。
指定 PHP 版本或自定义解释器
如果项目依赖特定 PHP 版本(比如用 PHP 8.2 跑 phpstan),而系统默认不是,可以显式指定:
composer exec --php=/usr/bin/php8.2 phpstan analyse src/
注意:--php 参数必须放在 exec 后、命令名前,否则会被当作目标命令的参数传递。
传参给目标工具时要注意空格和引号
带空格、特殊字符或多个参数时,建议用单引号包裹整个命令,避免 shell 提前解析:
- ✅ 正确(推荐):
composer exec 'phpcs --standard=PSR12 "app/http/Controllers/"' - ⚠️ 可能出错:
composer exec phpcs --standard=PSR12 app/Http/Controllers/(某些 shell 环境下参数可能被截断或误读)
配合 composer.json 中的 scripts 使用更灵活
你还可以在 composer.json 的 "scripts" 里定义别名,然后用 composer exec 调用:
"scripts": {"test": "phpunit --colors=always", "cs-fix": "php-cs-fixer fix --rules=@PSR12"}
之后就能这样运行:
composer exec test composer exec cs-fix
这相当于间接调用脚本,适合 封装 常用组合命令或跨平台适配逻辑。
基本上就这些。不复杂但容易忽略的是引号用法和 --php 的位置——用对了,composer exec 就是本地开发提效的小帮手。
以上就是如何使用 composer exec 命令运行 vendor/bin 中的 工具 ?的详细内容,更多请关注php 中文网其它相关文章!