Examples Overview

Real-world examples and use cases for Data Helpers.

Introduction

Browse practical examples covering common use cases:

• ✅ API Integration - External APIs, webhooks, REST clients
• ✅ Form Processing - Contact forms, registration, file uploads
• ✅ Database Operations - CRUD, relationships, migrations
• ✅ File Upload - Images, documents, validation
• ✅ Real-World Apps - E-commerce, blog, SaaS

Quick Examples

API Integration

class UserDTO extends SimpleDTO
{
    public function __construct(
        #[MapFrom('user.name')]
        public readonly string $name,

        #[MapFrom('user.email')]
        public readonly string $email,
    ) {}
}

$response = Http::get('https://api.example.com/users/1');
$dto = UserDTO::fromArray($response->json());

Form Processing

class ContactFormDTO extends SimpleDTO
{
    public function __construct(
        #[Required, Min(3)]
        public readonly string $name,

        #[Required, Email]
        public readonly string $email,

        #[Required, Min(10)]
        public readonly string $message,
    ) {}
}

$dto = ContactFormDTO::validateAndCreate($_POST);

Database Operations

class UserDTO extends SimpleDTO
{
    public function __construct(
        public readonly string $name,
        public readonly string $email,
    ) {}
}

// From model
$dto = UserDTO::fromModel($user);

// To model
$user = $dto->toModel(User::class);

Browse Examples

• API Integration - External APIs, webhooks
• Form Processing - Contact forms, registration
• Database Operations - CRUD, relationships
• File Upload - Images, documents
• Real-World Apps - Complete applications

Example Repository

All examples are available in the repository:

git clone https://github.com/event4u-app/data-helpers.git
cd data-helpers/examples

Run examples:

php examples/01-basic-accessor.php
php examples/62-api-integration.php
php examples/78-real-world-ecommerce.php

See Also

• Getting Started - Quick start guide
• SimpleDTO Introduction - DTO basics
• Framework Integration - Framework guides