Composer不直接支持按环境自动切换脚本,但可通过环境变量、shell逻辑分支、独立命名脚本、PHP配置驱动或Makefile封装等方式实现差异化构建流程。

Composer 本身不直接支持按环境(如 dev/test/prod)自动切换脚本,但可以通过组合 scripts、环境变量和外部工具(如 shell 脚本或 Makefile)来实现差异化行为。核心思路是:**让脚本逻辑感知当前环境,并在执行时动态分支**。
使用环境变量控制脚本行为
在 composer.json 的 scripts 中调用命令时,通过 $_ENV 或 shell 环境变量判断环境,再执行对应操作。Composer 脚本默认支持 shell 命令,可直接使用 if、case 等逻辑(Linux/macOS)或兼容写法(Windows 需额外处理)。
- 在
composer.json中定义通用脚本入口,例如:
"scripts": {
"build": [
"@build:common",
"if [ \"$APP_ENV\" = \"prod\" ]; then @build:prod; elif [ \"$APP_ENV\" = \"test\" ]; then @build:test; else @build:dev; fi"
],
"build:common": "echo 'Running common build steps...'",
"build:dev": "php bin/console assets:install --symlink",
"build:test": "php bin/console cache:clear --env=test",
"build:prod": "php bin/console cache:clear --env=prod && php bin/console assets:install --env=prod"
}执行时指定环境变量:APP_ENV=prod composer run build(Linux/macOS)或 set APP_ENV=prod && composer run build(Windows)。
为不同环境定义独立脚本并约定调用方式
更清晰的做法是显式定义三组脚本,靠命名区分,由团队或 CI/CD 流程约定调用哪个:
-
"build:dev":含调试工具安装、软链接资源、启用 Xdebug 等 -
"build:test":清空测试缓存、加载测试配置、运行静态分析 -
"build:prod":禁用调试、编译缓存、压缩资源、校验签名
这样无需运行时判断,CI 脚本中直接写 composer run build:$ENV 即可,也便于本地快速验证某环境流程。
配合 .env 文件或 config.php 实现配置驱动
如果项目已用 vlucas/phpdotenv 或类似方案管理环境配置,可在自定义 PHP 脚本中读取 APP_ENV 并分发逻辑:
- 新建
scripts/build.php,内容为:
<?php
$env = $_SERVER['APP_ENV'] ?? 'dev';
switch ($env) {
case 'prod': require 'build-prod.php'; break;
case 'test': require 'build-test.php'; break;
default: require 'build-dev.php';
}然后在 composer.json 中注册:"build": "php scripts/build.php"。这种方式逻辑更集中,也方便复用现有配置解析逻辑。
利用 Composer 插件或外部工具增强能力
若需更复杂的环境感知(如自动检测 Git 分支、CI 变量),可引入轻量插件如 hirak/prestissimo(加速)、roave/security-advisories(安全约束),或用 Makefile 封装多步流程:
# Makefile
build-dev:
APP_ENV=dev composer run build:common && composer run build:dev
<p>build-prod:
APP_ENV=prod composer run build:common && composer run build:prod</p><p>.PHONY: build-dev build-prod这样开发者只需执行 make build-dev,无需记忆环境变量拼写,也避免 shell 兼容性问题。










