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
App\Data\PostData in the app/Data directory.
Custom Namespace
Change the namespace:
php artisan make:data PostData --namespace=DataTransferObjects
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
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
Caching data structures...
████████████████████ 100%
Cached 42 data classes
Show Cached Classes
Display which classes were cached:
php artisan data:cache-structures --show-classes
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:
- Before deploying to production
- After creating new data objects
- After modifying existing data objects
- 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
Data structure caching is not enabled
config/data.php:
'structure_caching' => [
'enabled' => true,
// ...
],
Clear Cache
Clear the data structures cache:
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.