composer 不读取或修改应用环境变量，报错“database connection failed”实为框架脚本执行时因 .env 缺失或错误导致；需通过 post-install-cmd 脚本安全生成 .env，仅系统级变量如 composer_home 影响 composer 自身行为。
Composer 本身不读取或修改环境变量，它只是 PHP 的依赖管理工具；你真正要操作的是项目运行时的环境变量（比如 .env 文件、系统级 export、或 Web 服务器配置），Composer 只能在安装/更新阶段通过脚本间接触发某些行为。
为什么 composer install 会报 “Database connection failed”？
这不是 Composer 报的错，而是 Laravel、Symfony 等框架在 post-install-cmd 脚本中执行了 php artisan config:clear 或类似命令，进而加载了空/错误的 .env —— 此时环境变量尚未就位。
- Composer 不解析
.env，vlucas/phpdotenv才干这事，且通常在应用启动时才加载 - 如果你在
composer.json的scripts里调用了需要数据库连接的命令，而.env缺失或格式错误，就会失败 - 常见错误信息：
SQLSTATE[HY000] [1045] Access denied for user ''@'localhost'，说明DB_USERNAME为空
如何在 Composer 安装流程中安全写入 .env？
不能靠 Composer 直接“修改环境变量”，但可以借助自定义脚本生成或覆盖 .env 文件，前提是内容来源可信、路径明确、不覆盖敏感字段。
- 用
"post-install-cmd": ["cp .env.example .env || true"]快速初始化（仅限开发环境） - 若需注入动态值（如 CI 中的
$DATABASE_URL），改用 PHP 脚本："post-install-cmd": ["php set-env.php"] -
set-env.php示例逻辑：读取$_SERVER['DATABASE_URL']，用Dotenv\Dotenv::createImmutable(__DIR__)->load()加载现有.env，再用file_put_contents('.env', ...)拼接新键值（注意换行和引号转义） - 切勿在脚本中硬编码密码，也不要用
shell_exec('echo "KEY=VAL" >> .env')—— 会破坏格式、引发重复键、无权限控制
哪些环境变量会影响 Composer 自身行为？
只有极少数系统级环境变量会被 Composer 进程直接读取，它们作用于安装过程本身，与你的应用无关：
-
COMPOSER_HOME：指定全局配置目录，默认~/.composer；可用来隔离不同项目的缓存和 auth.json -
COMPOSER_CACHE_DIR：覆盖默认缓存路径（如/tmp/composer-cache），CI 场景常用 -
COMPOSER_AUTH：以 JSON 字符串形式传入认证信息，等价于auth.json内容，避免文件泄露风险 -
HTTPS_PROXY/HTTP_PROXY：影响包下载，国内用户常配https://mirrors.aliyun.com/composer/镜像源，但这是改repositories，不是改环境变量
真正容易被忽略的是：.env 文件权限（应为 600）和加载时机 —— phpdotenv 默认只在 CLI 或 Web 请求入口（如 public/index.php）中加载一次，后续子进程不会自动继承；如果用 Supervisor、Swoole 或队列 worker，得手动重载或改用 putenv() 注入关键变量。
