allow-plugins白名单必须写具体包名,不能用通配符;设为true等于关闭安全闸门,任何依赖(含间接依赖)可静默执行代码;正确做法是仅显式授权如"symfony/flex": true等可信包,加完立即用--dry-run验证。

allow-plugins 白名单必须写具体包名,不能用通配符
Composer 的 allow-plugins 是白名单机制,不是开关。设成 "allow-plugins": true 等于关闭全部插件安全闸门,任何依赖(包括间接依赖)都能静默执行代码——这已成供应链攻击常见入口。
常见错误包括:
- 误写
"*/*": true或"vendor/*": true:Composer 不识别这类通配符,配置静默失效 - 在
config.allow-plugins下多加空格或逗号结尾:"symfony/flex": true,会导致 JSON 解析失败 - 把白名单写在项目级
composer.json里,却忘了全局配置已被项目级repositories字段屏蔽
正确做法是只写一行、无多余字符:
"config": {
"allow-plugins": {
"symfony/flex": true,
"laravel/pint": true
}
}
加完立刻运行 composer install --dry-run 验证是否仍被拦截;若还报错,说明该插件本身又依赖另一个未授权插件(如某些 scaffold 工具链带二级插件)。
签名验证(signature-verification)默认不启用,必须显式开启且验证链路完整
运行 composer show --security 显示 Signature verification: disabled,不代表“包没签名”,而是你根本没打开校验开关——Composer 2.5+ 默认仍不强制开启,低于 2.5 则压根不支持该功能。
关键检查点:
- 先确认版本:
composer --version,若低于 2.5,升级是唯一解法 - 全局配置键名必须是
security.signature-verification,写成repos.packagist(少一个.org)会静默失效 - 项目级
composer.json中只要存在"repositories"字段(哪怕为空数组),就会完全屏蔽全局签名设置 - 镜像 URL 必须以
/结尾,如https://mirrors.aliyun.com/composer/,否则拉不到packages.json中的签名元数据
真正生效的标志有三个缺一不可:
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
-
composer diagnose输出中同时出现secure-http: OK和signature verification: OK -
composer show --security显示Signature verification: enabled -
composer.lock文件顶部存在"signatures": { }字段
私有仓库签名不能复用 packagist.org 配置,必须补全信任链
Packagist 的签名机制对私有仓库无效。直接照搬 security.signature-verification true 没用,必须额外补足服务端签名 + 客户端公钥信任。
实操要点:
- 私有仓库(如 Satis、Private Packagist)必须启用服务端签名,并提供可导出的公钥(
.asc或.pem) - 客户端需显式配置公钥路径:
composer config -g repos.my-private-repo.signing-key /path/to/pubkey.asc - 自建 Composer 镜像站不能只代理
packages.json,dist 包下载路径也必须指向带"signature"字段的官方 CDN 或经签名的内部存储 - 所有私有源 URL 必须以
https://开头,且证书有效;config secure-http true是硬性前提(2026年11月1日起强制)
--no-plugins 是生产环境硬性边界,不是可选项
--no-plugins 强制跳过所有插件加载(全局 + 项目级),切断构建期任意代码执行链。这不是“建议开启”,而是 CI/CD 流水线里必须写死的安全边界。
常见误操作:
- 写成
composer --no-plugins install:等价于composer --help,flag 被忽略 - 依赖 wrapper 脚本(如
bin/composer)却没确保它没偷偷加 flag - 以为禁了插件就等于禁了所有脚本:post-install-cmd 等脚本仍会执行,和插件白名单无关
推荐组合命令用于部署:
composer install --no-plugins --no-scripts --no-dev --prefer-dist
它不影响 vendor/autoload.php 生成和依赖解压,只阻断执行。最容易被忽略的是:插件白名单只控制“是否允许注册”,不控制“是否实际启用”;有些包注册插件后还需额外配置(如 extra.symfony.allow-contrib),这两类行为常被混为一谈。










