New

Just launched: Vueblocks, a brand-new search engine for Vue packages! Explore Vueblocks →

microweber-packages/microweber-config-merge

Package-priority config merging for Laravel – lets package/module config values override application defaults instead of the other way around.
1,543
Install
composer require microweber-packages/microweber-config-merge
Latest Version:v1.0.0
PHP:^8.2
Laravel:10 – 13
License:MIT
Last Updated:Nov 10, 2026
Links: GitHub  ·  Packagist
Maintainer: boksiora

microweber-packages/microweber-config-merge

Package-priority config merging for Laravel service providers.

Problem

Laravel's built-in ServiceProvider::mergeConfigFrom() gives the application config priority over package defaults. This means a package cannot ship opinionated defaults that override what the app already has.

This package inverts that behaviour: the package/module config values take priority, letting CMS modules and packages ship defaults that "win" unless the system explicitly overrides them at a deeper level.

Installation

composer require microweber-packages/microweber-config-merge

Usage

use Illuminate\Support\ServiceProvider;
use MicroweberPackages\ConfigMerge\MergesConfigFromPackage;

class MyServiceProvider extends ServiceProvider
{
    use MergesConfigFromPackage;

    public function register()
    {
        // Package config values override application defaults
        $this->mergeConfigFrom(__DIR__.'/../config/my-package.php', 'my-package');
    }
}

How it works

  • Scalar values: Package value wins over the application value.
  • Associative arrays: Recursively merged; package values win at each level.
  • Numeric arrays and special keys (middleware, register): Concatenated via array_merge to preserve list-append semantics.
  • Cached configuration: Skipped entirely (respects CachesConfiguration).

License

MIT

Authors

Part of Microweber, built by:

  • Peter Ivanov
  • Bozhidar Slaveykov

Related Packages

doctrine/dbal

Powerful PHP database abstraction layer (DBAL) with many features for database s...

660,512,042 9,702
laravel/framework

The Laravel Framework.

617,629,957 34,997
laravel/tinker

Powerful REPL for the Laravel framework.

524,145,802 7,444
laravel/serializable-closure

Laravel Serializable Closure provides an easy and secure way to serialize closur...

442,489,569 607
nunomaduro/collision

Cli error handling for console/command-line PHP applications.

418,503,470 4,663

Version History

Version Released PHP Laravel License
v1.0.0 ^8.2 ^10.0||^11.0||^12.0||^13.0 MIT