Download the PHP package cleaniquecoders/laravel-action without Composer

Simple Actionable for Laravel

This package, Simple Actionable for Laravel, provides a structured way to manage action classes in your Laravel applications, making it easier to encapsulate business logic, transformations, and validations within reusable classes. The package utilizes lorisleiva/laravel-actions to offer extended functionality, enabling actions to be executed in multiple contexts (e.g., jobs, controllers, event listeners) and simplifying your codebase.

Installation

You can install the package via composer:

Features

This package builds on top of lorisleiva/laravel-actions, allowing you to:

• Create versatile action classes that can be executed as invokable objects, controllers, or dispatched as jobs.
• Use property setters to configure actions dynamically.
• Apply transformations like hashing or encryption to specific fields.
• Manage updateOrCreate behavior with constraints on unique fields.

Usage

You can create an action using the Artisan command:

This will create an action in app\Actions\User:

New Features and Example Usage

1. Flexible Property Setter

You can set properties, such as hashFields, encryptFields, and constrainedBy, dynamically using the setProperty method:

This flexible property setting reduces boilerplate and simplifies action configuration.

2. Field Transformation with Hashing and Encryption

The ResourceAction class supports field-level transformations. For example, you can hash a password field and encrypt an ssn field:

After execution:

• The password field will be hashed for security.
• The ssn field will be encrypted, ensuring secure storage.

3. Constraint-Based updateOrCreate

Specify constraints to perform updateOrCreate actions based on unique fields or identifiers. Here’s an example of updating an existing user by id:

This allows precise control over updateOrCreate behavior based on custom constraints.

Using lorisleiva/laravel-actions for Multi-Context Execution

With lorisleiva/laravel-actions, actions created with this package can be used in multiple contexts. You can run the action as:

• An Invokable Object:

• A Controller:

• A Job:

• An Event Listener:

Testing

Run the tests with:

Changelog

Please see CHANGELOG for more information on recent changes.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Nasrul Hazim Bin Mohamad
• All Contributors

License

The MIT License (MIT). Please see License File for more information.