composer.json 中的 require 和 require-dev 字段即为依赖白名单,必须显式声明并提交 Git;临时执行 composer update 不会持久化依赖,导致环境不一致;版本约束应明确,私有包需配置 repositories,动态需求应通过多配置文件或 require-dev 实现。

composer.json 里不能直接写“白名单”,所谓白名单配置实际是靠 require 和 require-dev 字段显式声明依赖,这才是该进 Git 的唯一可信来源。
为什么不能把 composer update monolog/monolog 这类命令当白名单用
这条命令只是临时操作,不会改 composer.json,也不会持久化到版本库。下次别人拉代码、跑 composer install,根本不会装这个包——它没被声明,就不算项目依赖。
- 执行
composer update monolog/monolog只会更新composer.lock中该包的版本,但composer.json里若没"monolog/monolog": "^3.0"这行,CI 或新环境就会跳过它 - 如果只靠命令行“临时加包”,团队协作时极易出现“在我机器上能跑,CI 上报 Class not found”
-
composer.lock本身不应被删或忽略(微服务/库类项目除外),它是确保install行为可复现的关键
require 和 require-dev 就是你的白名单
这两个字段就是 Composer 的“依赖白名单”,必须手写进 composer.json 并提交 Git。它们决定什么包会被装、什么包会被锁、什么包在 --no-dev 下被跳过。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 运行时必需的包(如框架、DB 驱动、HTTP 客户端)放
require - 仅开发期需要的(如 PHPUnit、PHPStan、PHP-CS-Fixer)放
require-dev,生产部署加--no-dev自动过滤 - 版本约束写明确:用
^2.9而非*或dev-main,避免意外升到不兼容版 - 私有包需在
repositories字段声明源,否则require会报 “package not found”
想动态控制哪些包生效?别绕开 composer.json
有人想“按环境开关依赖”,比如测试环境多装一个 mock 库。这不是靠命令行白名单,而是靠 Composer 的 config.platform 或条件性 require —— 但更稳妥的做法是:用 require-dev + 环境判断逻辑,或拆成独立的 dev-only Composer 配置文件(需配合自定义脚本)。
-
config.platform可伪造 PHP 或扩展版本,影响依赖解析结果,但不改变已声明的包列表 - 不要在 CI 脚本里写
composer require --no-interaction xxx来“动态加包”,这会让composer.json和实际安装状态脱节 - 若真要分场景管理(如 CLI 工具 vs Web 服务),应拆成两个
composer.json文件,用COMPOSER环境变量切换,而不是搞运行时白名单
真正容易被忽略的是:composer.json 不只是个配置文件,它是整个依赖图的唯一事实源。任何脱离它的“白名单操作”,都会让协作和部署变成猜谜游戏。

















