Commands

Artisan commands for generating and caching Laravel Data objects

Laravel Data provides Artisan commands to streamline development and optimize production performance.

make:data

Generate new data objects quickly.

Basic Usage

php artisan make:data PostData

Creates App\Data\PostData in the app/Data directory.

Custom Namespace

Change the namespace:

php artisan make:data PostData --namespace=DataTransferObjects

Creates App\DataTransferObjects\PostData in app/DataTransferObjects.

Options

Option	Short	Description
--namespace	-N	The namespace (under \App) to place this Data class
--suffix	-s	Suffix the class with this value
--force	-f	Create the Data class even if the file already exists

Examples

# Custom namespace
php artisan make:data UserData --namespace=DTOs

# Custom suffix
php artisan make:data User --suffix=DTO

# Force overwrite
php artisan make:data PostData --force

Configuration

Customize default behavior in config/data.php:

'commands' => [
    'make' => [
        /*
         * The default namespace for generated Data classes. This exists under the application's root namespace,
         * so the default 'Data` will end up as '\App\Data', and generated Data classes will be placed in the
         * app/Data/ folder.
         */
        'namespace' => 'Data',
        
        /*
         * This suffix will be appended to all data classes generated by make:data, so that they are less likely
         * to conflict with other related classes, controllers or models with a similar name without resorting
         * to adding an alias for the Data object. Set to a blank string (not null) to disable.
         */
        'suffix' => 'Data',
    ],
]

Custom Stub

Publish and customize the stub file:

php artisan vendor:publish --tag=laravel-data-stubs

Edit the stub at stubs/data.stub:

<?php

namespace {{ namespace }};

use Spatie\LaravelData\Data;

class {{ class }} extends Data
{
    public function __construct(
        // Add your properties here
    ) {
    }
}

data:cache-structures

Cache data object analysis for production performance.

Basic Usage

php artisan data:cache-structures

Output:

Caching data structures...
████████████████████ 100%

Cached 42 data classes

Show Cached Classes

Display which classes were cached:

php artisan data:cache-structures --show-classes

Output:

Caching data structures...
████████████████████ 100%

Cached 42 data classes

+----------------------------------+
| Data Class                       |
+----------------------------------+
| App\Data\UserData                |
| App\Data\PostData                |
| App\Data\CommentData             |
| App\Data\CategoryData            |
| ...                              |
+----------------------------------+

When to Run

Run this command:

1. Before deploying to production
2. After creating new data objects
3. After modifying existing data objects
4. As part of your deployment script

Deployment Script Example

#!/bin/bash

# Pull latest code
git pull origin main

# Install dependencies
composer install --no-dev --optimize-autoloader

# Cache everything
php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan data:cache-structures

# Restart services
php artisan queue:restart

Error Handling

If caching is disabled in config:

php artisan data:cache-structures

Output:

Data structure caching is not enabled

Enable it in config/data.php:

'structure_caching' => [
    'enabled' => true,
    // ...
],

Clear Cache

Clear the data structures cache:

php artisan cache:clear

Or clear only data structures (if using a separate cache store):

php artisan cache:forget laravel-data:*

The cache key prefix is configurable in config/data.php under structure_caching.cache.prefix.