PHPackages                             phpnomad/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. phpnomad/config

ActiveLibrary[Utility & Helpers](/categories/utility)

phpnomad/config
===============

1.0.0(1y ago)0141[1 PRs](https://github.com/phpnomad/config/pulls)3MITPHPCI passing

Since Oct 30Pushed 4mo ago2 watchersCompare

[ Source](https://github.com/phpnomad/config)[ Packagist](https://packagist.org/packages/phpnomad/config)[ Docs](https://github.com/phpnomad/core)[ RSS](/packages/phpnomad-config/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (1)Dependencies (1)Versions (6)Used By (3)

phpnomad/config
===============

[](#phpnomadconfig)

[![Latest Version](https://camo.githubusercontent.com/152f5b88ca2c7219278d13d48ce644eacd45bd9229f3e1db47a88d1cfe1ce5c7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7068706e6f6d61642f636f6e6669672e737667)](https://packagist.org/packages/phpnomad/config)[![Total Downloads](https://camo.githubusercontent.com/d3d141e94f2035d168cf2961494365c90203cd89442b7e11422c7d8862396e10/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7068706e6f6d61642f636f6e6669672e737667)](https://packagist.org/packages/phpnomad/config)[![PHP Version](https://camo.githubusercontent.com/0e66f587baba27ed62a6cf5792cf15378b7cb7a4f2196aa69371a690afb78127/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f7068706e6f6d61642f636f6e6669672e737667)](https://packagist.org/packages/phpnomad/config)[![License](https://camo.githubusercontent.com/1733c9bd5b7d9f2ec082df87c644c16a2b421f37974acf8ab9202bb59f612f93/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f7068706e6f6d61642f636f6e6669672e737667)](https://packagist.org/packages/phpnomad/config)

`phpnomad/config` is a strategy-based configuration layer for PHP applications. It splits configuration into two separate concerns, one for how values are stored and looked up and another for how files are read from disk. Both live behind interfaces, so you can change either one without touching the code that consumes configuration values.

The package defines `ConfigStrategy` for storage and lookup, `ConfigFileLoaderStrategy` for file loading, and a `ConfigService` that ties them together. Keys are accessed with dot-notation, so nested structures like `app.mailer.host` work out of a single `get` call. The base package has no runtime dependencies. Concrete file-loading backends live in separate packages.

Installation
------------

[](#installation)

```
composer require phpnomad/config
```

Quick Start
-----------

[](#quick-start)

Once you have a `ConfigStrategy` implementation, register a namespace of config data and read values back with dot-notation keys.

```
use PHPNomad\Config\Interfaces\ConfigStrategy;

/** @var ConfigStrategy $config */
$config->register('app', [
    'debug'  => false,
    'locale' => 'en_US',
    'mailer' => [
        'host' => 'smtp.example.com',
        'port' => 587,
    ],
]);

$config->get('app.debug');              // false
$config->get('app.mailer.host');        // 'smtp.example.com'
$config->get('app.mailer.timeout', 30); // 30 (default fallback)
$config->has('app.mailer.host');        // true
```

`ConfigStrategy` is an interface. Pair it with a concrete implementation like [`phpnomad/json-config-integration`](https://packagist.org/packages/phpnomad/json-config-integration) for JSON files, or [`phpnomad/array-json-config`](https://packagist.org/packages/phpnomad/array-json-config) for a basic arrays and JSON setup. You can also implement `ConfigStrategy` directly against any storage backend you need.

Key Concepts
------------

[](#key-concepts)

- `ConfigStrategy` registers a top-level key with an array of config data and reads single values with dot-notation lookups. `get()` accepts a default for missing keys. `has()` reports whether a key resolves to a value.
- `ConfigFileLoaderStrategy` turns a file path into an array of configuration data. This keeps file-format decisions (JSON, PHP, YAML, or anything else) separate from how the data is stored.
- `ConfigService` takes a `ConfigStrategy` and a `ConfigFileLoaderStrategy` in its constructor. Call `registerConfig($key, $path)` to load a file through the loader and register its contents under a namespace in the strategy.
- `ConfigException` is raised when loading or registering configuration fails, so consumers have a single exception type to catch around config setup.

Documentation
-------------

[](#documentation)

Full documentation, including the interface contracts and guidance on writing your own strategies, lives at [phpnomad.com](https://phpnomad.com).

License
-------

[](#license)

MIT. See [LICENSE.txt](LICENSE.txt).

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance59

Moderate activity, may be stable

Popularity13

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 93.3% 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

Unknown

Total

1

Last Release

607d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9e6206223bd6f2a57b8ac80605b1b5c3521faaec18ad3f20f25fb728a9a13784?d=identicon)[tstandiford](/maintainers/tstandiford)

---

Top Contributors

[![alexstandiford](https://avatars.githubusercontent.com/u/8210827?v=4)](https://github.com/alexstandiford "alexstandiford (14 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")

---

Tags

configconfigurationframeworkphpphpnomadplatform-agnostic

### Embed Badge

![Health badge](/badges/phpnomad-config/health.svg)

```
[![Health](https://phpackages.com/badges/phpnomad-config/health.svg)](https://phpackages.com/packages/phpnomad-config)
```

###  Alternatives

[php-soap/wsdl

Deals with WSDLs

184.1M19](/packages/php-soap-wsdl)[overtrue/laravel-qcloud-content-audit

腾讯云内容安全（文字图片内容审核）服务

468.3k](/packages/overtrue-laravel-qcloud-content-audit)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)