PHPackages centamiv/laravel-collection-mutators - 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. centamiv/laravel-collection-mutators ActiveLibrary[Utility & Helpers](/categories/utility) centamiv/laravel-collection-mutators ==================================== Advanced mutators (updateWhere, deleteWhere, etc.) for Laravel Collections and Arr. 10PHP Since Mar 18Pushed 3mo ago1 watchersCompare [ Source](https://github.com/centamiv/laravel-collection-mutators)[ Packagist](https://packagist.org/packages/centamiv/laravel-collection-mutators)[ RSS](/packages/centamiv-laravel-collection-mutators/feed)WikiDiscussions main Synced 3w ago READMEChangelogDependenciesVersions (1)Used By (0) Laravel Collection Mutators =========================== [](#laravel-collection-mutators) Laravel Collection Mutators is a lightweight package that extends Laravel's **Collections**, **LazyCollections**, and the **Arr** helper with powerful, immutable mutation methods. It allows you to perform common data manipulation tasks—like updating, deleting, or upserting items based on specific conditions—using a clean, fluent API. By following an immutable approach, the package ensures that your original data remains untouched, returning a fresh instance with the modifications applied. Functions --------- [](#functions) The following methods are added to `Collection`, `LazyCollection`, and `Arr`: - **`updateWhere(array $where, array $update)`**: Updates items that match the given conditions. - **`deleteWhere(array $where)`**: Removes items that match the given conditions. - **`upsertWhere(array $where, array $values)`**: Updates matching items or appends a new item if no match is found. - **`toggleWhere(array $where, string $booleanField)`**: Inverts a boolean field for all matching items. - **`insertAfterKey($targetKey, $value, $newKey = null)`**: Inserts an element after a specific key. - **`insertBeforeKey($targetKey, $value, $newKey = null)`**: Inserts an element before a specific key. Requirements ------------ [](#requirements) - PHP 8.2+ - Laravel Support 11, 12, or 13 Installation ------------ [](#installation) Install the package with Composer: ``` composer require centamiv/laravel-collection-mutators ``` Laravel package discovery will register the service providers automatically. If you have disabled package discovery, register these providers manually: ``` Centamiv\CollectionMutators\ArrMutatorsServiceProvider::class, Centamiv\CollectionMutators\CollectionMutatorsServiceProvider::class, Centamiv\CollectionMutators\LazyCollectionMutatorsServiceProvider::class, ``` Usage ----- [](#usage) ### `updateWhere()` [](#updatewhere) Update all items that match the given conditions and return the updated data. **Collection:** ``` $users = collect([ ['id' => 1, 'name' => 'Taylor', 'active' => false], ['id' => 2, 'name' => 'Abigail', 'active' => true], ]); $updated = $users->updateWhere( ['id' => 1], ['active' => true, 'name' => 'Otwell'] ); ``` **Array:** ``` use Illuminate\Support\Arr; $users = [ ['id' => 1, 'name' => 'Taylor', 'active' => false], ]; $updated = Arr::updateWhere($users, ['id' => 1], ['name' => 'Otwell']); ``` --- ### `deleteWhere()` [](#deletewhere) Remove all items that match the given conditions. **Collection:** ``` $users = collect([ ['id' => 1, 'name' => 'Taylor'], ['id' => 2, 'name' => 'Abigail'], ]); $filtered = $users->deleteWhere(['id' => 1]); ``` **Array:** ``` $users = [ ['id' => 1, 'name' => 'Taylor'], ['id' => 2, 'name' => 'Abigail'], ]; $filtered = Arr::deleteWhere($users, ['id' => 1]); ``` --- ### `upsertWhere()` [](#upsertwhere) Update matching items if they exist, otherwise insert a new item. **Collection:** ``` $users = collect([ ['id' => 1, 'name' => 'Taylor'], ]); // Updates Taylor to Otwell $users->upsertWhere(['id' => 1], ['name' => 'Otwell']); // Inserts Abigail because id 2 doesn't exist $users->upsertWhere(['id' => 2], ['name' => 'Abigail']); ``` **Array:** ``` $users = [['id' => 1, 'name' => 'Taylor']]; $result = Arr::upsertWhere($users, ['id' => 2], ['name' => 'Abigail']); ``` --- ### `toggleWhere()` [](#togglewhere) Invert a boolean field for all matching items. **Collection:** ``` $users = collect([ ['id' => 1, 'active' => false], ]); $users->toggleWhere(['id' => 1], 'active'); ``` **Array:** ``` $users = [['id' => 1, 'active' => false]]; $result = Arr::toggleWhere($users, ['id' => 1], 'active'); ``` --- ### `insertAfterKey()` / `insertBeforeKey()` [](#insertafterkey--insertbeforekey) Insert an element into an associative array or collection at a specific position. **Collection:** ``` $data = collect([ 'first' => 1, 'third' => 3, ]); $data->insertAfterKey('first', 2, 'second'); // ['first' => 1, 'second' => 2, 'third' => 3] ``` **Array:** ``` $data = ['first' => 1, 'third' => 3]; $result = Arr::insertAfterKey($data, 'first', 2, 'second'); ``` --- ### Advanced Features [](#advanced-features) #### Multiple conditions [](#multiple-conditions) All conditions in the `where` array must match. ``` $result = $users->updateWhere( ['role' => 'developer', 'active' => true], ['role' => 'manager'] ); ``` #### Dot notation for nested data [](#dot-notation-for-nested-data) You can match and update nested values using dot notation. ``` $items = collect([ ['id' => 1, 'settings' => ['theme' => 'light']], ]); $updated = $items->updateWhere( ['id' => 1], ['settings.theme' => 'dark'] ); ``` #### Object items are cloned [](#object-items-are-cloned) When a matching item is an object, the package clones it before applying updates to ensure immutability. ``` $user = (object) ['id' => 1, 'name' => 'Taylor']; $updated = collect([$user])->updateWhere(['id' => 1], ['name' => 'Otwell']); $user->name; // Taylor (unchanged) $updated->first()->name; // Otwell ``` #### LazyCollection support [](#lazycollection-support) The lazy version keeps the pipeline lazy and returns a new `LazyCollection`. ``` use Illuminate\Support\LazyCollection; $updated = $lazyUsers->updateWhere(['id' => 1], ['active' => true]); ``` Testing ------- [](#testing) Run the test suite with: ``` ./vendor/bin/phpunit ``` License ------- [](#license) Released under the [MIT license](LICENSE). ### Health Score 19 — LowBetter than 9% of packages Maintenance54 Moderate activity, may be stable Popularity2 Limited adoption so far Community7 Small or concentrated contributor base Maturity12 Early-stage or recently created project Bus Factor1 Top contributor holds 100% 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. ### Community Maintainers ![](https://avatars.githubusercontent.com/u/4162703?v=4)[Ivan Centamori](/maintainers/centamiv)[@centamiv](https://github.com/centamiv) --- Top Contributors [![centamiv](https://avatars.githubusercontent.com/u/4162703?v=4)](https://github.com/centamiv "centamiv (2 commits)") ### Embed Badge ![Health badge](/badges/centamiv-laravel-collection-mutators/health.svg) ``` [![Health](https://phpackages.com/badges/centamiv-laravel-collection-mutators/health.svg)](https://phpackages.com/packages/centamiv-laravel-collection-mutators) ``` ### Alternatives [vormkracht10/laravel-seo-scanner The Laravel tool to boost the SEO score of your web pages. 26720.1k2](/packages/vormkracht10-laravel-seo-scanner) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)