Casts API

Complete API reference for cast classes.

Primitive Casts

StringCast

#[Cast(StringCast::class)]
public readonly string $name;

IntCast

#[Cast(IntCast::class)]
public readonly int $age;

FloatCast

#[Cast(FloatCast::class)]
public readonly float $price;

BoolCast

#[Cast(BoolCast::class)]
public readonly bool $active;

ArrayCast

#[Cast(ArrayCast::class)]
public readonly array $tags;

Date & Time Casts

DateTimeCast

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

#[Cast(DateTimeCast::class, format: 'Y-m-d H:i:s')]
public readonly Carbon $updatedAt;

DateCast

#[Cast(DateCast::class)]
public readonly Carbon $birthDate;

TimeCast

#[Cast(TimeCast::class)]
public readonly Carbon $startTime;

TimestampCast

#[Cast(TimestampCast::class)]
public readonly Carbon $timestamp;

Enum Casts

EnumCast

#[Cast(EnumCast::class)]
public readonly Status $status;

BackedEnumCast

#[Cast(BackedEnumCast::class)]
public readonly Role $role;

Collection Casts

CollectionCast

#[Cast(CollectionCast::class)]
public readonly Collection $items;

DataCollectionCast

#[Cast(DataCollectionCast::class, itemClass: UserDTO::class)]
public readonly DataCollection $users;

Object Casts

ObjectCast

#[Cast(ObjectCast::class, class: Address::class)]
public readonly Address $address;

DTOCast

#[Cast(DTOCast::class, class: UserDTO::class)]
public readonly UserDTO $user;

Security Casts

EncryptedCast

#[Cast(EncryptedCast::class)]
public readonly string $ssn;

HashedCast

#[Cast(HashedCast::class)]
public readonly string $password;

Special Casts

JsonCast

#[Cast(JsonCast::class)]
public readonly array $metadata;

DecimalCast

#[Cast(DecimalCast::class, precision: 2)]
public readonly string $price;

UuidCast

#[Cast(UuidCast::class)]
public readonly string $uuid;

IpAddressCast

#[Cast(IpAddressCast::class)]
public readonly string $ipAddress;

UrlCast

#[Cast(UrlCast::class)]
public readonly string $website;

Custom Casts

Creating a Custom Cast

use event4u\DataHelpers\SimpleDTO\Contracts\Cast;

class UpperCaseCast implements Cast
{
    public function cast(mixed $value): string
    {
        return strtoupper((string) $value);
    }

    public function uncast(mixed $value): string
    {
        return strtolower((string) $value);
    }
}

// Usage
#[Cast(UpperCaseCast::class)]
public readonly string $name;

See Also

• Type Casting Guide - Complete guide
• Custom Casts - Create custom casts
• Casting Attributes - Cast attribute reference