Composer不读取.env文件，仅支持操作系统级环境变量；需用export（Linux/macOS）、set（Windows CMD）或$env:（PowerShell）显式导出，CI/Docker中须通过env块或--env注入，且仅config.http-basic、repositories[].url等字段支持${VAR}插值。
composer.json 里用 ${VAR_NAME} 却没替换？先确认 Composer 是否读取了环境变量
Composer 本身不主动加载 .env 文件，它只认操作系统级的环境变量。如果你在 composer.json 中写了 "url": "${API_BASE_URL}" 却没生效，大概率是变量根本没导出到当前 shell 环境里。
验证方式很简单，在运行 composer install 或 composer dump-autoload 前，先执行：
echo $API_BASE_URL
如果输出为空，说明变量未设置；如果输出正常，再检查是否在子 shell（比如 Docker、CI 脚本、IDE 终端）中丢失了继承。
- Linux/macOS：确保用
export API_BASE_URL=https://api.example.com，而不是仅API_BASE_URL=... - Windows CMD：用
set API_BASE_URL=https://api.example.com，但注意该变量仅对当前命令行窗口有效 - Windows PowerShell：必须用
$env:API_BASE_URL="https://api.example.com" - CI 环境（如 GitHub Actions）：需显式在
env:下声明，不能依赖项目根目录的.env
为什么 .env 文件里的变量对 Composer 没用？
Composer 不解析 .env 文件——那是 Laravel、Symfony 或 vlucas/phpdotenv 这类库干的事。你手动写的 .env 对 composer.json 的变量插值完全透明。
想让 .env 生效，得靠外部工具提前注入。常见做法是用 dotenv + shell 命令组合：
set -a; source .env; set +a; composer install
或者更稳妥地用 envchain、direnv 管理，但本质都是把变量 export 到当前进程环境。
-
set -a让后续所有变量自动 export，set +a关闭它，避免污染全局 - 别在
composer.json的scripts里直接写source .env——Composer 的脚本执行在独立子 shell 中，变量不会回传 - 如果用 Docker，记得用
env_file:或environment:把变量透传进容器，宿主机的export对容器内无效
如何快速验证变量是否真被 Composer 解析了？
最直接的办法：临时加一个会失败的 require，触发变量解析报错。比如在 composer.json 中写：
"require": {
"some/package": "${MISSING_VAR}-dev"
}
然后运行 composer validate --strict。如果看到类似错误：
Invalid version string "${MISSING_VAR}-dev"
说明变量未展开，还保留着原始占位符；如果报的是 Package some/package not found，说明已成功替换成空字符串或实际值（比如 -dev），那就证明变量读取成功了。
-
composer validate --strict是轻量验证方式，不下载包，只做语法和变量展开检查 - 别依赖
composer show或composer config查变量——它们不参与composer.json的插值过程 - 某些旧版 Composer（${FOO_${BAR}}）支持不全，尽量用扁平变量名
在 CI/CD 中变量总失效？重点检查这三处
CI 环境里变量“明明设了却没用”，90% 出现在这三个环节：
- GitHub Actions：
env:必须写在 job 或 step 级别，且composer install步骤要显式继承，不能只靠shell: bash默认环境 - GitLab CI：
variables:定义的变量默认不 export 给子 shell，需加export: true或改用before_script中export - Docker build：
ARG≠ENV，构建时的ARG不会自动变成运行时环境变量，composer install在构建阶段执行的话，必须用ENV或--build-arg显式传入
复杂点在于：变量可能在某个环节被覆盖、截断（比如含空格或特殊字符未引号包裹），或大小写不一致（API_URL 和 api_url 在不同系统表现不同）。建议在 CI 脚本开头加一行 env | grep -i api 直接看实际注入的变量名和值。
