Composer没有“白名单”配置项,真正需配置的是allow-plugins,它控制哪些插件可执行PHP代码;默认拒绝所有,必须显式授权如"laravel/pint": true,禁用通配符"*",且插件须在require中声明才生效。

Composer 没有“白名单”这个配置项,所谓「白名单」是误传或对 allow-plugins 的通俗化误解。真正需要配置的是 allow-plugins,它控制哪些 Composer 插件被允许执行——不是加载、不是安装,而是「运行时执行 PHP 代码」这一高风险动作。
为什么必须显式配置 allow-plugins
从 Composer 2.2 开始,默认禁止所有插件执行("allow-plugins": false),这是安全强制策略。不配就报错:
Plugin installation is disabled. You must explicitly allow plugins via config.allow-plugins or use --no-plugins.
常见触发场景:
- Laravel 项目里
laravel/pint的插件注册逻辑在 install/update 阶段被执行 - Symfony Flex 的
symfony/flex插件自动注入 recipes - 私有包中自定义的
PackageEvents::POST_INSTALL_CMD处理器
不配置,composer install 直接中断;乱配,等于开放任意第三方代码执行权限。
allow-plugins 的三档放行范围怎么选
实际只有三个有效粒度,对应不同信任层级和运维成本:
-
全通配:
"*"—— 允许所有插件。仅限本地开发快速验证,CI/CD 和生产环境绝对禁用 -
精确包名:
"laravel/pint"—— 最推荐。只放行你明确知道用途、审计过源码、且项目真实依赖的插件 -
命名空间匹配:
"laravel/*"—— 风险较高。一旦该组织下新发布恶意插件(如laravel/stealer),就会被自动放行
注意:allow-plugins 是 JSON 键值对,不是数组,写法必须是:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
{
"config": {
"allow-plugins": {
"laravel/pint": true,
"symfony/flex": true,
"phpstan/extension-installer": true
}
}
}
别写成 "allow-plugins": ["laravel/pint"],那会直接被忽略。
容易踩的坑:插件放行 ≠ 依赖安装
很多人以为配了 allow-plugins 就能装插件,其实不是:
- 插件本身仍需出现在
require或require-dev中,否则 Composer 根本不会尝试加载它 -
--no-dev会跳过require-dev里的插件,哪怕你在allow-plugins里写了它,也不会生效 - 某些插件(如
roave/security-advisories)根本没注册任何事件处理器,它只是个冲突约束包,allow-plugins对它完全无意义
典型错误现象:配了 "laravel/pint": true,但 composer install --no-dev 后 vendor/bin/pint 不见了——因为 pint 在 require-dev 里,被跳过了。
CI/CD 流水线里怎么写才稳
线上部署脚本里,allow-plugins 必须收敛到最小集,且不能依赖交互式确认。推荐组合:
composer install --no-dev --no-interaction --optimize-autoloader --classmap-authoritative-
allow-plugins只保留运行时必需的插件(比如某些 ORM 的 schema 导出插件),开发类插件一律剔除 - 用
composer global require --no-plugins安装全局工具,避免污染项目级插件白名单
最常被忽略的一点:allow-plugins 配置是继承式的。如果项目用了 composer create-project 拉模板,而模板的 composer.json 里写了 "*",你没覆盖它,就等于开了后门。

















