PHPackages ckr/arraymerger - 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. ckr/arraymerger ActiveLibrary[Utility & Helpers](/categories/utility) ckr/arraymerger =============== Provides functionality to merge arrays recursively 3.0.0(4y ago)5604.0k↓30.3%19MITPHPPHP >=7.0 Since Dec 4Pushed 4y ago2 watchersCompare [ Source](https://github.com/ckressibucher/array_merger)[ Packagist](https://packagist.org/packages/ckr/arraymerger)[ RSS](/packages/ckr-arraymerger/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (1)Versions (6)Used By (9) ArrayMerger =========== [](#arraymerger) This is a simple utility to recursively merge php arrays. It's just one class, providing a static method. Alternatively, you can create an instance, configure it, and then call an instance method. Compatibility ------------- [](#compatibility) This library currently works with php-7.0 until php-8.1. If you need support for php-5.5 up to php-7.0, use version *2.0.0*. If you need support for php-5.4, use version *1.0.0*. Basic Usage ----------- [](#basic-usage) ``` // the default array has lower priority $default = array(0 => 'a', 1 => 'b', 'x' => 'z'); // the values of the $precedence array have higher priority than // the values of the $default array $precedence = array(0 => 'a', 'x' => 'y', 'y' => 'y'); // use the static method... $merged = \Ckr\Util\ArrayMerger::doMerge($default, $precedence); // ... or create an object and call the instance method $obj = new \Ckr\Util\ArrayMerger($default, $precedence); $merged = $obj->mergeData(); print_r($merged); /* Array ( [0] => a // from $default [1] => b // from $default [x] => y // from $precedence (overwrite value from $default) [2] => a // from $precedence[0] (values associated to numeric keys get appended by default) [y] => y // from $precedence (new value, associated to string key) ) */ ``` Another simple example with multidimensional input arrays: ``` $default = array('outer' => array('a' => 'a', 'b' => 'b')); $precedence = array('outer' => array('b' => 'x')); $merged = \Ckr\Util\ArrayMerger::doMerge($default, $precedence); print_r($merged); /* Array ( [outer] => Array ( [a] => a // from $default [b] => x // from $precedence, overwriting $default['outer']['b'] ) ) */ ``` Configuration ------------- [](#configuration) There are three flags available to determine the exact behaviour or the merge operation: ``` /** * Given the default array has a scalar value 'v' at key 'k' and * the precedence array has a sub array at the same key 'k'. * * If flag is set, the default scalar value 'v' is wrapped in * an array [0 => 'v'] before the merge is done. * * If the flag is NOT set, then an exception is thrown. * * Default: not set */ const FLAG_ALLOW_SCALAR_TO_ARRAY_CONVERSION = 1; /** * If flag is set, the value of the precedence array for a given key * will overwrite the value of the default array for the same key. * * If flag is NOT set, the value of the precedence array is appended * to the default array. (or skipped, depending on * FLAG_PREVENT_DOUBLE_VALUE_WHEN_APPENDING_NUMERIC_KEYS) * * Default: not set */ const FLAG_OVERWRITE_NUMERIC_KEY = 2; /** * It flag is set, a value of the precedence array for a numeric key is * only appended, if it does not exist yet in the default array. * * If flag is NOT set, the value of the precedence array is appended * to the default array (or overwrites the default array's value with the same key, * depending on FLAG_ALLOW_SCALAR_TO_ARRAY_CONVERSION) * * This flag has the lower priority as FLAG_OVERWRITE_NUMERIC_KEY, i.e. if * FLAG_OVERWRITE_NUMERIC_KEY is set, then it doesn't matter what the value of * FLAG_PREVENT_DOUBLE_VALUE_WHEN_APPENDING_NUMERIC_KEYS is * (the value is added to the default array at the given index, regardless of other values * in the array) * * Note that this flag may slow down the operation on very large (default) arrays. * * Default: not set */ const FLAG_PREVENT_DOUBLE_VALUE_WHEN_APPENDING_NUMERIC_KEYS = 4; ``` Configuration values are applied by flags. You can combine them, before passing to the constructor or static method: ``` $flags = \Ckr\Util\ArrayMerger::FLAG_ALLOW_SCALAR_TO_ARRAY_CONVERSION | \Ckr\Util\ArrayMerger::FLAG_OVERWRITE_NUMERIC_KEY; $merged = \Ckr\Util\ArrayMerger::doMerge($default, $precedence, $flags); ``` If you use an instance of the class, you can dynamically set and unset flags: ``` $default = array(0 => 'a', 1 => 'b', 'x' => 'z'); $precedence = array(0 => 'a', 'x' => 'y', 'y' => 'y'); $obj = new \Ckr\Util\ArrayMerger($default, $precedence); $merged = $obj->allowConversionFromScalarToArray(true) ->overwriteNumericKey(true) ->mergeData(); $merged2 = $obj->overwriteNumericKey(false)->mergeData(); echo count($merged); // 4 echo count($merged2); // 5 ``` For more examples, please see the phpSpec methods. ### Health Score 40 — FairBetter than 88% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity42 Moderate usage in the ecosystem Community22 Small or concentrated contributor base Maturity62 Established project with proven stability Bus Factor2 2 contributors hold 50%+ of commits 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 ~777 days Total 4 Last Release 1486d ago Major Versions 1.0.0 → 2.0.02016-03-10 2.0.0 → 3.0.02022-04-23 PHP version history (3 changes)1.0.0-RC1PHP >=5.4.0 2.0.0PHP >=5.5.0 3.0.0PHP >=7.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/81e52f2fb24def14cbf90069f298696540f5268e48efff17ab0d53df1ac41137?d=identicon)[ckressibucher](/maintainers/ckressibucher) --- Top Contributors [![ckressibucherTIM](https://avatars.githubusercontent.com/u/3985914?v=4)](https://github.com/ckressibucherTIM "ckressibucherTIM (9 commits)")[![ckressibucher](https://avatars.githubusercontent.com/u/3111098?v=4)](https://github.com/ckressibucher "ckressibucher (4 commits)")[![ckrjq](https://avatars.githubusercontent.com/u/38033946?v=4)](https://github.com/ckrjq "ckrjq (4 commits)")[![joachim-n](https://avatars.githubusercontent.com/u/105262?v=4)](https://github.com/joachim-n "joachim-n (3 commits)") ### Embed Badge ![Health badge](/badges/ckr-arraymerger/health.svg) ``` [![Health](https://phpackages.com/badges/ckr-arraymerger/health.svg)](https://phpackages.com/packages/ckr-arraymerger) ``` ### Alternatives [litecms/page Page package for litecms. 1851.8k1](/packages/litecms-page) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)