composer exec 专用于安全运行 vendor/bin 下的本地 CLI 工具(如 phpunit),自动加载项目 autoload;composer run-script 执行 composer.json 中 scripts 定义的任意命令,支持 shell、PHP 脚本及嵌套调用,二者目标不同、不可直接替代。

composer exec 专门用来安全运行 vendor/bin 下的本地可执行工具(比如 phpunit、phpstan、php-cs-fixer),而 composer run-script 是用来执行 composer.json 中 scripts 字段定义的自定义命令(可以是 shell 命令、PHP 脚本,甚至调用其他 Composer 命令)。
执行目标不同
composer exec 只认 vendor/bin 目录里的可执行文件,不解析 scripts 配置;它背后会自动加载项目 autoload,确保工具能正确使用当前项目的依赖类。
composer run-script 则完全依赖 composer.json 的 scripts 定义,哪怕写的是 "test": "echo 'hello'" 或 "deploy": "git push origin main",它都照常执行。
调用方式和语义更清晰
使用 exec 表达的是“我要跑一个项目自带的 CLI 工具”,比如:
• composer exec phpunit -- --filter=testLogin
• composer exec phpstan analyse src/
而 run-script 更偏向“我要触发一个预设流程”,例如:
• composer run-script post-update-cmd
• composer test(这是 run-script 的简写形式)
环境与行为差异
composer exec 会清理部分环境变量,强制使用当前项目的 vendor/bin 下对应工具,并自动适配跨平台后缀(如 Windows 的 .bat);
run-script 执行时则继承当前 shell 环境,支持传参(如 --no-ansi)、支持事件钩子(如 pre-install-cmd)、也支持在脚本中嵌套调用其他 Composer 命令(包括 exec)。
能不能互相替代?
不能直接替代,但可以组合使用:
• 你可以在 scripts 里写 "analyse": "composer exec phpstan analyse src/",把 exec 包进脚本里;
• 但反过来,exec 无法执行 scripts 中定义的纯 shell 命令(比如 "build": "mkdir -p build && cp index.php build/"),因为它只找 vendor/bin 下的真实可执行文件。










