架构

架构是可选的。架构有两项独立用途：验证每次写入，并声明哪些字段获得索引。没有架构的集合可以接受任意数组数据。

$schema = Schema::collection('posts')
    ->string('slug')->unique()
    ->string('status')->index()
    ->int('publishedAt')->range()
    ->bool('featured')
    ->required(['slug', 'status']);

$posts = new DocStore($root, 'posts', schema: $schema);

架构的集合名称必须与存储的集合名称一致，否则构造时会抛出错误。将架构传给构造函数还会立即同步已声明的索引。

验证规则

• required 字段必须存在于写入的数据中。检查的是字段是否存在：显式的 null 会满足必填字段要求。
• 仅当类型化字段存在且非 null 时才会检查。string 字段会拒绝 int 值；float 字段同时接受 float 和 int。
• mixed 字段接受任何内容，适合在不限制类型的情况下将字段标记为必填或建立索引。
• 未在架构中声明的字段不受限制。

验证失败时会抛出 StorageException，且不会写入任何内容。

字段类型和标志

支持的类型：string、int、float、bool、mixed。

每个字段的标志：index()（相等性索引）、unique()（写入时强制唯一性）、range()（用于 gt/lt/between/prefix 的有序索引及有序范围查询），以及 required()。

架构变更

创建存储时会同步索引。如果架构变更改变了声明的索引集合，索引清单也会随之改变，并从现有记录重建受影响的索引；验证规则的变更只适用于后续写入，不会重写已存储的记录。

同一个 Schema 对象可以重复用于映射 SQL 镜像 中的有类型列， 即使集合自身的存储没有使用该模式，也同样适用。