Cockpit 核心概念精讲：Collections、Singletons 与 Trees 到底该怎么选？
Cockpit 核心概念精讲Collections、Singletons 与 Trees 到底该怎么选【免费下载链接】CockpitCockpit Core - Content Platform项目地址: https://gitcode.com/gh_mirrors/cockp/CockpitCockpit CMS 是一款开源的 headless 内容平台它最迷人的地方在于你不需要写一行后端代码就能通过动态内容模型快速搭建出网站、API 甚至整个应用的数据层。而这一切的起点就是创建内容模型时首先要面对的选择题——Collections集合、Singletons单例与 Trees树三种类型分别对应什么样的内容结构新手很容易在这第一步就卡住。这篇文章用最通俗的语言帮你一次搞清楚三者的区别与适用场景从此建模型不再纠结。一、先搞懂一个前提什么是内容模型在 Cockpit 中内容模型Model是一套字段定义的模板相当于数据结构的说明书。你在后台创建一个模型后Cockpit 会自动帮你生成对应的存储结构、管理界面以及 REST / GraphQL 查询接口。在后台点击创建模型时你首先要选的就是这个模型的type类型collection、singleton还是tree。选择不同后续的内容管理方式和 API 查询方式完全不同。小提示模型定义的源码位于modules/Content/Helper/Model.php其中create()方法会校验模型类型并写入配置默认类型就是collection。二、Collections适合成批出现的同类内容Collections集合是最常用、也最直观的类型。它适合承载同一种结构、有多条记录的内容比如 博客文章列表️ 商品目录 新闻动态 团队成员介绍集合的特点是一张表里有很多条记录items每条记录结构相同但内容不同。Cockpit 为集合提供了最完整的能力批量管理支持批量修改、批量发布、克隆clone等操作对应源码modules/Content/Controller/Collection.php中的batchUpdate()、updateState()等接口灵活的列表视图可以保存多种筛选视图方便运营人员切换视角强大的查询支持 MongoDB 查询语法可过滤、排序、分页、字段投影还能通过populate自动填充关联内容。典型场景举例一个电商网站的商品模型用 Collection 再合适不过场景说明商品列表页分页加载、按价格/上架时间排序分类筛选用$gte/$lte做价格区间查询搜索用$regex做模糊匹配三、Singletons只为全站仅一份的内容而生Singletons单例天生只有一条记录没有列表的概念。它适合承载那些一个站点只有一份的全局内容比如 首页配置轮播图、主打文案、SEO 信息⚙️ 网站全局设置联系方式、社交链接 关于我们、联系我们等单页内容从源码modules/Content/Controller/Singleton.php可以看到整个控制器里几乎只有一个item()方法——因为它不需要列表、不需要批量操作打开就是直接编辑唯一的那条数据。后台界面也因此更简洁编辑人员不用面对列表页再点进去的繁琐流程。为什么不用 Collection 代替你当然可以用一个只允许添加一条数据的 Collection 来模拟但 Singleton 的价值在于后台体验更好打开即编辑少一层跳转API 更简单直接GET /api/content/item/homepage就能取到内容不需要传 id 或 filter。四、Trees天生适合有层级的内容Trees树用于承载带有父子层级关系的内容比如️ 商品分类父分类 → 子分类 → 孙分类 导航菜单 文档目录 / FAQ 分组树的结构在底层通过_pid父节点 ID和_o同级排序两个字段来维护对应源码modules/Content/Controller/Tree.php。这套实现带来了两个非常实用的特性拖拽排序后台可以直接拖拽调整顺序与层级通过updateOrder()保存递归删除删除一个父节点时Cockpit 会通过_remove()递归删除其下所有子节点不会留下孤儿数据。典型场景举例比如一个帮助中心文档可以这样组织帮助中心根 ├── 账户管理 │ ├── 注册与登录 │ └── 找回密码 ├── 订单相关 │ ├── 下单流程 │ └── 退款规则这样的层级结构用 Tree 表达前台导航和面包屑都能轻松生成。五、一张表看懂三者的核心区别对比维度Collections 集合Singletons 单例Trees 树数据量多条记录仅一条记录多条记录层级关系❌ 无❌ 无✅ 有父子层级后台交互列表 详情直接编辑树形拖拽排序方式按字段排序不适用同级手动排序典型用途文章、商品、成员首页、站点设置分类、导航、目录控制器示例Collection.phpSingleton.phpTree.php六、三分钟判断法到底该选哪个面对新需求时按下面三个问题快速决策这个内容在站点上是否只出现一份是 → 选Singleton。这些内容之间是否存在父子层级关系是 → 选Tree。以上都不是就是一批结构相同的记录→ 选Collection。再补充两个进阶判断技巧内容之间有关联怎么办三种类型都支持contentItemLink字段进行内容关联配合populate参数可以自动把关联内容展开无需升级类型混合需求怎么办一个站点可以同时存在多种模型例如商品用 Collection、商品分类用 Tree、站点配置用 Singleton三者各司其职互不冲突。七、小实践在 Cockpit 里搭建一个内容结构假设你要做一个极简博客只需三步文章模型→ 选 Collection字段加titletext、contentwysiwyg、publishedboolean、tagstags分类模型→ 选 Tree字段加nametext、slugtext站点设置模型→ 选 Singleton字段加site_nametext、logoasset。创建完成后Cockpit 会自动为每个模型生成 REST API 和 GraphQL 接口。比如文章列表的 REST 请求就是GET /api/content/items/blog?filter{published:true}相关的接口定义可以在modules/Content/api.php中查看内容增删改查的核心逻辑则封装在modules/Content/Helper/Content.php中。八、总结选择没有对错只有合不合适Collections、Singletons 与 Trees 是 Cockpit CMS 内容管理的三大基石它们各自擅长处理列表型、单体型、层级型三种不同的内容结构。只要记住一句话——成批的用 Collection单份的用 Singleton有层级的用 Tree——绝大多数场景都能轻松对号入座。选对了类型不仅后台操作更顺手前台的查询接口也会更简洁高效。如果你正在评估或刚刚上手 Cockpit不妨现在就打开后台用这三种类型各建一个模型试试感受一下它们的不同手感很快你就能形成自己的判断直觉了。【免费下载链接】CockpitCockpit Core - Content Platform项目地址: https://gitcode.com/gh_mirrors/cockp/Cockpit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
