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

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

在 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 时，需配置自定义仓库：

标签： composer typo3 php js git json cms ai