使用 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 项目：
composer create-project craftcms/craft your-project-name这会生成一个标准目录结构，包括 config/、templates/、web/ 等目录，并自动配置好基础的 composer.json 文件。
关键点：
- 核心文件（如 vendor/craftcms/cms）由 Composer 管理，不应手动修改。
- 项目自定义代码放在正确位置：插件在 plugins/，模板在 templates/，配置在 config/。
使用 Composer 安装和管理插件
大多数 Craft 插件都发布在 Plugin Store 并支持 Composer 安装。
例如安装 Redactor 编辑器插件：
composer require craftcms/redactor安装后，登录 Craft 控制面板，在“Settings → Plugins”中启用即可。
常见操作：
- 查看已安装插件：composer show
- 更新所有依赖：composer update
- 更新特定插件：composer update vendor/plugin-name
- 卸载插件：composer remove vendor/plugin-name
每次更改 composer.json 后，确保提交到版本控制系统，让团队同步依赖状态。
Conventional Commits v1.0.0 分支、工作树命名及提交信息规范，适用于 GitHub 与 GitLab 项目，用于创建分支和命名工作树等场景。
配置环境与部署流程
利用 Composer 脚本钩子可以自动化部署任务。
在 composer.json 中添加脚本示例：
"scripts": { "post-install-cmd": [ "@php web/index.php craft setup/welcome" ], "post-update-cmd": [ "@php web/index.php craft migrate/all", "@php web/index.php craft project-config/apply" ] }这样每次运行 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 项目就能做到依赖明确、配置可追溯、部署可重复。不复杂但容易忽略细节，比如脚本顺序或环境隔离，稍加规范就能大幅提升团队效率。
