API Schemas CollectionSchema - evansims/openfga-php GitHub Wiki
Schema definition specifically for validating and transforming collection data structures. This specialized schema handles arrays of objects, providing validation rules for collections while ensuring each item conforms to the specified item type. It supports wrapper keys for nested collection data and optional item requirements.
Table of Contents
OpenFGA\Schemas
- CollectionSchemaInterface (interface)
- Schema (item)
public function getClassName(): stringGet the fully qualified class name this schema defines. This method returns the class name that this schema describes, which is used during validation and object instantiation to ensure the correct model class is created.
string — The fully qualified class name for the model this schema defines
public function getItemType(): stringGet the type of each item in the collection.
string
public function getProperties(): arrayGet all properties defined in this schema. This method returns a comprehensive collection of all properties that make up this schema, including their validation rules, types, and default values. Each property defines how a specific field should be validated and processed.
array — An associative array of property names to their schema property definitions
public function getProperty(string $name): ?OpenFGA\Schemas\SchemaPropertyGet a specific property definition by name. This method retrieves the schema definition for a particular property, allowing you to access its validation rules, type information, and other metadata for individual fields.
| Name | Type | Description |
|---|---|---|
$name |
string |
The name of the property to retrieve |
SchemaProperty | null — The property definition if it exists, or null if the property is not defined in this schema
public function getWrapperKey(): ?stringGet the wrapper key for the collection data if any. Some collections expect data wrapped in a specific key (for example, Usersets uses 'child').
string | null — The wrapper key or null if data is not wrapped
public function requiresItems(): boolWhether the collection requires at least one item.
bool — True if the collection must contain at least one item, false if empty collections are allowed