使用 Composer 管理 Kirby 项目可提升可维护性与协作效率。1. 初始化 composer.json 并安装 getkirby/cms；2. 推荐分离式结构，将 site 目录纳入版本控制，kirby 与 vendor 忽略；3. 通过 Composer 安装插件如 oblik/kirby-extended，并配置自动加载；4. 自定义插件可打包为私有包，通过 repositories 引入；5. 部署时仅提交核心文件与锁文件，运行 composer install --no-dev 实现一致环境；6. 结合 .env 文件管理多环境配置，确保安全隔离。保持结构统一与文档同步是关键。
Kirby CMS 本身是一个无数据库、文件驱动的轻量级内容管理系统，因其简洁和灵活性广受开发者喜爱。虽然 Kirby 核心不强制依赖 Composer，但在现代化开发中，使用 Composer 管理插件和第三方依赖不仅能提升项目可维护性，还能实现更高效的协作与部署流程。以下是基于 Composer 的 Kirby 开发工作流实践。
初始化 Composer 并组织项目结构
在 Kirby 项目中引入 Composer 的第一步是创建一个合理的项目结构，将核心文件与可管理的依赖分离。
推荐采用“分离式”结构，将 Kirby 核心和插件纳入版本控制之外，由 Composer 管理：
- /site – 存放你的内容、配置、模板和自定义代码（纳入 Git）
- /kirby – Kirby 核心文件，由 Composer 安装（不纳入 Git）
- /vendor – 第三方 PHP 包（不纳入 Git）
- composer.json – 定义项目依赖
执行以下命令初始化项目：
composer initcomposer require getkirby/cms
这会自动下载 Kirby 核心到 vendor/getkirby/cms，然后你可以通过入口文件（如 index.php）引导加载。
使用 Composer 安装和管理插件
越来越多的 Kirby 插件已发布到 Packagist，可通过 Composer 直接安装。例如安装一个常用的表单处理插件：
composer require oblik/kirby-extended该插件提供高级字段、助手函数等。安装后，插件会出现在 vendor/oblik/kirby-extended，你只需在 site/plugins 中创建符号链接或通过自动加载机制启用。
部分插件支持 PSR-4 自动加载，你可以在 site/config/config.php 中注册：
return ['plugins' => [
'oblik/extended' => true
]
];
或者，某些插件文档会说明是否需要手动引入（如通过 require_once），建议优先选择原生支持 Composer 的插件。
自定义插件的 Composer 化管理
如果你开发多个 Kirby 项目并共享自定义插件，可将这些插件打包为私有或公共 Composer 包。
步骤如下：
- 为插件创建独立仓库，并添加 composer.json
- 设置类型为 kirby-plugin，便于识别
- 在主项目中通过 repositories 引入私有 Git 仓库
示例配置：
"repositories": [{
"type": "git",
"url": "https://github.com/you/kirby-contact-form"
}
],
"require": {
"your/contact-form": "^1.0"
}
结合 CI/CD 工具，每次更新插件后主项目仅需运行 composer update your/contact-form 即可同步。
优化部署与团队协作流程
使用 Composer 后，部署流程变得更清晰：
- Git 仓库只包含 site/、composer.json、composer.lock 和构建脚本
- 服务器部署时运行 composer install --no-dev 安装精确版本的 Kirby 与插件
- 团队成员克隆项目后只需一条命令即可搭建完整环境
配合 .env 文件管理不同环境的配置，进一步实现环境隔离与安全控制。
基本上就这些。通过 Composer 管理 Kirby 项目，让依赖清晰可控，升级更安全，协作更顺畅。不复杂但容易忽略的是保持结构一致和文档同步。
