PHPackages akaunting/laravel-mutable-observer - 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. [Utility & Helpers](/categories/utility) 4. / 5. akaunting/laravel-mutable-observer ActiveLibrary[Utility & Helpers](/categories/utility) akaunting/laravel-mutable-observer ================================== Mutable observer package for Laravel 3.0.0(5mo ago)11173.5k↓15.7%6MITPHPPHP ^8.0|^8.1|^8.2|^8.3|^8.4CI passing Since Feb 23Pushed 5mo ago4 watchersCompare [ Source](https://github.com/akaunting/laravel-mutable-observer)[ Packagist](https://packagist.org/packages/akaunting/laravel-mutable-observer)[ RSS](/packages/akaunting-laravel-mutable-observer/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (4)Dependencies (7)Versions (5)Used By (0) Mutable Observer Package for Laravel ==================================== [](#mutable-observer-package-for-laravel) [![Latest Version on Packagist](https://camo.githubusercontent.com/677182ef8d5ebb014806e58a21955ee2d1b160a6d4305e8e8ab9fa9ba4e74407/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f616b61756e74696e672f6c61726176656c2d6d757461626c652d6f627365727665722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/akaunting/laravel-mutable-observer)[![Total Downloads](https://camo.githubusercontent.com/0dda2795628c1662e793b727a22436168e9f5ebf80a2e8f956ade9720f893764/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f616b61756e74696e672f6c61726176656c2d6d757461626c652d6f627365727665722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/akaunting/laravel-mutable-observer)[![Tests](https://camo.githubusercontent.com/2aaf3f45ff2b28156f98185c6ef91a7797c383dc820478944a1a2c06e02ee7a4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f616b61756e74696e672f6c61726176656c2d6d757461626c652d6f627365727665722f74657374732e796d6c3f6272616e63683d6d6173746572266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/akaunting/laravel-mutable-observer/actions/workflows/tests.yml)[![Code Quality](https://camo.githubusercontent.com/70ba7c461b79fcfa219d58fbf3f9848a972172f0b361e58c45687495cf5ef2bd/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f616b61756e74696e672f6c61726176656c2d6d757461626c652d6f627365727665722f74657374732e796d6c3f6272616e63683d6d6173746572266c6162656c3d636f64652532307175616c697479267374796c653d666c61742d737175617265)](https://github.com/akaunting/laravel-mutable-observer/actions/workflows/tests.yml)[![codecov](https://camo.githubusercontent.com/b84443fd691135d21a47fc90f237e213481bdd63bdc3bc0ed016ff7412950e29/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636f762f632f6769746875622f616b61756e74696e672f6c61726176656c2d6d757461626c652d6f627365727665723f7374796c653d666c61742d737175617265)](https://codecov.io/gh/akaunting/laravel-mutable-observer)[![StyleCI](https://camo.githubusercontent.com/e50562b0cf69370fbef6e7ebd5f1ed8a835f2ba462037b5a9cd8674d552a4436/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3436323439323030312f736869656c643f7374796c653d666c61742d737175617265)](https://styleci.io/repos/462492001)[![PHPStan Level](https://camo.githubusercontent.com/cfad767368c5b88c30d3a7087a14099cb45895b5ded11e2ae54aa298b7ba5893/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d6c6576656c2532306d61782d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](phpstan.neon)[![Psalm Type Coverage](https://camo.githubusercontent.com/7b67ac09c8306474eeab47c8e19d92fc2fb240b2a2e1fecaca33d863d5fd6607/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5073616c6d2d6c6576656c253230312d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](psalm.xml)[![License](https://camo.githubusercontent.com/6e93e2de34b9090833b303a00e7a66ade1f2b952490a3c9972be366eff2261d4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f616b61756e74696e672f6c61726176656c2d6d757461626c652d6f627365727665723f7374796c653d666c61742d737175617265)](LICENSE.md) This package allows you to `mute` and `unmute` specific observer events at will. It ships with a trait that adds mutable methods to your observer classes, making it perfect for testing scenarios and preventing unwanted side effects. Features -------- [](#features) - ✅ **Mute specific events** - Target individual observer methods - ✅ **Mute all events** - Silence entire observers with a single call - ✅ **Framework integration** - Seamlessly works with Laravel's observer system - ✅ **Laravel 9-12 support** - Compatible with all modern Laravel versions - ✅ **PHP 8.0-8.4 support** - Uses modern PHP features like readonly properties - ✅ **Type-safe** - Full type declarations for better IDE support - ✅ **Zero dependencies** - Only requires Laravel framework - ✅ **Well tested** - Comprehensive test coverage Installation ------------ [](#installation) Run the following command: ``` composer require akaunting/laravel-mutable-observer ``` Usage ----- [](#usage) ### Basic Setup [](#basic-setup) Add the `Mutable` trait to your observer class: ``` namespace App\Observers; use Akaunting\MutableObserver\Traits\Mutable; class UserObserver { use Mutable; public function creating($user) { // Send welcome email Mail::to($user->email)->send(new WelcomeEmail($user)); } public function created($user) { // Log user creation Log::info("User created: {$user->email}"); } public function updating($user) { // Validate changes // ... } } ``` ### Muting All Events [](#muting-all-events) Perfect for testing scenarios where you want to disable all observer actions: ``` UserObserver::mute(); // Create users without triggering any observer events $user = User::create([ 'name' => 'John Doe', 'email' => 'john@example.com', ]); // No emails sent, no logs created UserObserver::unmute(); ``` ### Muting Specific Events [](#muting-specific-events) Target individual observer methods while keeping others active: ``` // Mute only the creating event (no welcome emails) UserObserver::mute('creating'); $user = User::create(['name' => 'Jane Doe']); // Creating event is muted, but created event still fires ``` ### Muting Multiple Events [](#muting-multiple-events) ``` // Mute multiple specific events UserObserver::mute(['creating', 'updating']); $user = User::create(['name' => 'Test User']); $user->update(['name' => 'Updated Name']); // Both creating and updating events are muted UserObserver::unmute(); ``` ### Real-World Examples [](#real-world-examples) #### Testing Scenario [](#testing-scenario) ``` use Tests\TestCase; class UserTest extends TestCase { public function test_user_can_be_created_without_side_effects() { // Prevent emails and logs during testing UserObserver::mute(); $user = User::factory()->create(); $this->assertDatabaseHas('users', [ 'email' => $user->email, ]); UserObserver::unmute(); } public function test_only_email_is_muted() { // Mute only email sending, keep logging UserObserver::mute('creating'); Log::shouldReceive('info')->once(); $user = User::factory()->create(); // Email not sent, but log was created UserObserver::unmute(); } } ``` #### Bulk Operations [](#bulk-operations) ``` // Disable observer for bulk operations UserObserver::mute(); User::insert([ ['name' => 'User 1', 'email' => 'user1@example.com'], ['name' => 'User 2', 'email' => 'user2@example.com'], ['name' => 'User 3', 'email' => 'user3@example.com'], ]); // No observers triggered, much faster UserObserver::unmute(); ``` #### Conditional Muting [](#conditional-muting) ``` use Illuminate\Support\Facades\App; // Mute observers in specific environments if (App::environment('testing')) { UserObserver::mute(); } // Or use it for specific operations $shouldNotify = false; if (!$shouldNotify) { UserObserver::mute('creating'); } $user = User::create($data); if (!$shouldNotify) { UserObserver::unmute(); } ``` #### Using Constants [](#using-constants) ``` use Akaunting\MutableObserver\Traits\Mutable; // Use the built-in wildcard constant UserObserver::mute(Mutable::WILDCARD_EVENT); // Same as mute() ``` API Reference ------------- [](#api-reference) ### `Mutable::mute($events = null)` [](#mutablemuteevents--null) Mutes the specified observer events. **Parameters:** - `$events` (string|array|null) - The events to mute. Pass `null` or no arguments to mute all events. **Returns:** void **Examples:** ``` UserObserver::mute(); // Mute all events UserObserver::mute('created'); // Mute single event UserObserver::mute(['created', 'updated']); // Mute multiple events ``` ### `Mutable::unmute()` [](#mutableunmute) Unmutes all previously muted observer events. **Returns:** void **Example:** ``` UserObserver::unmute(); // Restore all observer functionality ``` ### `Mutable::WILDCARD_EVENT` [](#mutablewildcard_event) A constant representing the wildcard event that mutes all observer methods. **Value:** `'*'` Requirements ------------ [](#requirements) - PHP 8.0 or higher - Laravel 9.0 or higher Code Quality ------------ [](#code-quality) This package maintains the highest code quality standards: - ✅ **PHPStan Level Max** - Maximum static analysis level - ✅ **Psalm Level 1** - Strictest type checking - ✅ **PHP CS Fixer** - PSR-12 compliant code style - ✅ **Infection** - Mutation testing with 90%+ MSI - ✅ **100% Test Coverage** - Comprehensive test suite - ✅ **Strict Types** - All files use `declare(strict_types=1)` ### Running Quality Checks [](#running-quality-checks) ``` # Run all quality checks composer quality # Individual checks composer test # Run tests composer test:coverage # Run tests with coverage report composer analyse # Run PHPStan + Psalm composer phpstan # Run PHPStan only composer psalm # Run Psalm only composer format # Fix code style issues composer format:check # Check code style without fixing composer infection # Run mutation testing # Using Makefile (Unix/Mac/WSL) make quality # Run all quality checks make test # Run tests make analyse # Run static analysis make format # Fix code style make help # Show all available commands ``` How It Works ------------ [](#how-it-works) The package uses a proxy pattern to intercept calls to your observer methods. When you call `mute()`, it registers a proxy in Laravel's service container that swallows the specified events. When you call `unmute()`, it removes the proxy and restores normal observer functionality. Best Practices -------------- [](#best-practices) 1. **Always unmute after muting** - Especially in tests, use try-finally blocks: ``` try { UserObserver::mute(); // Your code here } finally { UserObserver::unmute(); } ``` 2. **Use setUp and tearDown in tests**: ``` protected function setUp(): void { parent::setUp(); UserObserver::mute(); } protected function tearDown(): void { UserObserver::unmute(); parent::tearDown(); } ``` 3. **Be specific when possible** - Mute only the events you need to disable: ``` UserObserver::mute('creating'); // Better than mute() ``` 4. **Document muted events** - Add comments explaining why observers are muted: ``` // Mute email notifications during bulk import UserObserver::mute('created'); ``` Troubleshooting --------------- [](#troubleshooting) **Q: Observer still firing after muting?** A: Make sure the observer is registered through Laravel's observer system and the trait is properly imported. **Q: Can I mute observers globally?** A: Yes, mute them in a service provider's `boot()` method or middleware. **Q: Does this work with model events?** A: Yes, it works with any observer registered via `Model::observe()`. Changelog --------- [](#changelog) Please see [Releases](../../releases) for more information what has changed recently. Contributing ------------ [](#contributing) Pull requests are more than welcome. You must follow the PSR coding standards. Security -------- [](#security) Please review [our security policy](https://github.com/akaunting/laravel-sortable/security/policy) on how to report security vulnerabilities. Credits ------- [](#credits) - [Cüneyt Şentürk](https://github.com/cuneytsenturk) - [Denis Duliçi](https://github.com/denisdulici) - [Stephen Lewis](https://github.com/monooso) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [LICENSE](LICENSE.md) for more information. ### Health Score 54 — FairBetter than 97% of packages Maintenance73 Regular maintenance activity Popularity42 Moderate usage in the ecosystem Community16 Small or concentrated contributor base Maturity69 Established project with proven stability Bus Factor1 Top contributor holds 50% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~464 days Total 4 Last Release 154d ago Major Versions 1.0.0 → 2.0.02023-03-07 2.0.1 → 3.0.02025-12-16 PHP version history (3 changes)1.0.0PHP >=8.0 2.0.0PHP ^8.0 3.0.0PHP ^8.0|^8.1|^8.2|^8.3|^8.4 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/5254835?v=4)[Denis Dulici](/maintainers/denisdulici)[@denisdulici](https://github.com/denisdulici) ![](https://avatars.githubusercontent.com/u/10936547?v=4)[Cüneyt Şentürk](/maintainers/cuneytsenturk)[@cuneytsenturk](https://github.com/cuneytsenturk) --- Top Contributors [![denisdulici](https://avatars.githubusercontent.com/u/5254835?v=4)](https://github.com/denisdulici "denisdulici (8 commits)")[![cuneytsenturk](https://avatars.githubusercontent.com/u/10936547?v=4)](https://github.com/cuneytsenturk "cuneytsenturk (5 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)") --- Tags laravelmuteobserverphptraitlaravelobservermutablemuteunmute ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/akaunting-laravel-mutable-observer/health.svg) ``` [![Health](https://phpackages.com/badges/akaunting-laravel-mutable-observer/health.svg)](https://phpackages.com/packages/akaunting-laravel-mutable-observer) ``` ### Alternatives [livewire/volt An elegantly crafted functional API for Laravel Livewire. 4205.3M84](/packages/livewire-volt)[gehrisandro/tailwind-merge-laravel TailwindMerge for Laravel merges multiple Tailwind CSS classes by automatically resolving conflicts between them 341682.2k18](/packages/gehrisandro-tailwind-merge-laravel)[nickurt/laravel-akismet Akismet for Laravel 11.x/12.x/13.x 97139.6k2](/packages/nickurt-laravel-akismet)[whitecube/laravel-timezones Store UTC dates in the database and work with custom timezones in the application. 106106.2k](/packages/whitecube-laravel-timezones)[forxer/laravel-gravatar A library providing easy gravatar integration in a Laravel project. 4235.6k](/packages/forxer-laravel-gravatar)[iteks/laravel-enum A comprehensive Laravel package providing enhanced enum functionalities, including attribute handling, select array conversions, and fluent facade interactions for robust enum management in Laravel applications. 2516.7k](/packages/iteks-laravel-enum) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)