使用 Composer 可实现 Craft CMS 项目的现代化管理。1. 通过 composer create-project craftcms/craft 初始化项目，自动生成标准目录与 composer.json；核心文件由 Composer 管理，禁止手动修改。2. 插件通过 Composer 安装（如 composer require craftcms/redactor），在控制面板启用，支持版本锁定与团队同步。3. 利用 composer.json 的脚本钩子自动化部署：post-install-cmd 和 post-update-cmd 可自动执行迁移与配置同步。4. 配合 Git 管理 project config（config/project/），忽略 vendor/、storage/ 等运行时目录，确保配置可追溯。5. 生产部署时执行 composer install --no-dev、应用配置并清缓存，保证环境一致。规范流程提升协作效率。

Craft CMS 从 3.x 版本开始全面拥抱 Composer，将依赖管理现代化。使用 Composer 不仅能更清晰地管理插件和核心更新，还能实现可靠的版本控制与团队协作部署。下面是如何用 Composer 构建一个现代化、可维护的 Craft CMS 项目工作流。

初始化项目并安装 Craft CMS

现代 Craft 项目通常不直接下载完整包，而是通过 Composer 创建项目结构。

打开终端，运行以下命令来创建新的 Craft 项目：

这会生成一个标准目录结构，包括 config/、templates/、web/ 等目录，并自动配置好基础的 composer.json 文件。

关键点：

• 核心文件（如 vendor/craftcms/cms）由 Composer 管理，不应手动修改。
• 项目自定义代码放在正确位置：插件在 plugins/，模板在 templates/，配置在 config/。

使用 Composer 安装和管理插件

大多数 Craft 插件都发布在 Plugin Store 并支持 Composer 安装。

例如安装 Redactor 编辑器插件：

安装后，登录 Craft 控制面板，在“Settings → Plugins”中启用即可。

常见操作：

• 查看已安装插件：composer show
• 更新所有依赖：composer update
• 更新特定插件：composer update vendor/plugin-name
• 卸载插件：composer remove vendor/plugin-name

每次更改 composer.json 后，确保提交到版本控制系统，让团队同步依赖状态。

配置环境与部署流程

利用 Composer 脚本钩子可以自动化部署任务。

在 composer.json 中添加脚本示例：

这样每次运行 composer install 或 update 后，系统会自动执行数据库迁移和项目配置同步。

生产环境部署建议步骤：

• 拉取最新代码
• 运行 composer install --no-dev（跳过开发依赖）
• 运行 php craft project-config/apply 应用配置变更
• 清除缓存：php craft clear-caches/all

项目配置与 Git 管理策略

Craft 的“Project Config”功能将设置导出为 YAML 文件（位于 config/project/**），配合 Composer 可实现配置版本化。

推荐 .gitignore 设置：

• 忽略 vendor/ 目录（由 Composer 重建）
• 忽略 storage/ 和 web/cpresources/（运行时生成）
• 保留 config/project/ 到 Git，确保配置可追踪

开发流程：

• 在本地进行内容模型调整
• 检查生成的 YAML 变更并提交
• 部署到测试或生产环境后运行 project-config/apply

注意：避免在生产环境直接修改设置，应始终从开发环境推送配置。

基本上就这些。用好 Composer，你的 Craft 项目就能做到依赖明确、配置可追溯、部署可重复。不复杂但容易忽略细节，比如脚本顺序或环境隔离，稍加规范就能大幅提升团队效率。