Download the PHP package predatorstudio/laravel-attribute-code-generators without Composer

Laravel Attribute Code Generators

v1.1

A Laravel package that generates a full CRUD scaffold from PHP 8.1 Attributes placed directly on Eloquent models. One command reads every model in your app, inspects its attributes, and writes controllers, services, repositories, DTOs, resources, migrations, policies, observers, factories, seeders, tests, and routes — only what you asked for, nothing more.

Requirements

• PHP 8.1+
• Laravel 10+

Installation

The service provider is auto-discovered via Laravel's package auto-discovery.

Publish the config file to customise paths:

This creates config/crud-generator.php in your application.

Claude Code integration (optional)

Install a /describe-attributes slash command into your project's Claude Code environment:

This copies a prompt file to .claude/commands/describe-attributes.md in your project root. After restarting Claude Code the command is available as a slash command:

Configuration

After publishing the config you can adjust these keys in config/crud-generator.php:

Output path overrides

The paths key lets you change the target directory for each generator. All paths are relative to the project root.

Example — if your services live in app/Libs/Services:

The generated UserService will be placed at app/Libs/Services/UserService.php with namespace App\Libs\Services.

Scanning subdirectories & automatic subpath mirroring

Models can be placed in any subdirectory under scan_path. The namespace is inferred from the folder structure, and every generated file mirrors the same subdirectory:

Generated files:

This ensures namespaces stay consistent across the entire generated scaffold without any manual configuration.

Usage

Annotate your model with the attributes that describe what you want generated, then run:

Available Attributes

#[Crud]

Enables CRUD generation for the model. Optionally restricts which HTTP methods are scaffolded.

#[Route]

Registers the resource route under the given path. Optionally applies middleware.

#[Resource]

Generates an API resource class. Specify which fields to expose, or omit fields to auto-generate from the model's visible fields() columns (respecting hidden: true).

#[Service]

Generates a service class. Pass interface: true to also generate a contract and bind it in the service container.

#[Repository]

Generates a repository class. Pass interface: true to also generate a contract and bind it.

#[DTO]

Generates a Data Transfer Object with readonly properties, a fromArray() factory, and a toArray() method. Fields marked hidden: true in fields() are excluded.

#[Policy]

Generates a policy class for the model.

#[Observer]

Generates an observer class and registers it automatically.

#[Factory]

Generates an Eloquent factory for the model with sensible faker defaults per column type.

#[Seeder]

Generates a database seeder that uses the model's factory to create records. The default count is 10.

#[UseSoftDeletes]

Adds soft-delete support: appends $table->softDeletes() to the generated migration and injects the SoftDeletes trait into the model.

Note: The attribute was renamed from #[SoftDeletes] to #[UseSoftDeletes] in v1.1 to avoid a name collision with the Eloquent SoftDeletes trait.

#[GenerateMigration]

Generates a create_*_table migration based on the model's fields() method. On subsequent runs the package compares saved column names against the current fields() list — if new columns are found it generates an add_columns_to_*_table ALTER migration.

#[ValidateFromMigration]

Generates StoreRequest and UpdateRequest validation rules derived from the migration columns. The UpdateRequest automatically prepends sometimes to every rule, making it suitable for PATCH requests.

Fields marked hidden: true in fields() are excluded from both requests.

#[BackedEnum]

Generates a backed enum for a field. Repeatable — add one per enum field.

Use filename to override the generated class name (useful when the auto-derived name conflicts with something else):

#[Action]

Generates single-purpose action classes (Create, Update, Delete) for the model.

#[GenerateTest]

Generates a feature test for the model's CRUD endpoints.

The fields() method

Define the model's schema by implementing a fields() method. It drives migration generation, validation rules, factories, DTOs, and resource output.

Field keys

Explicit relation definitions

For foreignId fields you can provide an explicit relation key to control how the BelongsTo relation is generated on the model. Without it the related model is derived automatically from the _id suffix.

When local or foreign differ from defaults the generated belongsTo() call includes the explicit key arguments:

Bindings provider

When interface: true is used on #[Service] or #[Repository], the package writes interface-to-implementation bindings to app/Providers/GeneratedBindingsProvider.php.

The generated block is wrapped in marker comments so that manually added bindings are preserved across runs:

Generated method signatures

All generated methods include explicit return types. Enable PHPDoc blocks via config:

Controller:

Service:

Full example

Running php artisan crud:sync on this model generates:

• UserController with the five resource methods and return types
• UserService + UserServiceInterface (bound in the container)
• UserRepository + UserRepositoryInterface (bound in the container)
• UserResource exposing id, name, email (password excluded via hidden)
• UserDTO with readonly properties (password excluded via hidden)
• UserStoreRequest + UserUpdateRequest with validation rules
• UserPolicy, UserObserver, UserFactory, UserSeeder (20 records)
• UserStatusEnum backed enum
• A feature test UserTest
• A migration with softDeletes()
• The team() relation injected into the model
• Routes registered under /users behind auth:sanctum

On the next run, already-generated artifacts are skipped. If new columns are added to fields(), only an ALTER migration is generated for the new columns.

License

MIT