How spatie/laravel-data works
Core Data Layer
• It to its essential concerns (BaseData, ValidateableData, TransformableData, etc.)
Data Processing Pipeline
• DataPipeline with its various pipes:
• AuthorizedDataPipe
• CastPropertiesDataPipe
• ValidatePropertiesDataPipe
• MapPropertiesDataPipe
Support Systems (arranged in clusters)
a. Transformation Layer
• Transformers
• Casts
• Normalizers
b. Validation Layer
• ValidationAttributes
• RuleInferrers
• Validators
c. Creation Layer
• Factories
• CreationContext
• DataContainer
Integration Points
• Connections to Laravel's core components:
• Eloquent Models
• Form Requests
• API Resources
• TypeScript generation capability
Data Collections
• Relationship between Data objects and Collections
• Specialized collections (Paginated, Cursor-paginated)
┌─────────────────────────────── Laravel Application ───────────────────────────────┐
• ┌─────────── Data Processing Pipeline ───────────┐ │
• ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ │ │
• Auth │─► │Cast │─► │Valid│─► │Map │ │ │
• Pipe │ │Pipe │ │Pipe │ │Pipe │ │ │
• ┘ └─────┘ └─────┘ └─────┘ │ │
• ┬───────────────────────┘ │
• ┌─────────── Core Data Layer ──────────┐ │
• ┌─────────────────┐ │ ┌─── Integration Points ───┐ │
• Data │ │ │ │ │
• ┬────────┘ │ │ - Eloquent │ │
• API Resources │ │
• ┌───────────┴───────────┐ │ │ - Form Requests │ │
• TypeScript │ │
• ▼ ▼ │ │ │ │
• Validation Transformation │ └──────────────────────────┘ │
• ┘ │
• ┘
Important Considerations:
Legends
• Component type indicators
Validation flow
• Request data → Validation → Data Object creation
• Attribute-based validation
Extensibility points
• Custom transformers
• Custom casts
• Custom validation rules