Composer如何配置项目的License信息_Composer.json开源协议选择【科普】-composer

Composer 的 license 字段必须使用 SPDX 标准化标识符（如 MIT、Apache-2.0），不可写描述性文本；单许可证用字符串，多许可证用数组表示“二选一”；须与 LICENSE 文件内容一致，否则触发合规告警。

Composer 项目中的 license 字段不参与依赖解析、安装或自动合规检查，它只是元数据——但写错或留空会在开源协作、合规扫描（如 Snyk、FOSSA）、Packagist 展示时引发误解甚至阻断集成。

license 字段的合法值有哪些

必须是 SPDX 认可的标准化许可证标识符（如 MIT、Apache-2.0、GPL-3.0-only），不能写成 "MIT License" 或 "see LICENSE file"。Composer 不校验合法性，但 Packagist 会拒绝非 SPDX 标识符的提交。

• MIT、BSD-3-Clause、ISC：宽松型，允许闭源使用
• GPL-3.0-only vs GPL-3.0-or-later：后者允许升级到 GPL-4.0（若发布），前者严格锁定版本
• proprietary 是合法值，但 Packagist 不收录；私有包应配合 repositories 配置使用
• 多许可证用数组：["MIT", "GPL-3.0-or-later"]，表示“二选一”而非“同时满足”

如何在 composer.json 中正确配置 license

直接写入顶层字段，无需嵌套。常见错误是把它塞进 extra 或当成字符串描述写进 description。