Composer config 定义行为偏好，影响依赖安装等流程但不改项目逻辑；关键项包括：1. package-versions 控制版本信息生成方式；2. process-timeout 和 xdebug-max-nesting-level 应对超时与递归限制；3. asset-patterns 与 github-protocols 替代废弃插件；4. cache-dir、data-dir 与 secure-http 保障环境复现与安全。
Composer 的 config 部分用于定义本地或全局行为偏好，影响依赖安装、包查找、缓存策略等核心流程。它不改变项目逻辑，但显著影响开发体验和 CI/CD 稳定性。下面分场景讲清最常用、最易被忽略的关键配置项。
package-versions：控制版本号注入方式
该配置决定 composer install 时是否自动生成 vendor/composer/installed.php 中的版本信息，以及是否启用 PackageVersions 兼容格式。
-
默认值为
true：生成完整 installed.php，含每个包的 commit hash、version 字符串、dist/source 类型等 - 设为
false可跳过生成，适合只读环境或极致瘦身场景（如某些 serverless 函数） - 设为
"minimal"（字符串）则仅保留必需字段，减小文件体积，兼容旧版ocramius/package-versions
process-timeout 和 xdebug-max-nesting-level：应对长耗时与深度递归
这两个配置常在 CI 或大型单体项目中触发失败，但错误提示不直观，需提前干预。
git-log-tracker
下载
Git post-commit 钩子 + SQLite 提交索引工具。自动将每次提交的元数据（哈希值、作者、分支、仓库、主题）记录到本地 SQLite 数据库中，随后提供一个命令行接口（CLI），支持查询、列表展示、统计、删除和更新记录。 触发场景：管理 Git 钩子、跨仓库查询提交历史、定位某次提交所属的仓库、查看提交统计信息、将提交记录写入本地索引。 当用户提及“提交日志记录”、“提交索引”、“跨仓库查找提交”、“Git 钩子管理”，或希望以结构化方式查询其提交历史时（即使未明确指出该工具），请使
-
process-timeout：单位秒，默认 300（5 分钟）。Composer 执行脚本（如post-install-cmd）、git clone、zip 解压超时时会中断。大型私有包或弱网环境建议设为1200或更高 -
xdebug-max-nesting-level：仅当 Xdebug 启用时生效。Composer 自身解析composer.json依赖图可能触发嵌套超限（尤其含大量replace或provide的项目），设为512或1024可避免Fatal error: Maximum function nesting level reached
fxp-asset-plugin 替代方案：asset-patterns 与 github-protocols
虽然 fxp/composer-asset-plugin 已废弃，但前端资源（Bower/NPM 包）集成需求仍在。现代做法通过 config 配合 repositories 实现：
-
asset-patterns：定义匹配规则，如["npm-asset/*", "bower-asset/*"]，让 Composer 把符合前缀的包名交由 asset-type 处理器（如composer-asset-plugin的继任者hiqdev/composer-config-plugin）接管 -
github-protocols：指定克隆 GitHub 仓库时优先使用的协议，如["https", "ssh"]。CI 环境无 SSH key 时设为["https"]可避免认证失败；内网 GitLab 则可设为["http"]绕过证书校验（配合secure-http: false）
cache-dir、data-dir 与 secure-http：构建可复现的离线/安全环境
这三个配置共同支撑企业级部署与审计合规。
-
cache-dir：指定 Composer 缓存路径（默认~/.composer/cache）。CI 中常设为$HOME/.composer-cache并挂载 volume，加速重复构建；Docker 构建时建议显式设置并 COPY 进镜像，避免每次重下 ZIP -
data-dir：存放keys.tags.json、repo元数据等，影响composer global命令位置。多用户共享服务器上建议统一指向/opt/composer/data避免权限冲突 -
secure-http：默认true，强制所有仓库使用 HTTPS。若需对接内部 HTTP 仓库（如 Nexus 没配 SSL），必须设为false，否则报Repository ... is not a valid repository, please check the URL
基本上就这些。config 不复杂但容易忽略，尤其在跨环境迁移或升级 Composer 版本时，几个关键开关没对齐，就会卡在“明明能装，换台机器就不行”的状态。
