Home

🚀 Laravel Arc

A modern YAML-driven DTO generator for Laravel applications

Laravel Arc transforms your data structures into type-safe, validated PHP DTOs through simple YAML definitions. Define your data schemas in readable YAML files and let Laravel Arc generate powerful, feature-rich Data Transfer Objects with automatic validation, field transformers, and collection handling.

🌟 Why Laravel Arc?

• 📄 YAML-First: Define DTOs in simple, readable YAML files
• 🔒 Type-Safe: Generate PHP 8.3+ classes with strict typing
• ✅ Auto-Validation: Built-in Laravel validation from YAML definitions
• 🔄 Field Transformers: Automatic data transformation (trim, slugify, normalize)
• 📊 Export Formats: Convert to JSON, XML, CSV, YAML, and more
• 🎯 Behavioral Traits: Timestamps, UUIDs, soft deletes, and tagging
• 📦 Collection Support: Fluent handling of DTO collections

⚡ Quick Start

1. Install the Package

composer require grazulex/laravel-arc

2. Create Your First YAML Definition

# resources/arc/user.yaml
header:
  class: UserDto
  namespace: App\DTOs

fields:
  name:
    type: string
    required: true
    max_length: 255
    
  email:
    type: email
    required: true
    unique: true
    
  age:
    type: integer
    min: 18
    max: 120

3. Generate Your DTO

php artisan dto:generate user.yaml

4. Use Your Generated DTO

use App\DTOs\UserDto;

// Create from array
$user = UserDto::from([
    'name' => 'John Doe',
    'email' => '[email protected]',
    'age' => 30
]);

// Access properties directly
echo $user->name; // "John Doe"
echo $user->email; // "[email protected]"

// Export to different formats
$json = $user->toJson();
$array = $user->toArray();

🗺️ Documentation Guide

🚀 Getting Started

• Installation & Setup - Complete installation and configuration
• Your First DTO - Create your first DTO in 5 minutes
• Understanding YAML Structure - Learn the YAML schema basics

📚 Core Concepts

• Field Types - All 65+ supported field types
• Field Transformers - Data transformation capabilities
• Behavioral Traits - Timestamps, UUIDs, soft deletes
• Generated DTO Structure - Understanding generated code

🔧 Advanced Features

• Nested DTOs - Working with complex data structures
• Collections - Managing arrays of DTOs

⚙️ CLI & Configuration

• Artisan Commands - Complete command reference
• Configuration - Package configuration options

📖 Practical Examples

• API Integration Example - Real-world API usage
• Complete Examples - All examples in one place

🎯 Key Concepts

YAML → DTO Generation Flow:

YAML Definition → Laravel Arc → Generated DTO Class
     ↓                ↓              ↓
  Schema Rules   →  Validation   →  Type-Safe Code

Laravel Arc takes your YAML definitions and generates modern PHP classes that include:

• Readonly properties for immutability
• Automatic validation based on field rules
• Type enforcement with PHP 8.3+ features
• Collection methods for array handling
• Export capabilities to multiple formats

🏁 What's Next?

1. New to Laravel Arc? Start with Installation & Setup
2. Want to dive in? Try Your First DTO
3. Need examples? Check API Integration Example
4. Advanced user? Explore Field Transformers

---

Laravel Arc - From YAML to Type-Safe DTOs in seconds 🚀