如何为TYPO3 Composer项目配置专属及跨项目自定义扩展开发环境

项目专属扩展配置方案 #

仅在当前项目使用的扩展可直接使用本地路径引入方案，操作如下：

1. 在项目根目录创建/extensions目录，将扩展代码放到该目录下
2. 修改项目composer.json，添加path类型仓库并引入依赖：

"repositories": [
    {
        "type": "path",
        "url": "extensions/*"
    }
],
"require": {
    "myvendor/myextension": "@dev",
    // 其他项目依赖
}

3. 执行composer install即可完成引入，扩展代码会和项目代码一起纳入项目Git仓库管理。

跨项目复用扩展开发配置方案 #

针对有独立Git仓库、可在多个项目中复用的扩展，可使用以下两种方案实现本地开发调试：

方案1：临时本地路径引入（更推荐，可控性高） #

• 首先将目标扩展的Git仓库克隆到本地，推荐放在项目根目录下的/extension_dev目录中，将该目录添加到项目.gitignore避免提交到项目仓库
• 修改项目composer.json，将扩展的本地路径仓库配置放在原有远程仓库配置的前面，Composer会优先匹配靠前的仓库源：

{
  "repositories": [
    {
      "type": "path",
      "url": "extension_dev/my_extension"
    },
    {
      "type": "gitlab",
      "url": "git@gitlab.mysite.org:typo3-extensions/my_extension.git"
    }
  ],
  "require": {
    "myvendor/my-extension": "@dev"
  }
}

• 执行composer update myvendor/my-extension，Composer会创建软链接指向本地克隆的扩展目录，该目录包含完整的.git文件，可直接进行代码修改、提交、推送等Git操作
• 开发完成后，删除新增的path仓库配置，执行composer update myvendor/my-extension即可切回正式版本依赖

方案2：使用--prefer-source参数拉取带Git仓库的代码 #

无需修改composer.json配置，直接通过Composer参数拉取源代码：

• 执行命令拉取指定扩展的源代码：composer update myvendor/my-extension --prefer-source
• Composer会直接从对应Git仓库克隆代码到扩展安装目录，自带完整.git目录，可直接进行Git操作
• 注意该方案风险：后续执行Composer命令时如果没有加--prefer-source参数，可能会覆盖本地修改，仅适合临时快速调试使用。

内容的提问来源于stack exchange，提问作者Sybille Peters