README

A collection of handy Laravel Artisan commands for generating actions, DTOs, and configuring databases.

Requires PHP 8.2+ and Laravel 12 or 13.

Installation

composer require smonteromx/useful-artisan-commands --dev

Auto-discovery registers the commands automatically.

Automatic PostgreSQL Verification

When the package is installed, it automatically listens for migrate* Artisan commands. For PostgreSQL connections, it verifies that:

• the configured database exists, creating it through a maintenance postgres connection when possible
• the configured migrations schema exists when database.migrations.table uses schema.table notation

This requires no application service provider setup while Laravel package auto-discovery is enabled. The verification also runs eagerly during unit tests so migration-backed test databases can be prepared before the test suite touches the connection.

If package discovery is disabled for this package, manually register SMonteroMx\UsefulArtisanCommands\UsefulArtisanCommandsServiceProvider in bootstrap/providers.php.

Commands

make:action

Generates an action class in app/Actions/. The Action suffix is auto-appended.

php artisan make:action CreateUser
# -> app/Actions/CreateUserAction.php

php artisan make:action Billing/ChargeInvoice
# -> app/Actions/Billing/ChargeInvoiceAction.php

make:data

Generates a final readonly DTO class in app/Data/. The Data suffix is auto-appended.

php artisan make:data CreateUser
# -> app/Data/CreateUserData.php

app:config-db

Interactive prompt to configure PostgreSQL connection details in your .env file.

php artisan app:config-db

Prompts for host, port, database name, username, and password. Before saving, it shows a review table and lets you correct selected fields.

Customizing Stubs

Publish the stubs to customize the generated file templates:

php artisan vendor:publish --tag=useful-artisan-commands-stubs

This copies action.stub and data.stub to your project's stubs/ directory. The commands will use your local stubs over the package defaults.

License

MIT