如何使用 composer exec 命令运行 vendor/bin 中的工具？

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 提前解析：

标签： php js json composer php8 app 工具 环境变量