Composer如何设置环境变量_Composer项目构建参数配置-composer-PHP中文网

composer 不支持读取操作系统级环境变量，其“环境配置”实为通过 composer.json 的 config 和 platform 字段控制依赖解析、php/扩展版本约束及目录结构等静态参数。

composer如何设置环境变量_composer项目构建参数配置

Composer 本身不支持直接读取或设置操作系统级的环境变量（如 APP_ENV、DB_HOST），它也不是运行时配置工具。所谓“Composer 设置环境变量”，实际是指：在项目构建阶段，**控制依赖安装行为、适配不同环境的 PHP 版本/扩展约束、或影响自动加载与目录结构的静态参数**。这些都通过 composer.json 的 config 和 platform 字段完成。

如何让 Composer 安装时按目标环境 PHP 版本解析依赖

本地开发用 PHP 8.3，但线上跑的是 PHP 8.1？不设 platform，Composer 可能装上只兼容 8.3 的包，部署时报错。

config.platform.php 必须显式声明目标环境的 PHP 版本，例如："php": "8.1.10"
该值优先级高于当前运行的 PHP 版本，且会强制影响所有依赖的版本选择逻辑
扩展也支持平台模拟，比如 "ext-gd": "true" 或 "ext-redis": "5.3.7"，避免因本地缺扩展导致 install 失败
切勿写成 "php": "^8.1" —— platform 只接受具体版本号或布尔值，不支持约束语法

为什么 vendor 目录改了，CI 还是报 autoload 错误

设了 "vendor-dir": "libs" 却发现 vendor/autoload.php 还在被引用，或 composer dump-autoload 生成的文件路径错乱——根本原因是自动加载器默认仍基于 vendor/ 假设生成。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

改 vendor-dir 后，必须执行 composer install --no-dev（不是 update），否则旧 vendor/ 不删，新 libs/ 为空
autoload 生成的路径硬编码进 autoload_static.php，所以 IDE、CI 脚本、Dockerfile 中所有对 vendor/autoload.php 的引用都要同步改成 libs/autoload.php
若用 Docker 构建，cache-dir 也建议隔离，例如设为 "cache-dir": "/tmp/composer-cache"，避免和本地缓存哈希冲突

require-dev 包装上了，但 phpstan 命令却不存在

运行 composer require --dev phpstan/phpstan 成功，但敲 phpstan 提示 command not found，大概率是 bin-dir 配置缺失或插件被拦截。

确认 config.bin-dir 是否设为 "bin" 或 "vendor/bin"；若没设，默认仍是 vendor/bin，但某些 CI 环境 PATH 未包含该路径
Composer 2.2+ 默认禁用未声明插件，phpstan/phpstan 依赖 phpstan/extension-installer 插件，必须在 config.allow-plugins 中显式放行：{"phpstan/extension-installer": true}
allow-plugins 只在 composer.json 中生效，--global 设置无效；漏配会导致包看似装上，实际插件未激活，bin 文件也不生成

国内镜像配置后 update 还卡在 Loading composer repositories

镜像地址写了，composer config --list 也能看到，但 update 仍卡住——常见于项目级配置覆盖了全局镜像，或镜像源本身被写死在 repositories 里。

检查 composer.json 是否有 repositories 字段，尤其是否包含 {"packagist.org": false} 或自定义 packagist 替换项；有则删除，让 config.repo.packagist 生效
国内最稳的是阿里云镜像："config": {"repo.packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}}
不要在 CI 脚本里用 composer config --global 改镜像——不同项目可能依赖私有源，全局配置会串包；应统一走项目级配置 + auth.json 管认证

真正容易被忽略的点是：platform 和 config 不是“可选优化项”，而是构建确定性的前提。一个没设 platform.php 的项目，在 PHP 8.0 和 8.3 环境下可能装出完全不同的依赖树；而 vendor-dir 或 bin-dir 改动后，所有外部引用（包括 CI 的 phpunit 路径、Docker 的 COPY 指令、IDE 的自动索引根目录）都得手动对齐，差一个字符就失效。