PHPackages                             litepie/actions - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. litepie/actions

ActiveLibrary[Framework](/categories/framework)

litepie/actions
===============

A comprehensive Laravel Actions package for implementing the Action pattern with validation, events, and caching

v1.0.2(8mo ago)0504MITPHPPHP ^8.2|^8.3

Since Aug 20Pushed 8mo agoCompare

[ Source](https://github.com/Litepie/Actions)[ Packagist](https://packagist.org/packages/litepie/actions)[ RSS](/packages/litepie-actions/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (1)Dependencies (12)Versions (4)Used By (4)

🚀 Litepie Actions - Advanced Laravel Action Pattern Package
===========================================================

[](#-litepie-actions---advanced-laravel-action-pattern-package)

[![Latest Version on Packagist](https://camo.githubusercontent.com/611fbba2dc23ac558f3a6c1792c5134468953b0478d1535418974d3299c04872/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c6974657069652f616374696f6e732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/litepie/actions)[![GitHub Tests Action Status](https://camo.githubusercontent.com/25f62ba8f5ab64291e7568c3aacf8e48b5341940515205359773b091bea5bb58/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f6c6974657069652f616374696f6e732f72756e2d74657374733f6c6162656c3d7465737473)](https://github.com/litepie/actions/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/00ca1844d5ed5fa8934f554240c9b328a30dc7e1b450452a7903cc2c2c01fa46/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f6c6974657069652f616374696f6e732f436865636b253230262532306669782532307374796c696e673f6c6162656c3d636f64652532307374796c65)](https://github.com/litepie/actions/actions?query=workflow%3A%22Check+%26+fix+styling%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/04217c8326be0f0a18728c9e0e73332a1d3efb95badc8eb694ca34f3939263de/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6c6974657069652f616374696f6e732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/litepie/actions)

A comprehensive Laravel package for implementing the Action pattern with advanced features including authorization, validation, caching, sub-action orchestration, form management, event handling, and comprehensive logging.

✨ Features
----------

[](#-features)

### 🎯 **Core Functionality**

[](#-core-functionality)

- **Action Pattern Implementation** - Clean, testable business logic organization
- **Multiple Action Types** - BaseAction, StandardAction, CompleteAction
- **Trait-Based Architecture** - Mix and match functionality as needed
- **Result Objects** - Standardized success/failure handling

### 🔐 **Authorization & Security**

[](#-authorization--security)

- **Gate-Based Authorization** - Laravel gate integration
- **User Context Tracking** - Full user authentication support
- **Permission Checking** - Automatic authorization validation

### ✅ **Validation & Forms**

[](#-validation--forms)

- **Laravel Validator Integration** - Built-in validation support
- **Dynamic Form Generation** - Auto-generate forms from actions
- **Custom Validation Rules** - Flexible validation configuration
- **Form-Action Integration** - Seamless form and validation flow

### 🔄 **Sub-Actions & Orchestration**

[](#-sub-actions--orchestration)

- **Sub-Action Execution** - Execute related actions automatically
- **Conditional Logic** - Run sub-actions based on conditions
- **Before/After Hooks** - Control execution timing
- **Error Handling** - Continue or fail based on configuration

### 📧 **Notifications & Events**

[](#-notifications--events)

- **Automatic Notifications** - Send notifications on action completion
- **Laravel Events** - Fire events during action lifecycle
- **Multiple Recipients** - Notify different user groups
- **Queue Integration** - Async notification delivery

### 📊 **Logging & Auditing**

[](#-logging--auditing)

- **Comprehensive Logging** - Full action execution tracking
- **ActionLog Model** - Database storage with relationships
- **Rich Context** - User, IP, timestamps, properties
- **Searchable History** - Query and filter action logs

### ⚡ **Performance & Scalability**

[](#-performance--scalability)

- **Result Caching** - Cache action results for performance
- **Async Execution** - Queue-based background processing
- **Batch Processing** - Execute multiple actions efficiently
- **Pipeline Support** - Chain actions with middleware
- **Retry Logic** - Automatic retry with exponential backoff

### 🎛️ **Advanced Features**

[](#️-advanced-features)

- **Action Manager** - Centralized action registration and execution
- **Middleware Support** - Rate limiting, logging, custom middleware
- **Conditional Actions** - Execute different actions based on conditions
- **Metrics Collection** - Execution time and memory tracking
- **Helper Functions** - Convenient global helper functions

📦 Installation
--------------

[](#-installation)

Install the package via Composer:

```
composer require litepie/actions
```

Publish the configuration file:

```
php artisan vendor:publish --tag=actions-config
```

Run the migrations to create the action logs table:

```
php artisan migrate
```

🚀 Quick Start
-------------

[](#-quick-start)

### Creating Your First Action

[](#creating-your-first-action)

Generate a new action using the Artisan command:

```
php artisan make:action CreateUserAction --validation --cacheable
```

This creates a basic action class:

```