composer.json中的 "extra" 字段可以用来做什么-composer-PHP中文网

composer.json中的 "extra" 字段可以用来做什么

裘德小鎮的故事

发布： 2025-10-04 23:18:02

原创

155人浏览过

extra 字段用于定义自定义数据，供 Composer 插件或部署脚本使用，不影响依赖管理但支持项目定制。1. 可通过 installer-paths 指定包安装路径，如 Drupal 模块、主题存放目录；2. 支持控制插件行为，如启用补丁应用、设置分支别名；3. 能传递构建或部署信息，如项目元数据、CI/CD 集成参数。该字段本身不参与核心逻辑，但为扩展提供灵活性。

$composer.json中的 \$

在 composer.json 文件中，"extra" 字段是一个灵活的配置区域，允许你定义一些不直接影响依赖管理但对项目构建、部署或工具行为有影响的自定义数据。它通常被 Composer 插件、框架安装器或部署脚本读取和使用。

指定包安装位置（如 Drupal 模块）

某些项目需要将特定类型的包安装到非默认目录中。例如 Drupal 项目可以利用 installer-paths 来控制模块、主题等的存放路径：

通过 composer/installers 插件支持
可自定义 vendor 包的安装目录
常见于 CMS 类项目（Drupal、WordPress、Laravel 等）

示例：

{
  "extra": {
    "installer-paths": {
      "web/modules/contrib/{$name}": ["type:drupal-module"],
      "web/themes/custom/{$name}": ["type:drupal-theme"]
    }
  }
}

登录后复制

控制插件行为或启用功能开关

很多 Composer 插件会读取 extra 中的键值来决定运行方式。比如：

微信二级防封域名

防封域名方法千千种，我们只做最简单且有用的这一种。微信域名防封是指通过技术手段来实现预付措施，一切说自己完全可以防封的那都是不可能的，一切说什么免死域名不会死的那也是吹牛逼的。我们正在做的是让我们的推广域名寿命更长一点，成本更低一点，效果更好一点。本源码采用 ASP+ACCESS 搭建，由于要用到二级域名，所以需要使用独享云虚机或者云服务器，不支持虚拟主机使用，不支持本地测试。目前这是免费测试版，

查看详情

enable-patching：由 cweagans/composer-patches 插件使用，表示允许应用补丁
patches：定义哪些包要打补丁及补丁来源
branch-alias：为开发分支设置别名，便于版本约束匹配

示例：

{
  "extra": {
    "enable-patching": true,
    "patches": {
      "drupal/core": {
        "Fix cache bug": "https://example.com/fix.patch"
      }
    }
  }
}

登录后复制