스키마

스키마는 선택 사항입니다. 스키마는 서로 독립적인 두 가지 역할을 합니다. 모든 쓰기를 검증하고, 어떤 필드에 인덱스를 적용할지 선언합니다. 스키마가 없는 컬렉션은 모든 배열 데이터를 허용합니다.

$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 미러의 형식 지정 열을 매핑할 수 있습니다. 저장소에서 해당 스키마를 사용하지 않는 컬렉션에도 적용할 수 있습니다.