如何在 TYPO3 CMS 项目中通过 Composer 管理扩展和依赖？

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

如何在 TYPO3 CMS 项目中通过 Composer 管理扩展和依赖？

2025-12-14

浏览次数：次

返回列表

TYPO3 CMS 项目必须用 Composer 管理所有扩展和依赖，禁止手动复制文件；新项目用 composer create-project typo3/cms-base-distribution 初始化，扩展统一通过 composer require 安装，私有扩展需配置 vcs 或 path 类型仓库，并确保 typo3/cms-composer-installers 正确启用。

如何在 typo3 cms 项目中通过 composer 管理扩展和依赖？

在 TYPO3 CMS 项目中，用 Composer 管理扩展和依赖是现代开发的标准做法，它能确保版本可控、依赖清晰、部署可重复。核心原则是：所有扩展（包括官方、第三方和自建）都应作为 Composer 包引入，不手动复制文件到 typo3conf/ext/。

初始化 Composer 项目并安装 TYPO3 核心

新项目推荐从官方骨架启动：

运行 composer create-project typo3/cms-base-distribution my-site，自动拉取最新稳定版 TYPO3 及基础配置
该命令生成标准目录结构，web/ 为 Web 根目录，vendor/ 存放所有 PHP 依赖，typo3conf/ext/ 保持为空——扩展由 Composer 自动安装到 vendor/ 并软链接或复制到正确位置
若迁移旧项目，先执行 composer init 初始化 composer.json，再用 composer require typo3/cms-core:^12（按需指定主版本）引入核心

安装和管理扩展（Extensions）

TYPO3 扩展已全部迁移到 Packagist，安装方式统一为 composer require：

安装官方扩展：如 composer require typo3/cms-fluid-styled-content
安装第三方扩展：如 composer require b13/container（注意包名通常不含 typo3-ter/ 前缀，Packagist 已标准化）
升级扩展：运行 composer update vendor/package-name（例如 composer update friendsoftypo3/flux），避免全量更新引发意外
卸载扩展：先在后台停用并删除数据（如必要），再执行 composer remove vendor/package-name（Composer 2.2+ 支持），或手动删 require 行后 composer install

处理私有扩展与本地开发

自有扩展不能直接发布到 Packagist 时，需配置自定义仓库：

挖错网

一款支持文本、图片、视频纠错和AIGC检测的内容审核校对平台。

185 查看详情挖错网

在 composer.json 的 repositories 字段添加类型为 vcs 的 Git 仓库，例如：
"repositories": [{"type": "vcs", "url": "https://git.example.com/my-company/my-extension.git"}]
确保扩展根目录含合法 composer.json，且 type 设为 typo3-cms-extension，如：
{"name": "my-company/my-extension", "type": "typo3-cms-extension", "require": {"typo3/cms-core": "^12"}}
本地快速测试可用 path 类型仓库，指向本地文件夹，适合开发阶段：
{"type": "path", "url": "../my-local-extensions/*"}

关键配置与常见注意事项

让 Composer 与 TYPO3 协同工作，需确认几个关键点：

typo3/cms-composer-installers 必须存在（新项目默认包含），它负责将 typo3-cms-extension 类型包正确安装到 typo3conf/ext/
启用 typo3/cms-composer-installers 的 symlink 模式（在 composer.json 中设 "extra": {"typo3/cms": {"symlinks": true}}），可加快开发时的修改反馈
生产环境部署前务必运行 composer install --no-dev --optimize-autoloader，减少体积并提升性能
避免混用 Extension Manager（EM）安装和 Composer 安装——EM 会绕过 Composer，导致状态不一致；后台仅用于启用/禁用、配置，不用于安装