PHPackages dominservice/laravel-config - 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. dominservice/laravel-config ActiveLibrary[Utility & Helpers](/categories/utility) dominservice/laravel-config =========================== Merge default config with dynamic settings, and optimize. 2.3.0(1mo ago)1841MITPHPPHP ^8.1CI passing Since May 9Pushed 1mo ago1 watchersCompare [ Source](https://github.com/dominservice/laravel-config)[ Packagist](https://packagist.org/packages/dominservice/laravel-config)[ Docs](https://github.com/dominservice/laravel-config)[ RSS](/packages/dominservice-laravel-config/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (4)Versions (26)Used By (1) Laravel Config Optimize ======================= [](#laravel-config-optimize) ![Packagist](https://camo.githubusercontent.com/3d2cf87cf6492687e89ecfac9111cb8e7b6e2ce7c38bc4a5e7eb2d5a7cf4fd2a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f646f6d696e736572766963652f6c61726176656c2d636f6e6669672e737667)[![Latest Version](https://camo.githubusercontent.com/be79e87be2506df1a98d0ba7e027b100e6e3d843fbe200556bd8eb52dd5496a1/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f646f6d696e736572766963652f6c61726176656c2d636f6e6669672e7376673f7374796c653d666c61742d737175617265)](https://github.com/dominservice/laravel-config/releases)[![Total Downloads](https://camo.githubusercontent.com/e0d5162cb737e794765568f7e696a73eaeef76ee69147f9c2ffadd69904b2fe9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f646f6d696e736572766963652f6c61726176656c2d636f6e6669672e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/dominservice/laravel-config)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE) Merge default config with dynamic DB settings, include custom config files, and cache the result. Laravel 10-13 on PHP 8.1+. Features -------- [](#features) - DB-backed config overrides without changing your config file structure. - Config cache builder that merges defaults + custom files + DB settings. - Custom config file paths via `config/optimize.php` (module-like layouts). - `optimize_config()` helper for `.env` replacement and `${VAR}` interpolation. - Auto-generate `optimize_config.php` from `.env` on `vendor:publish`. - CLI command and middleware for on-demand config caching. - Route cache integration (command always, middleware in production). Installation ------------ [](#installation) ``` composer require dominservice/laravel-config ``` Current compatibility targets: - Laravel 10 on PHP 8.1+ - Laravel 11 on PHP 8.2+ - Laravel 12 on PHP 8.2+ - Laravel 13 on PHP 8.3+ Laravel package discovery is enabled. Manual registration is only needed if you disabled discovery: ``` 'providers' => [ // ... Dominservice\LaravelConfig\ServiceProvider::class, ], ``` Publish assets (config + migration): ``` php artisan vendor:publish --provider="Dominservice\\LaravelConfig\\ServiceProvider" --tag=optimize-config php artisan vendor:publish --provider="Dominservice\\LaravelConfig\\ServiceProvider" --tag=optimize-migrations ``` Run migrations: ``` php artisan migrate ``` Usage ----- [](#usage) From shell: ``` php artisan dso:optimize-config ``` From PHP: ``` use Dominservice\LaravelConfig\Config; (new Config())->buildCache(); ``` ### Database-backed config values [](#database-backed-config-values) The `settings` table stores only the values that differ from defaults. Types are auto-cast based on the default config value. If a value equals the default, the DB record is removed. ``` use Dominservice\LaravelConfig\Config; (new Config())->set('app.name', 'My App', true); (new Config())->set([ 'app.debug' => false, 'app.timezone' => 'UTC', ], true); (new Config())->set([ ['app.locale', 'en'], ['app.faker_locale', 'en_US'], ], true); ``` ### Middleware (build cache on first request) [](#middleware-build-cache-on-first-request) ``` // app/Http/Kernel.php protected $middlewareGroups = [ 'web' => [ // ... Dominservice\LaravelConfig\Http\Middleware\Optimize::class, ], ]; ``` The middleware runs only for GET requests, skips JSON and Livewire requests, and redirects once after building the cache. In production it also runs `route:cache`. Custom config files ------------------- [](#custom-config-files) Use `config/optimize.php` to merge non-standard config files (for module systems, etc). Each key becomes the config namespace; values can be a string path or an array of paths. ``` // config/optimize.php return [ 'custom_files_config' => [ 'module' => 'modules/module/config/module.php', 'payments' => [ 'modules/payments/config/gateways.php', 'modules/payments/config/rules.php', ], ], ]; ``` The package merges these arrays recursively using `Arr::recursiveMerge`. optimize\_config helper (replace env()) --------------------------------------- [](#optimize_config-helper-replace-env) `optimize_config()` reads from `optimize_config.php` in the project root and falls back to `Env::get`. It supports `${VAR}` interpolation inside values. Example in `config/app.php`: ``` 'env' => optimize_config('APP_ENV', 'production'), ``` ### Auto-generate optimize\_config.php [](#auto-generate-optimize_configphp) When you run `vendor:publish`, the service provider will: - Create `optimize_config.php` if it does not exist and `.env` exists. - Copy `.env` to `.env.backup`. - Remove the original `.env`. Review this behavior before running `vendor:publish` in production. --- Support ------- [](#support) ### Support this project (Ko-fi) [](#support-this-project-ko-fi) If this package saves you time, consider buying me a coffee: - thank you! --- License ------- [](#license) MIT (c) Dominservice ### Health Score 45 — FairBetter than 93% of packages Maintenance90 Actively maintained with recent releases Popularity11 Limited adoption so far Community9 Small or concentrated contributor base Maturity59 Maturing project, gaining track record 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. ### Release Activity Cadence Every ~29 days Recently: every ~73 days Total 25 Last Release 46d ago Major Versions 1.2.1 → 2.0.02025-02-24 ### Community Maintainers ![](https://www.gravatar.com/avatar/9d67c041316385020aafb7eef9f11971d6fad80a11a44f4078273bda6890722d?d=identicon)[dominservice](/maintainers/dominservice) --- Top Contributors [![dominservice](https://avatars.githubusercontent.com/u/13433147?v=4)](https://github.com/dominservice "dominservice (6 commits)") --- Tags laravelconfig ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/dominservice-laravel-config/health.svg) ``` [![Health](https://phpackages.com/badges/dominservice-laravel-config/health.svg)](https://phpackages.com/packages/dominservice-laravel-config) ``` ### Alternatives [akaunting/laravel-setting Persistent settings package for Laravel 495805.1k7](/packages/akaunting-laravel-setting)[livewire/volt An elegantly crafted functional API for Laravel Livewire. 4195.3M84](/packages/livewire-volt)[bpocallaghan/generators Custom Laravel File Generators with config and publishable stubs. 11965.8k3](/packages/bpocallaghan-generators) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)