API Reference Overview

Complete API documentation for Data Helpers.

Introduction

Browse the complete API reference:

Main Classes - Core functionality
Helpers - Utility classes
Attributes - PHP attributes
Casts - Type casting classes

Main Classes

DataAccessor

Read data using dot-notation paths:

$accessor = DataAccessor::make(['user' => ['profile' => ['name' => 'John']]]);
$value = $accessor->get('user.profile.name');

DataMutator

Modify data using dot-notation paths:

$mutator = DataMutator::make($data);
$mutator->set('user.profile.name', 'John Doe');

DataMapper

Map data between structures:

$result = DataMapper::source($src)
    ->target($tgt)
    ->template($template)
    ->map()
    ->getTarget();

DataFilter

Filter and transform data:

$filter = DataFilter::make(['name' => 'John', 'email' => 'john@example.com', 'age' => 30]);
$filtered = $filter->only(['name', 'email']);

SimpleDto

Type-safe data transfer objects:

class UserDto extends SimpleDto
{
    public function __construct(
        public readonly string $name,
        public readonly string $email,
    ) {}
}

Helpers

EnvHelper

Framework-agnostic environment variables:

$value = EnvHelper::get('APP_NAME', 'default');

MathHelper

High-precision math operations:

$result = MathHelper::add('0.1', '0.2', 2); // '0.30'

ConfigHelper

Universal configuration helper:

$value = ConfigHelper::get('app.name', 'default');

DotPathHelper

Dot-path notation utilities:

$segments = DotPathHelper::segments('user.profile.name');
// $segments = ['user', 'profile', 'name']

ObjectHelper

Object manipulation utilities:

$object = (object)['name' => 'John', 'age' => 30];
$clone = ObjectHelper::copy($object);

Attributes

Validation Attributes

30+ validation attributes:

#[Required, Email, Min(3), Max(50)]
public readonly string $email;

Conditional Attributes

18 conditional attributes:

#[WhenAuth, WhenCan('edit'), WhenRole('admin')]
public readonly ?string $adminNotes = null;

Cast Attributes

Type casting:

#[Cast(DateTimeCast::class)]
public readonly Carbon $createdAt;

Mapping Attributes

Property mapping:

#[MapFrom('user.full_name')]
public readonly string $name;

Casts

Primitive Casts

Basic type casts:

StringCast, IntCast, FloatCast, BoolCast, ArrayCast

Date Casts

Date and time casts:

DateTimeCast, DateCast, TimeCast, TimestampCast

Enum Casts

Enum casts:

EnumCast, BackedEnumCast

Collection Casts

Collection casts:

CollectionCast, DataCollectionCast