A package containing DTO casters
Installation
You can install the package via composer:
composer require morningtrain/data-transfer-object-casters
Usage
To use the provided casters, add an attribute CastWith, to the property you want to cast.
class DTO extends DataTransferObject
{
#[CastWith(BoolCaster::class)]
public bool $bool;
}
Bool
The Boolean caster is used to cast the provided value to a boolean.
It uses FILTER_VALIDATE_BOOL, see the php docs for more information
Date
The DateCaster will attempt to cast the provided value into a Carbon instance, using the provided format.
If no format is specified 'd.m.Y H:i:s' will be used.
use Morningtrain\DataTransferObjectCasters\Casters\DateCaster;
class DTO extends DataTransferObject
{
#[CastWith(DateCaster::class, format: 'Y-m-d')]
public Carbon $date;
}
Int
The IntCaster casts the provided value to an integer using (int) cast.
Trim
The TrimCaster will trim the provided value, so no whitespace remains around the value.
UppercaseFirst
The UppercaseFirstCaster will uppercase the first letter of the provided value, similar to php's ucfirst function.
Optionally, the caster can lowercase the rest of the string, like so.
use Morningtrain\DataTransferObjectCasters\Casters\UppercaseFirstCaster;
class DTO extends DataTransferObject
{
#[CastWith(UppercaseFirstCaster::class, lower: true)]
public string $ucFirstString;
}
If the provided value is not a string, it will return the provided value.
Testing
composer test
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
License
The MIT License (MIT). Please see License File for more information.
3 Oct 16, 2021
6 Sep 26, 2021
2 Sep 9, 2022
873 Jan 7, 2023
270 Dec 21, 2022
224 Dec 28, 2022
16 Oct 24, 2022
3 Nov 17, 2022
53 Dec 23, 2022
8 Jun 8, 2023
1 Feb 1, 2022
31 Jun 25, 2021
303 Oct 7, 2022
2 Oct 9, 2022
43 Dec 26, 2022
2 Sep 18, 2022
570 Dec 27, 2022
139 Jan 1, 2023
6k Jan 4, 2023