Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/spatie/laravel-data/llms.txt

Use this file to discover all available pages before exploring further.

Sometimes you have a data object with properties which shouldn’t always be set, for example in a partial API update where you only want to update certain fields. In this case you can make a property Optional as such: 
use Spatie\LaravelData\Optional;

class SongData extends Data
{
    public function __construct(
        public string $title,
        public string|Optional $artist,
    ) {
    }
}
You can now create the data object as such: 
SongData::from([
    'title' => 'Never gonna give you up'
]);
The value of artist will automatically be set to Optional. When you transform this data object to an array, it will look like this: 
[
    'title' => 'Never gonna give you up'
]
Optional properties are automatically excluded from the array representation when they are not set.

​
Manual Optional Values

You can manually use Optional values within magical creation methods as such: 
class SongData extends Data
{
    public function __construct(
        public string $title,
        public string|Optional $artist,
    ) {
    }
    
    public static function fromTitle(string $title): static
    {
        return new self($title, Optional::create());
    }
}

​
Converting Optional to Null

It is possible to automatically update Optional values to null: 
class SongData extends Data {
    public function __construct(
        public string $title,
        public Optional|null|string $artist,
    ) {
    }
}

SongData::factory()
    ->withoutOptionalValues()
    ->from(['title' => 'Never gonna give you up']); // artist will `null` instead of `Optional`
You can read more about this here.

Build docs developers (and LLMs) love

Get started for freeTalk to us