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($data);
$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($data);
$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:

$value = DotPathHelper::get($data, 'user.profile.name');

ObjectHelper

Object manipulation utilities:

$clone = ObjectHelper::deepClone($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: