README

Laravel Hooks is a production-ready, universal extensibility system for Laravel 12. Inspired by WordPress but modernized with PHP 8.5 attributes, Strict Typing, and Deep Laravel Integration.

✨ Features

• ⚡ Actions & Filters: High-performance hook system (addAction, applyFilters).
• 🧬 Attribute-based: Register hooks via #[HookAction] and #[HookFilter].
• 🛡️ Type-Safe: Strict signatures contracts and BackedEnum support.
• 🚀 Async & Queued: Dispatch heavy actions to Laravel Queue via Hook::queueAction.
• 🔍 Inspector & Debugbar: Real-time profiling with laravel-debugbar integration.
• 🌈 Context Aware: Scoped hooks for specific instances (Hook::for($model)).
• 📦 Ecosystem Ready: Pipelines, Deprecations, IDE Help, and Compilation.

📦 Installation

composer require alizharb/laravel-hooks

📚 Documentation

• Basics: Actions, Filters, Priorities, and Attributes.
• Advanced Features: Typed Hooks, Wildcards, Scopes, Pipelines.
• Async & Queue: Background processing.
• Ecosystem & Safe DX: Signatures, Deprecations, IDE Helper, Compilation.
• Integrations: Debugbar, Eloquent, Blade.
• CLI Tooling: Artisan commands.

🚀 Quick Start

Basic Usage

use AlizHarb\LaravelHooks\Facades\Hook;

// Register
Hook::addAction('order.created', function ($order) {
    Log::info("Order #{$order->id} created");
});

// Dispatch
Hook::doAction('order.created', $order);

Attribute Registration

use AlizHarb\LaravelHooks\Attributes\HookFilter;

class contentModifier
{
    #[HookFilter('content.render', priority: 20)]
    public function addSignature($content)
    {
        return $content . "\n\n-- Sent via Laravel Hooks";
    }
}

🧪 Testing

Run the test suite:

composer test

📄 License

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

Made with ❤️ by Ali Harb