composer仅config.http-basic、repositories[].url等少数字段支持${var}插值，需变量提前注入；scripts、config.repos等字段不支持，写入无效。
Composer 本身不读取 .env 文件，也不在 composer.json 解析时自动加载 shell 环境变量；它只对少数明确支持插值的字段认 ${VAR_NAME} 占位符，且前提是变量已在 PHP 进程启动前由系统或容器注入。
哪些字段真正支持 ${VAR} 变量插值
不是所有配置项都生效，写错位置等于白写。只有以下字段在运行时调用 getenv() 解析：
-
config.http-basic：例如{"private.example.com": {"username": "${GIT_USERNAME}", "password": "${GIT_TOKEN}"}} -
repositories[].url：比如私有源地址写成"${PRIVATE_REPO_URL}" -
config.process-timeout、config.notify-batch等数值型配置，值必须是纯数字字符串（如"${COMPOSER_TIMEOUT}"）
常见误用：config.repos、config.github-protocols、scripts 中的命令字符串——这些字段不支持插值，写了也不会展开，更不会报错，只会静默忽略。
composer install 时怎么让环境变量生效
命令执行前必须确保变量已存在于当前 shell 环境中，否则 ${VAR} 会为空或被跳过：
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 本地测试：直接在命令前导出，如
APP_ENV=prod composer install - 多个变量用空格分隔：
APP_ENV=staging DB_HOST=localhost composer install - CI/CD（GitHub Actions / GitLab CI）：必须在
env:块中显式声明，不能依赖.env文件 - Docker：用
--env参数或docker-compose.yml的environment:字段传入，.env文件默认不加载
注意：post-install-cmd 脚本里写的 echo $APP_ENV 能输出，是因为 shell 层展开；但 "APP_ENV=${APP_ENV} php artisan config:clear" 是错的——composer 不解析 scripts 字符串里的 ${}。
为什么 vendor/autoload.php 里拿不到 .env 变量
因为 vendor/autoload.php 是 Composer 自动生成的类加载器，它只负责 PSR-4/PSR-0 映射和文件包含，不执行任何环境变量加载逻辑：
-
vlucas/phpdotenv是项目运行时加载的，发生在composer install完成之后 - 试图在
autoload.files里提前 require dotenv 会导致循环依赖（没装包就先要 autoload） - 想让 Composer 自身行为受环境变量控制，唯一可靠时机是 PHP 进程启动那一刻——要么靠 shell
export，要么用php.ini的auto_prepend_file或putenv()
COMPOSER_HOME 是环境变量，但它不是“配置项”而是路径开关
这个变量不用于插值，而是直接决定 Composer 全局行为的根目录：
- 设了就强制使用该路径，不设则 fallback 到默认位置（
~/.composer或%APPDATA%\Composer） - 必须是绝对路径，不能含
~、$HOME、%USERPROFILE%，Windows 下也不能用相对路径 - 改完需重启终端，且要手动迁移
auth.json、config.json和重装全局包，否则composer global require安装的命令仍找不到 - 验证方式：
composer config --global home输出是否为你设的路径
最易被忽略的一点：变量插值只发生在 Composer 启动初期，一旦开始解析 composer.json，就不会再重新读取环境变量——所以 CI 中动态生成的变量，必须在 composer install 命令执行前就注入完毕，中途改无效。
