TYPO3 v12（Composer 4）本地扩展开发：Symlink替代方案咨询

针对TYPO3 v11及以上版本无法通过传统symlink方式开发本地扩展的问题，以下是Composer环境下的可行替代方案，适配Ddev开发环境：

方案1：Composer Path Repository（推荐） #

这是Composer官方支持的本地包开发方式，既保留Composer依赖管理能力，又支持实时代码修改同步。

1. 配置项目composer.json
   在项目根目录的composer.json中添加仓库配置，指向你的本地扩展目录：

"repositories": [
    {
        "type": "path",
        "url": "../path/to/your/local-extension",
        "options": {
            "symlink": true
        }
    }
]

• url填写本地扩展相对于项目根目录的路径（推荐相对路径，适配团队协作）
• symlink: true强制Composer创建软链接而非复制文件，确保代码修改实时生效

2. 引入本地扩展
   在Ddev容器内执行Composer命令引入扩展：

ddev composer require your-vendor/your-extension:@dev

• @dev指定使用扩展的开发分支（需确保本地扩展的composer.json中配置了正确的分支信息）

3. 验证生效
   执行以下命令确认扩展已通过软链引入：

ddev composer show your-vendor/your-extension

输出中source字段应显示本地扩展的路径，此时修改本地扩展代码，TYPO3会实时识别。

方案2：Ddev Bind-Mount 直接映射到ext目录（快速测试用） #

若你习惯直接在typo3conf/ext目录开发，可通过Ddev挂载配置绕过Composer，但此方式不适合长期开发（会跳过依赖管理）：

1. 修改Ddev配置
   在项目的.ddev/config.yaml中添加挂载规则：

mounts:
  - type: bind
    source: ../path/to/your/local-extension
    target: /var/www/html/public/typo3conf/ext/your-extension

2. 重启Ddev并激活扩展
   执行ddev restart使配置生效，随后在TYPO3后台激活该扩展即可。

注意：若扩展包含Composer依赖，需手动在项目中引入对应依赖，否则会出现功能异常。

方案3：本地仓库管理多扩展（适合多扩展开发场景） #

若同时开发多个本地扩展，可统一管理到一个本地仓库目录：

1. 创建本地仓库目录
   在项目外新建目录（如../local-typo3-extensions），将所有本地扩展放入该目录。

2. 配置项目composer.json
   添加仓库配置指向该目录下的所有扩展：

"repositories": [
    {
        "type": "path",
        "url": "../local-typo3-extensions/*",
        "options": {
            "symlink": true
        }
    }
]

3. 按需引入扩展
   执行ddev composer require your-vendor/extension-a:@dev和ddev composer require your-vendor/extension-b:@dev即可分别引入扩展。

通用注意事项 #

• 本地扩展的composer.json必须包含完整配置：需指定name（格式为vendor/extension-name）、type: typo3-cms-extension、require及autoload等字段
• 若TYPO3未识别到扩展修改，执行ddev typo3 cache:flush清除缓存
• 协作开发时，需确保团队成员的本地扩展路径与配置中的url匹配，或使用绝对路径

内容的提问来源于stack exchange，提问作者Stefano Danieli